前言¶
在 DSH 生态里，插件目录已有 2,250+ 候选。面对一堆名字，选哪个才靠谱？npm 的下载量是常用参考，但它噪声很大：版本发布、CI 流量、镜像刷新都会把某一天的数字推高一个数量级。按原始下载量排出来的「第一」，很可能只是「发版本最勤」的那个，并不代表真实使用情况。
dsh-pick 就是解决这个问题的插件选购顾问：说需求 → 找候选 → 多维比较 → 出结论。它不依赖原始下载量，而是基于去噪后的指标来给出首选 / 备选 / 不推荐。
核心功能¶
- 需求搜索：把自然语言需求描述输入，插件会通过同义词和中文二元切分生成搜索词，从目录里筛出候选。
- 去噪指标与健康度：基于 npm 下载历史计算几项指标，并合成一个「健康度」分数。
- 日常基线：扣掉发布日与次日后的每日中位数，最接近真实使用量。
- 近 7 日环比：判断是涨还是凉。
- 版本节奏：平均几天发一个版本，反映维护者的投入度。
- 最近更新：判断是否已弃坑。
- 健康度：以上四项加权计算，基线 40% + 增速 25% + 新鲜度 20% + 节奏 15%。
- 排行榜：支持按不同指标（weekly / baseline / growth / score）对插件或某一分类进行排行。
- 比对与结论：可以选定 2~6 个插件逐项对比，并给出规则版结论。
- 安装前检查：在候选卡片上会提示兼容性、是否声明 dsh.bundle、是否为 TUI 客户端插件、是否与已装插件功能重叠等，装不了的不显示安装按钮。
安装与启用¶
作为 DSH 插件安装（推荐）：
dsh plugin --profile web add dsh-pick
安装完成后重启 dsh web，在右侧栏的引导页点击「选插件」，即可进入完整的选插件面板。设置 → dsh-pick 是精简页，可以查看版本、更新、卸载，以及面板入口和数据口径。
典型用法¶
作为 DSH 插件使用¶
在 DSH 的对话中可以直接问：
- 「我想装一个数据库插件，哪个靠谱？」
- 「帮我对比一下这几个插件：dsh-memory、dsh-prompt、dsh-knowledge」
AI 会自动调用 pick_search、pick_stats、pick_compare、pick_rank 等工具，给出带口径说明的结果，并要求 AI 只引用工具提供的数字，不自己推算。
在右侧栏面板中，点「+AI」可以把候选卡片、结论等整理成一段话发到当前对话，方便在对话里继续讨论。
作为命令行 / 独立网页¶
全局安装后，可以用命令行工具：
npm i -g dsh-pick # 或 npx dsh-pick
启动本地面板：
dsh-pick serve --port 8891
浏览器打开 http://127.0.0.1:8891/ 即可使用。
常用命令：
dsh-pick search "我想装个数据库"
dsh-pick search "任务完成时给我发微信通知"
dsh-pick rank --metric baseline --cat 记忆与上下文 --limit 20
dsh-pick stats dsh-memory dsh-prompt
数据与更新¶
- 覆盖范围：npm 上带
dsh-plugin关键字的约 2,250 个包。 - 数据来源：
registry.npmjs.org（元数据、版本发布历史）与api.npmjs.org/downloads（下载量）。 - 更新频率：每天一次（GitHub Actions，北京时间约 10:30）。
- 数据滞后：npm 统计约滞后 5 天；页面显示的「数据截止」为最后一个已汇总的完整日。
- 去噪范围：周下载 Top 332 会抓取 30 天日序列和发布历史，其余只使用周/月下载量。
- 数据边界：只读公开的 npm API 和本仓库的每日目录，不外传任何数据。
注意事项¶
- 运行要求：Node.js ≥ 20；需要 DSH web profile（右侧栏面板 + 设置页）。
- 插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
- 装之前会检查兼容性、是否声明
dsh.bundle、是否为 TUI 客户端插件、是否与已装插件功能重叠等，装不了的不提供安装按钮。
结语¶
dsh-pick 把「说需求 → 找候选 → 多维比较 → 出结论」这件事做成了标准流程，用去噪后的指标代替原始下载量，让插件选择更客观。如果你在 DSH 生态里经常要选插件，可以把它装上，让 AI 帮你一起做判断。
相关链接¶
- 目录页：https://www.skillhub.cn/plugins/AIcivilization/dsh-pick
- GitHub：https://github.com/AIcivilization/dsh-pick
