前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的扩展方式：社区里大量带 dsh-plugin 主题的 GitHub 仓库构成插件市场，另有独立维护的目录站点汇总这些项目。若只在浏览器里翻 GitHub 或零散收藏链接，很难按分类、星标或更新时间系统挑选插件。下面介绍的 Plugin Discovery（仓库名 dsh-plugin-discovery）由 HiddenPuppy 维护，属于联网工具类插件：在 DSH 侧边栏 Automations 下方增加「插件发现」页，把社区目录全量接进客户端，并为每条目提供中文一句话简介、筛选与排序，每次打开页面还会尝试同步最新目录。

这是什么¶

dsh-plugin-discovery 是 DSH 的第三方 bundle 插件。Host 端拉取并解析社区维护的 GitHub 目录，浏览器端只负责渲染；不直接向 GitHub 发请求。安装后侧边栏会出现 Plugin Discovery，用于浏览经 dsh-plugin 主题校验的仓库列表（README 写明当前约 22,785 个），与上游 bruc3van/awesome-dsh-plugin 的分类体系一致。

核心功能¶

全量目录与分类¶

插件同步社区目录中每个带 dsh-plugin 主题的仓库，并按上游相同的 10 个分类分组展示。筛选条只露出 6 个主分类（head categories），其余归入 Other，避免长尾分类占满界面。

中文简介¶

每个项目尽量显示一句中文说明：优先使用仓库自带中文描述；其次使用本仓库 bundled 的 AI 生成摘要（缓存在 zh-descriptions.json，可编辑后刷新页面覆盖）；新收录且尚无中文时，会按分类与语言自动生成临时一句，英文原描述仍显示在下方。README 注明三类来源的大致数量（仓库中文约 1.1 万、AI 中文约 1.1 万），摘要仅供参考，以各插件仓库为准。

排序、搜索与分页¶

支持三种排序：目录默认顺序、星标最多、最近更新。另有关键词搜索，以及每页 50 / 100 / 200 条。

打开即刷新¶

每次进入页面先用本地缓存即时渲染，再在后台同步最新目录，完成后替换数据。角落 Refresh 可强制同步。页脚展示上游快照日期与上次同步时间。

生态概览¶

页面提供插件总数、分类、语言、近 30 天有更新的项目数、自动生成的中文概览，以及分类分布条。点击行内条目或 Open project ↗ 可跳转到对应 GitHub 仓库。

数据获取方式¶

目录数据来自 awesome-dsh-plugin 的 13 个分卷 Markdown（catalog/*.md，合计约 6 MB），而非体积更大的 repositories.json，便于在 GitHub raw 较慢的网络下使用。Host 优先请求 raw.githubusercontent.com，失败或超时则按文件回退到 jsDelivr 镜像。上游目录约 每日 更新一次；本插件在每次打开页面时尝试同步。

Host 在 DSH 已认证 API 通道注册：

• GET /api/plugin-discovery/feed — 规范化后的目录；?refresh=1 触发后台刷新，?wait=1 等待进行中的刷新后再响应
• GET /api/plugin-discovery/meta — 同步状态（上次同步时间、是否刷新中、错误信息）

安装与启用¶

需要 DSH V0.2.1-rc.5 或更新版本。

1. 打开 DSH 侧边栏 Plugins → Add plugin → Install a third-party plugin。
2. 粘贴本插件的 Git 仓库地址：

https://github.com/HiddenPuppy/dsh-plugin-discovery

3. 安装完成后，Plugin Discovery 出现在侧边栏 Automations 下方；若未立即显示，刷新窗口即可。

也可通过 Agent 的 plugin_manager → install_bundle 传入上述 Git URL 或本地绝对路径安装。许可证为 MIT（见仓库 LICENSE）。

典型用法¶

安装并打开侧边栏 Plugin Discovery 后，可按主分类 chip 缩小范围，用搜索框过滤关键词，切换星标或更新时间排序，调整每页条数浏览列表。需要最新目录时点 Refresh，或依赖「每次打开页面」的后台同步。选定插件后通过 Open project ↗ 进入 GitHub 仓库，再按该仓库说明安装目标插件。

维护者提供的本地验证命令（需在克隆后的仓库根目录执行，仅作开发/运维参考）：

node tools/live-test.mjs                     # 一次真实上游同步并打印统计
node tools/route-test.mjs /path/to/catalog   # 使用本地分卷测试路由、缓存与失败回退
node tools/warm-cache.mjs                    # 预热当前 profile 的磁盘缓存

适用场景与注意¶

适合经常在 DSH 里试装社区插件、希望在一个界面里按分类和星标对比项目的开发者。插件以当前 DSH 进程权限运行，会从网络拉取社区目录并写入本地缓存；安装前应阅读 HiddenPuppy/dsh-plugin-discovery 源码与 MIT 许可证，确认符合你的环境与安全策略。社区目录与 DSH 插件市场站点为社区维护，与 DeepSeek / 幻方无官方从属关系，本文也不将其描述为官方应用商店。

结尾¶

dsh-plugin-discovery 把 GitHub 上经 dsh-plugin 主题校验的全量目录搬进 DSH 侧边栏，配合中文简介、主分类筛选、多种排序与打开即刷新，降低在海量插件里找合适扩展的成本。

• 目录页：https://www.skillhub.cn/plugins/HiddenPuppy/dsh-plugin-discovery
• GitHub：https://github.com/HiddenPuppy/dsh-plugin-discovery