前言¶
DeepSeek Harness（DSH）的扩展以 npm 包形式发布，社区目录与 GitHub 能帮你发现插件，但若只记得包名里的一截、或想对照下载量再决定装哪一个，仍要自己在 registry 里翻。下面介绍的 dsh-plugin-search（维护者 yaqiangsun）把检索接到 DSH 的「插件」页，并给模型侧提供同名能力的工具；安装动作始终由你在界面上确认，插件只负责找包与展示元信息。
这是什么¶
dsh-plugin-search 属于 DSH 插件生态中的「联网工具」类：在 npm 公共 registry 上按名字片段搜索 DSH 社区插件，并从「插件」页一键进入内置安装流程（检查 → 进度 → 结果）。它不替代社区目录站点；目录是独立生态入口，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
装上并重启 DSH 后，会有两块能力（资料来源：项目 README）。
「插件」页的「搜索」标签¶
- 输入插件名字片段，向 npm 检索 DSH 相关包。
- 每条结果可看到是否「组合包 · 可安装」、是否「含界面」、是否「已弃用」，以及近一周下载量；悬停可看精确次数与近一个月下载量。
- 点「安装」会打开插件页自带的安装对话框，后续校验与安装由 DSH 内置流程完成。
模型工具 plugin_search¶
- 模型可按名字片段查找插件，返回版本、作者、是否可安装、周/月下载量等信息。
- 安装不由工具执行：只负责检索，装什么仍须用户在「插件」页确认。
检索行为（使用时值得知道的细节）¶
- 名字优先：先做 npm 全文检索，名字命中的排前面；名字未命中时才退到描述/关键词相关结果，并会标注；不会把与查询词无关的高排名结果混进来。
- 完整包名直查：输入合法包名（
name或@scope/name）时，会直接请求registry.npmjs.org/<包名>/latest，排在最前，不受 npm 搜索「整词匹配」限制。 - 可安装判断：读取 npm 元信息，检查是否声明
dsh.bundle.patch；首屏自动校验前 10 条，其余滚动到可见再校验。 - 查询长度：npm 搜索要求查询词长度在 2..64 之间；单字符会提示且不发起搜索（完整包名同样需满足长度）。
npm registry 搜索按整词匹配、不做前缀子串，因此只知道片段时可能搜不到某些包；若已知完整包名，本插件的直查路径可以绕过该限制。详见 README「一个已知的 npm 限制」一节。
安装与启用¶
在 DSH「插件 → 添加插件」中填写包名：
dsh-plugin-search
或在命令行为指定 profile 安装（README 示例为 desktop）：
dsh plugin --profile desktop add dsh-plugin-search
装完后需要重启 DSH（插件 Host 半运行在主机进程）；重启后刷新页面即可看到「搜索」标签页。
当前 npm 包版本为 0.5.0（见 package.json）；许可证 MIT。
典型用法¶
- 打开 DSH「插件」页，切到「搜索」标签，输入记得的包名片段或完整包名，浏览结果中的下载量与「可安装」标记。
- 对目标条目点「安装」，在安装对话框中完成内置流程。
- 在对话中若模型调用
plugin_search，用返回信息缩小候选；确定包名后仍到「插件」页由用户自己安装。
适用场景与注意¶
适合：经常在 npm 上按名字或片段发现 DSH 插件、希望对照周/月下载量再安装、或希望模型能帮忙列候选包名的开发者。
环境与权限：
- 需要在带有「插件」页（依赖
@deepseek-ai/dsh-client-ui-plugin-manager）的 profile 中使用；纯 Host profile 下 Client 半不激活，但plugin_search工具仍可用。 - 插件只访问
registry.npmjs.org与api.npmjs.org（补下载统计时），无第三方中转；无遥测、元信息仅缓存在当前页内存。 - DSH 插件以当前 dsh 进程权限运行；安装前请自行查看源码与许可证，确认可信后再装。
结尾¶
dsh-plugin-search 把 npm 上的 DSH 插件发现接到客户端「搜索」标签与 plugin_search 工具，检索与展示分离于安装确认，适合在「一切皆插件」的 DSH 生态里快速找包。
