NPM 包下载量趋势图 - 按周/月/年展示热门包

数据来源于 npm 官方下载统计 API（api.npmjs.org/downloads），该 API 统计的是通过 npm 注册表（registry）的包下载次数，包括 npm install、CI/CD 构建下载、镜像下载等。数据通常有 1-2 天的延迟。

官方 API 文档：npm registry download counts

可能的原因：

• 包名不存在：请检查拼写，npm 包名区分大小写（实际存储为小写）。
• 新发布的包：刚发布的包可能还没有足够的下载统计数据。
• 私有包：私有作用域包（@scope/private-pkg）的下载数据不会被公开 API 统计。
• 数据延迟：最近 1-2 天的数据可能尚未更新。

npm 下载计数包括：

• ✅ 直接 npm install 命令下载
• ✅ CI/CD 自动化构建下载
• ✅ npm 镜像源（如淘宝镜像 cnpm）的同步下载
• ✅ 依赖解析时的自动下载
• ❌ 不包含浏览器端 CDN 加载（如 unpkg、jsDelivr 的浏览器请求）
• ❌ 不包含 GitHub 等代码托管平台的源码克隆

• 周（Week）：最近 7 天的每日下载数据，适合观察短期波动。
• 月（Month）：最近 约30天的每日下载数据，平衡细节与趋势。
• 年（Year）：最近 约365天的数据（按周聚合为约52个数据点），适合分析长期趋势和增长模式。

年度视图会将每日数据按7天聚合，使图表更清晰易读。

• 框架/库的流行度：如 React、Vue 等生态的兴衰。
• 版本发布：重大版本发布通常会带来下载量峰值。
• 社区事件：技术文章、教程、会议演讲等会推动短期增长。
• 镜像流量：中国等地区的 npm 镜像同步会产生大量下载计数。
• 机器人/自动化：部分下载来自 CI/CD 和自动化脚本。
• 季节性因素：节假日和工作日模式可能影响下载量。

本工具使用线性 Y 轴刻度。当对比的包下载量差异悬殊时（如 react 每天数百万下载 vs 一个小众工具每天几百下载），小众包的曲线会显得很平坦。

建议：将下载量相近的包放在一起对比，或单独查看小众包以获得更清晰的趋势视图。

• 技术选型：评估包的活跃度和社区使用规模。
• 竞品分析：对比同类包的下载趋势和市场占有率变化。
• 技术趋势洞察：发现新兴框架的崛起或旧技术的衰退。
• 投资决策：判断开源项目的健康发展状况。
• 内容创作：为技术文章、报告提供数据支撑。

npm 官方下载统计 API 没有严格的速率限制，但建议合理使用：

• 避免短时间内发起大量并发请求。
• 本工具对已获取的数据进行缓存，切换时间范围或重复添加相同包时不会重复请求。
• 如需批量获取大量包的下载数据，建议使用 npm 的批量 API 端点或自行实现请求节流。