前言¶
DSH 采用「一切皆插件」的架构，社区插件数量在 dsh-plugin 话题下持续增长。开发者找插件时，常见做法是翻 GitHub 搜索结果、扫 awesome 列表或凭 README 里的 star 数判断——这些方式要么覆盖面不全，要么缺少统一维度，也难以在 DSH 里直接查询或安装。
下面介绍维护者 zp-home 的联网工具插件 dsh-recommend。它每 5 小时自动抓取全 GitHub 的 dsh-plugin 话题仓库，按公开评分模型排序，并把同一份数据供给静态排行站、DSH 模型工具与设置页。SkillHub 目录页将其归类为「联网工具」，当前版本 v0.3.0。
这是什么¶
dsh-recommend 是 DSH 插件生态的透明排行与推荐服务，仓库地址为 github.com/zp-home/dsh-recommend。维护者 zp-home 将评分公式、权重与原始数据全部公开在仓库中；任何人 clone 后执行 node scripts/sync.mjs 即可复算榜单。
数据以 data/registry.json 为唯一事实源。GitHub Actions 每 5 小时全量重算并提交 data/ 目录，包括排行、历史快照、徽章与发展榜派生数据。当前管道覆盖 2200+ 个 dsh-plugin 话题仓库，排除占位、空仓库、官方本体及深扫未检出插件特征的条目后，约 1900+ 个上榜。
核心功能¶
公开评分与过滤¶
综合分公式为：0.35×维护性 + 0.30×热度 + 0.20×质量 + 0.15×生态，细节见仓库 docs/scoring.md。排除条目仍保留在 data/registry.json 并附原因（fork、已归档、空仓库、无描述、占位特征、官方本体、深扫未检出插件特征等）。
榜单前 200 名会经 scripts/scan.mjs 深扫，检测 dsh 声明、@deepseek-ai/* 依赖、cordis 配置与 skills 特征；未检出特征的仓库排除出榜并透明标注。官方本体与非插件 denylist 位于 scripts/exclude-list.json。
静态排行站（无需安装）¶
不安装插件也可浏览排行。打开综合榜首页：
https://zp-home.github.io/dsh-recommend/site/
页面支持搜索、分类筛选、四种排序（综合分 / 热度 / 最近更新 / 最新发布）、分页、详情展开与近 N 天综合分走势图，并可一键复制安装命令。
发展排行榜为独立页面，覆盖 star 增长（7/30/90 天）、排名上升、npm 下载量、本周新上榜与精选认证：
https://zp-home.github.io/dsh-recommend/site/rankings.html
原始 JSON 数据同样公开：data/rankings.json（每 5 小时更新）、data/history.json（每日趋势）、data/trends.json（发展榜派生）。
DSH 内的模型工具与设置页¶
安装后在 DSH 中获得五类模型工具：
| 工具 | 用途 |
|---|---|
rank_plugins |
榜单查询，可按分类与维度过滤 |
search_plugins |
插件检索 |
recommend_plugins |
按目标推荐，支持中英同义词与 keywords 参数 |
trend_plugins |
发展榜（star 增长、排名上升、下载量、新上榜、精选） |
sync_registry |
刷新本地数据，报告 hub 与深扫健康度 |
设置页路径为「设置 → 插件 → 插件排行」，提供紧凑排行榜、一键刷新、一键安装、安装命令复制、详情展开、认证徽章与趋势图，支持 zh/en 双语并随 DSH 亮/暗主题适配。
插件还会检查当前 profile 的 Git/NPM 直接依赖版本，默认仅提醒更新；点击「更新」后执行官方 dsh plugin update，完成后需手动重启 DSH。
插件作者相关能力¶
上榜项目每 5 小时自动生成 shields 徽章（data/badges/<owner>__<name>.json），可在 README 中引用。精选认证通过提交 收录/认证 Issue 申请，审核通过后显示 🏅 标识；认证是展示层激励，不改变评分。
安装与启用¶
DSH 插件以当前 dsh 进程权限运行。安装前应阅读仓库源码与 MIT 许可证，自行判断是否适合你的环境。
方式 A：npm 安装（国内用户可优先尝试）¶
dsh plugin --profile web add dsh-recommend
安装完成后重启 dsh web 生效。
方式 B：GitHub 直装¶
dsh plugin --profile web add github:zp-home/dsh-recommend
dsh --profile web --dump-config
dump-config 输出中应出现 # == dsh-recommend 配置层。同样需重启 dsh web。
方式 C：本地目录安装¶
dsh plugin --profile web add /你的路径/dsh-recommend
适用于离线拷贝插件目录的场景。
国内网络提示¶
插件榜单数据默认从 raw.githubusercontent.com 拉取（sync_registry 工具）。若该域名不可达，可编辑已安装包中的 cordis.patch.yml（路径如 node_modules/dsh-recommend/cordis.patch.yml），将 dataUrl 改为 jsDelivr CDN：
https://cdn.jsdelivr.net/gh/zp-home/dsh-recommend@main/data/registry.json
改后重启 DSH。CDN 数据可能有数小时缓存延迟。
典型用法¶
在浏览器里查榜并复制安装命令¶
1、打开 https://zp-home.github.io/dsh-recommend/site/。
2、用搜索或分类筛选定位目标插件。
3、展开详情，复制页面提供的一键安装命令，在终端执行后重启 dsh web。
在对话中让模型查榜或推荐¶
安装并重启后，可在 DSH 对话中直接调用工具，例如查询综合榜、按关键词检索、按场景推荐插件，或查看 star 增长等发展指标。需要刷新本地缓存时，调用 sync_registry。
自行复算数据管道¶
若需审计或本地调试排行逻辑，在 Node 18+ 环境下执行：
node scripts/sync.mjs
node scripts/validate.mjs
node scripts/smoke.mjs
深扫步骤需要 GITHUB_TOKEN；未设置时使用 GitHub API 未认证限额，够跑一轮但会自动跳过深扫。CI 中会自动注入 token。
适用场景与注意¶
适合谁
- 想在 DSH 内快速查榜、检索、按目标推荐插件的开发者。
- 需要对比插件维护性、热度、质量与生态信号，而非只看 star 数的用户。
- 插件作者希望展示透明评分徽章或申请精选认证。
需要注意
- 本插件及 SkillHub 目录均为社区生态，与 DeepSeek / 幻方无官方从属关系，不是官方应用商店。
- 仓库 README 提到静态安全扫描（见 docs/security-scanning.md），未命中规则不等于安全；提示仅供参考，不影响评分或安装资格。
- 插件只读
registry.json并展示，不执行被收录插件的代码；但你安装的dsh-recommend本身仍以 dsh 进程权限运行，安装前请审查源码。 - 设置页排行标签、数据路由与一键安装等功能面向
--profile web；host 侧模型工具可在其他 profile 使用，具体以仓库cordis.patch.yml为准。
结尾¶
dsh-recommend 把 DSH 插件生态的采集、评分、过滤与展示做成一条可审计的自动化管道，并用同一份 registry.json 服务静态站、模型工具与设置页。若你正在扩展 DSH 插件栈，可以先打开排行站浏览，再按需安装到 web profile 使用。
- SkillHub 目录页：skillhub.cn/plugins/zp-home/dsh-recommend
- GitHub 仓库：github.com/zp-home/dsh-recommend
