메뉴
采集头部 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에서 현재 제공할 수 있는 파일을 다운로드하세요.
维护发给 DSH 桌面端插件市场的安装契约（/market/v1/plugins）——探测插件的安装方式与 npm 最新版本、排查某个插件为什么在桌面端市场里装不了或装到旧版本、核对某个包是否满足桌面端 preview 的七项复核。
跑一整轮站点数据刷新并上线：GitHub 同步（新插件/star）→ 头部插件下载量 → 头部插件安装方式 → 静态快照（首页三条 rail、插件库、排名）→ 构建验证 → 只提交生成物 → 推送触发 Cloudflare 部署。用于「好几天没更新了，把数据刷一遍」，也用于排查某一步为什么没生效。
对 DSH 插件生态跑一轮综合评分（0-100 + S/A/B/C）。流程：同步 Turso → 采集证据 → AI 按量表评工程规范 → 合成入库 → 重生成静态数据并推送。用于批量评新插件、按 star 阈值扩大覆盖或定期重评。
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 以下时要重新警惕这件事。