npm热榜数据接口
一次请求返回 DSH 插件的 npm 累计下载前 100 名——全期热门口径，与本周下载榜接口互为姊妹篇。
接口地址
| URL | 说明 | 更新 |
|---|---|---|
/data/npm-popular.json | npm 累计下载前 100 名，每个插件一条，按累计降序。 | 随部署重建 |
/data/npm-popular.schema.json | 本接口数据格式对应的 JSON Schema。 | 稳定 |
JSON 接口支持跨域读取：Access-Control-Allow-Origin: *，无需 API Key 或注册。
响应字段
| 字段 | 类型 | 语义 |
|---|---|---|
generatedAt | string (ISO) | 构建时间戳——缓存副本请一并保留 |
totalsAsOf | string (YYYY-MM-DD) | null | 上榜条目里最新的累计口径截止日；榜单为空时为 null |
scope | object | 收录口径：listableOnly（仅站内列表口径）、ecosystemAppsExcluded（排除生态应用）、packagesWithBaselineOnly（只含采过累计初值的包） |
limit | number | 100——本接口只提供前 100 名 |
count | number | 榜单条目数（≤ limit） |
items[] | array | 榜单条目，按 total 降序（字段见下） |
items[].rank | number | 名次（1–100） |
items[].id | string | 插件 id（与 plugins.json 的 id、详情页 slug 一致） |
items[].name | string | 展示名 |
items[].packageName | string | 下载量统计所用的 npm 包名 |
items[].total | number | 累计下载 = 初值 + 逐日累加；绝不用零散几天的和冒充 |
items[].totalAsOf | string (YYYY-MM-DD) | null | 该累计值的口径截止日（初值日，或已累加到的最后一天） |
items[].week | number | null | 本周（npm last-week 滚动窗口）下载量，作全期累计的对照；无快照覆盖时为 null |
items[].stars | number | GitHub 星数 |
items[].url | string | 插件详情页绝对地址 |
license | object | 出处与引用条款——聚合自公开 npm registry，引用需注明来源 |
覆盖面诚实原则：只有采过累计初值的包才会出现在本接口——从未采过初值的包是缺席，绝不报 0 冒充；下一轮累计采集覆盖到后会自动上榜。热门榜是全期口径，不做「窗口内新入库」排除——新收录条目累计天然小，排不上去。
使用方式
获取下载热门前 100 名（或在浏览器直接打开 /data/npm-popular.json）：
本周动量口径的姊妹接口是 /data/npm-downloads.json。单插件详情（验证等级、安全、安装方式）用 id 关联 /plugins-index.json 或 /plugin/@作者/插件名.json。
榜单随部署重建，数据来自 dsh.so 流水线每日采集的 npm Downloads API 快照与累计累加。字段只增不删：既有字段不会移除或改名。可免费引用，需注明来源 dsh.so；新增字段见 更新日志。