前言¶
DeepSeek Harness（DSH）的插件生态日益丰富，社区维护的目录（awesome-dsh-plugin）提供了大量插件资源。但在本地开发时，直接浏览外部目录效率较低。dsh-plugin-recommend 将这个外部目录嵌入到 DSH 中，提供了一个本地化的插件搜索与推荐引擎。它通过关键词匹配、标签分类以及实时的目录刷新，帮助开发者快速定位所需的工具。
插件概览¶
- 插件名称：dsh-plugin-recommend
- 维护者：863683348
- 分类：联网工具
- 开源协议：MIT
核心功能¶
该插件通过以下方式实现插件发现与检索：
- 嵌入式目录：内置了 1135 条插件条目（来自 awesome-dsh-plugin），包含名称、仓库、分类、描述以及自动生成的标签。
- 全文评分与排序：支持自由文本搜索。匹配优先级为：插件名称 > 标签 > 描述。同时支持通过分类进行过滤，结果会去重并支持多样性筛选，防止某一分类结果过多。
- 实时刷新：插件启动时尝试通过 HTTPS 从 awesome-dsh-plugin 的 README 拉取最新目录。若网络请求失败，则回退使用内置的嵌入式目录。
- 工具校验：插件在加载时会使用
@deepseek-ai/dsh-tools的 value-schema DSL 校验工具的 schema，确保工具定义符合规范。
工具命令与使用¶
插件提供了 5 个核心工具命令，用于检索目录信息：
搜索插件¶
根据需求描述搜索插件，并返回匹配度得分及理由。
recommend search "browser automation with screenshots"
recommend search "网页浏览" category tools
查看分类¶
列出目录中所有分类及其对应的插件数量。
recommend categories
查看详情¶
获取单个插件的完整目录条目。
recommend detail dsh-plugin-gate
查找相似插件¶
根据标签、分类和描述的重叠度，查找与指定插件最相似的替代品。
recommend similar <plugin-name>
刷新目录¶
强制从远程源重新拉取最新目录数据。
recommend refresh
注意事项¶
- Schema 校验：早期版本存在 JSON-Schema 与 DSL 不兼容的问题，可能导致 DSH 无法启动。如果遇到启动失败，请尝试从配置中移除此插件（数据不会丢失），或升级到最新版本。
- 安全检查：在安装推荐插件前，务必使用
dsh-plugin-gate中的gate_scan工具进行安全扫描，交叉检查插件来源后再安装。
