UD5工具箱
NPM
NPM（Node Package Manager）是 Node.js 的官方包管理器，也是全球最大的 JavaScript 软件注册中心。开发者通过 npm 可以发布、分享和安装各种 JavaScript 库与工具。npm 平台上托管了数百万个公开包，覆盖前端框架、后端工具、构建工具、测试框架等各个领域。NPM 提供的官方 API 为外部工具提供了查询包信息和下载量统计数据的接口，本工具正是基于该 API 获取数据。
下载量
下载量是指一个 npm 包在特定时间段内被安装的总次数。每当开发者在终端执行 npm install 命令安装某个包时，NPM 官方服务器就会记录一次下载。需要注意的是，下载量不仅包括开发者手动执行 install 命令的次数，还包括 CI/CD 自动化构建、Docker 镜像构建、package-lock.json 锁定版本的重新安装等场景。因此，下载量是一个综合指标，反映了包在整个开发生态中的实际使用频率。
趋势图
趋势图是一种以时间为横轴、以某一数值指标为纵轴的折线图，用于展示数据随时间的变化走向。在本工具中，X 轴代表时间（周、月或年），Y 轴代表对应时间段内的下载量。通过观察折线的上升、下降、波动和平稳等形态，可以直观理解一个 npm 包的使用热度变化趋势。多条折线叠加在同一图表中，还能实现不同包之间的对比分析。
多包对比
多包对比是指将两个或多个 npm 包的下载量数据同时绘制在同一张图表中，以便直观比较它们的使用量差异和趋势走向。通过多包对比，你可以快速判断哪些包更受欢迎、哪些包增长更快、哪些包正在被社区抛弃。这对于技术选型场景尤其有价值，例如在 React、Vue 和 Angular 之间做决策时，观察三者的下载量趋势可以帮助你了解当前前端框架的市场格局。
周维度
周维度是指将下载量按自然周进行聚合统计。在周维度下，图表中的每个数据点代表一周内的总下载量。周维度数据粒度较细，能够清晰反映短期内的下载量波动，例如某个包在发布新版本后的下载量激增，或者在某个开发者大会期间的关注度提升。适合用于观察短期趋势变化和发布周期对下载量的影响。
月维度
月维度是指将下载量按自然月进行聚合统计。月维度数据过滤掉了周级别的短期波动噪声，更适合观察中长期的趋势走向。通过月维度数据，你可以判断一个 npm 包的增长是否具有持续性，还是仅仅是短期热点。月维度也是开发者社区中讨论包流行度时最常引用的时间粒度。
年维度
年维度是最大粒度的时间聚合方式，每个数据点代表一整年的累计下载量。年维度数据适合宏观层面的分析，例如追踪某个技术方向（如微前端、Server Components）在过去几年的整体发展趋势。由于粒度较粗，年维度数据会抹平所有短期波动，只呈现最核心的长期增长或衰退趋势。
NPM 官方 API
NPM 官方 API（api.npmjs.org）是 NPM 团队提供的公开 RESTful API，允许外部应用查询包的元信息、版本历史、维护者列表和下载量统计等数据。本工具使用的下载量端点为 /downloads/point/{period}/{package}，返回指定时间段内某个包的总下载次数。该 API 是免费公开的，但存在一定的速率限制（Rate Limiting），频繁请求可能会被临时限流。数据来源于 NPM 官方服务器的访问日志，权威性和准确性有保障。