前言¶
在 DSH 里做智能体时，经常要先确认一个能力是否已经有现成的 dsh 插件。这类信息通常分散在 npm、GitHub 仓库和 awesome-dsh-plugin 清单里，需要来回查包名、版本、仓库和作者。
dsh-plugin-search 把“找插件、查元数据、浏览精选清单”放进 DSH agent 内部，减少在智能体工作流外手动查找的成本。
这是什么¶
dsh-plugin-search 是面向 DeepSeek Harness 的插件发现工具，由 zoahdev 维护，许可证为 MIT © 2026 zoahdev。
它在 DSH agent 内提供三类能力：
- 搜索
npm与awesome-dsh-plugin精选清单中的 dsh 插件； - 查询 npm 包元数据，查不到时回退 GitHub 仓库搜索；
- 浏览当前
awesome-dsh-plugin精选清单。
核心功能¶
下面介绍它提供的三个工具。
dsh_search_plugins¶
dsh_search_plugins 用于搜索 dsh 插件。
它会同时搜索 npm 与 awesome-dsh-plugin 精选清单，并以 npm 结果优先、去重，同时带版本与来源标签。
适合这类问题：
- 某个能力是否已有 dsh 插件；
- 哪些插件名称相近，需要区分；
- 某个插件来自 npm，还是来自
awesome-dsh-plugin清单。
dsh_plugin_lookup¶
dsh_plugin_lookup 用于精确查询插件包。
它会查询 npm 元数据，包括：
- 最新版本；
- 描述；
- 主页；
- 仓库；
- 作者。
如果 npm 中查不到，它会回退到 GitHub 仓库搜索。
dsh_awesome_top¶
dsh_awesome_top 用于浏览当前 awesome-dsh-plugin 精选清单。
它可以在 DSH 内快速查看当前精选清单中的插件，了解可选择的 dsh 插件范围。
安装与启用¶
从 GitHub Release 安装 v1.1.0 tarball 到 web profile：
dsh plugin --profile web add https://github.com/zoahdev/dsh-plugin-search/releases/download/v1.1.0/dsh-plugin-search-1.1.0.tgz
如果已经本地构建出 tarball，也可以按 README 给出的方式添加：
dsh plugin --profile web add ./dsh-plugin-search-1.1.0.tgz
package.json 声明的 peerDependencies 如下：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
}
也就是说，使用时环境需要提供 @deepseek-ai/cordis ^4.0.1 和 @deepseek-ai/dsh-tools ^0.1.0-rc.6。
典型用法¶
安装后，可以在 DSH 里直接对 agent 说：
帮我找一个能监控 GitHub release 的 dsh 插件。
也可以使用英文：
Find me a dsh plugin that tracks GitHub releases.
这些示例用于让 agent 在 DSH 内查找相关 dsh 插件，而不是手动离开 DSH 去 npm 或 GitHub 搜索。
适用场景与注意¶
适合以下场景：
- 在 DSH 内判断某个能力是否已有现成 dsh 插件；
- 查看某个 dsh 插件的 npm 元数据；
- npm 中查不到时，继续查看 GitHub 仓库；
- 浏览当前
awesome-dsh-plugin精选清单。
注意：
- 插件以当前 dsh 进程权限运行；
- 安装前应检查源码与许可证；
- 许可证为
MIT © 2026 zoahdev。
dsh-plugin-search 的价值在于把插件发现过程放进 DSH 工作流内：搜索、查询和浏览清单可以在 agent 内部完成。
GitHub 仓库：
https://github.com/zoahdev/dsh-plugin-search
