菜单
采集头部 DSH 插件的累计下载量（npm + npmmirror 镜像 + GitHub Release 三渠道）写入 Turso。用于定期刷新下载数据、按 star 阈值扩大覆盖、排查某个仓库为什么没有下载数，或在做下载量徽章/排序前确认数据口径。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/hikariming/dshfind --skill track-downloads命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | track-downloads |
| description | 采集头部 DSH 插件的累计下载量（npm + npmmirror 镜像 + GitHub Release 三渠道）写入 Turso。用于定期刷新下载数据、按 star 阈值扩大覆盖、排查某个仓库为什么没有下载数，或在做下载量徽章/排序前确认数据口径。 |
一轮采集 = pnpm probe:downloads，把累计下载量分三个渠道写进 Turso plugins 表。
取数规则在 scripts/lib/downloads.mjs（纯函数，有测试），抓取与入库在 scripts/probe-downloads.mjs。
| 字段 | 含义 | 来源 |
|---|---|---|
dl_pkg | 归属校验通过的 npm 包名，没通过就是 NULL | 仓库根 package.json + npm registry |
dl_npm_total | npm 官方生命周期累计 | api.npmjs.org/downloads/point/<区间>/<包> |
dl_mirror_total | npmmirror（淘宝镜像）累计 | registry.npmmirror.com 同路径 |
dl_release_total | 该仓库所有 Release 资产 download_count 合计 | GitHub API |
dl_status | npm / npm+release / release / name-taken / unpublished / none | 推导 |
dl_note | 占名说明，如 name-taken:aegis→killdream/aegis | 推导 |
dl_probed_at | 本轮探测时间，增量与新鲜度都看它 | — |
dl_manual_total | 运营手工填的全渠道总数，优先级最高，探测永不覆盖 | 人工 |
dl_manual_note | 手工数的出处，前台挂进 tooltip | 人工 |
# 官网自建分发这类我们测不到的渠道，用手工数覆盖
node --env-file=.env.local scripts/flag-plugin.mjs owner/repo \
--downloads=200000 --downloads-note="官网统计 20 万"
node --env-file=.env.local scripts/flag-plugin.mjs owner/repo --downloads=auto # 撤回
手工数必须带出处：那是一个我们没有量过的数字，前台会标成「全渠道累计（含官网，运营核实）」
并把出处挂 tooltip，不能让读者以为是我们测的。已用于 anywhere-labs/deepseek-harness-desktop
（官网 20 万，GitHub Release 只有 4 万——只报 4 万等于把人家的量说少了五分之四）。
四条不能忘的规矩：
voyager→wieden-kennedy、aegis→killdream、ruflo→claude-flow）。回链不等于本仓库
一律不采信，事实记进 dl_note。绝不能把陌生人的下载量安在作者头上。maxPointMonths()。踩过一次：按 18 个月一刀切，
所有存在超过一年的包在镜像侧整段失败，PicGo-Core 的 3.1 万镜像下载凭空消失。# 1. 想让 star 门槛准确就先同步（可选，star 变动不大时可跳过）
pnpm sync:db --skip-contributors
# 2. 采集（默认 star≥500、排除蹭热度仓、只探超过 7 天没探的）
pnpm probe:downloads
pnpm probe:downloads --include-offtopic # 蹭热度仓也要数字时补一轮
pnpm probe:downloads --min-stars 200 # 扩大覆盖，每仓约 3-5 个请求
pnpm probe:downloads --all # 无视新鲜度全部重探（改了取数规则后跑）
pnpm probe:downloads --only owner/repo --dry-run # 排查单个仓库，不写库
# 3. 规则改动后先跑测试
pnpm test
前台目前尚未接入这几列（下载量徽章待做）。做展示时直接读 plugins.dl_*，
不需要新表；静态数据侧要露出的话在 scripts/gen-plugins-real.mjs 里补字段。
name-taken 名单：这是运营线索。作者要么该改包名，要么该在 README 澄清，
高星仓（ruflo ★68.8k、voyager ★19.8k）值得单独找作者。--only <仓库> --dry-run 复现再判断。none 的比例：纯 skills/prompt 仓、索引站、没有 Release 的 GUI 项目天然拿不到数字，
不是 bug。star≥500 里有 21 个属于这种。| 状态 | 数量 | 说明 |
|---|---|---|
npm / npm+release | 16 | 可比性最好，镜像普遍占 npm 的 35%~50% |
release | 36 | 只有安装包下载数，含桌面端与非插件类大仓 |
name-taken | 2 | 另有 6 个占名仓因为有 Release 数据被记成 release，看 dl_note |
unpublished | 6 | 有 package.json 但没发 npm |
none | 21 | 三个渠道都没有 |
npm 渠道头部（npm+镜像）：dshmarket 26.1 万、DSH-better-sidebar 18.1 万、modlens 16.0 万、 dsh-vision-router 5.4 万、dsh-TUI 4.5 万、dsh-vision-toolkit 4.1 万。
star≥500 天然避开了低星包的刷量问题——探周下载时发现过 dsh-vault（★3、4 天发 142 个版本、
周下载 8,142）这类发版循环造出来的数字。门槛降到 200 以下时要重新警惕这件事。
