前言¶
DeepSeek Harness（简称 dsh）是 DeepSeek 开源的智能体运行时，核心理念是「一切皆插件」：模型、工具、会话、沙箱、界面都可以换成插件，不必改 Harness 源码。官方仓库也约定：社区插件只要在 GitHub 仓库打上 dsh-plugin topic，就能被生态发现。
实际用起来会碰到一个很具体的问题。插件数量已经不少，社区目录、精选列表、GitHub topic 页各有一份索引，但你人还在 Harness 会话里：想找「任务完成发微信」「终端 TUI」「git diff 审查」这类能力，往往得切出去搜一圈，再把安装命令拷回来。dsh-find-plugin 做的就是把这一步收进会话——让智能体自己去搜，把结果和安装命令带回来。
本文介绍的是 awesome-dsh-plugin 维护的 dsh-find-plugin（不要和另一款同名相近的 dsh-find-plugins 搞混），资料以插件目录页、GitHub README / 源码、npm 包以及 DeepSeek Harness 官方仓库交叉核对。社区插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系，不要把它当成官方应用商店。
这是什么¶
dsh-find-plugin 是一款开发与运行时插件，维护者是 GitHub 组织 awesome-dsh-plugin。它给智能体注册一个工具 find_dsh_plugin：按关键词实时检索打了官方 dsh-plugin topic 的 GitHub 仓库，按 star 排序，返回一句话描述、仓库链接和可直接执行的 dsh plugin add 命令。
仓库 README 把它类比成 skills.sh 上的 /find-skills，只是对象换成了 DSH 插件。许可证是 MIT。主要语言是 TypeScript，npm 包名就是 dsh-find-plugin，本稿核对到的版本是 0.3.6（2026-08-14 发布）。GitHub 仓库在 2026-08-17 读取到的星标是 40（目录页当时仍显示 20，以 GitHub 一手数据为准）。插件已收录在社区目录「开发与运行时」分类，收录日期 2026-08-14。
它解决的问题很窄：不必离开当前 Harness 会话，就能按能力描述把候选插件搜出来。它本身不负责替你审查源码，也不在源码里实现「检查已安装插件是否可用」这一步；目录页简介里的「检查并验证安装」，在当前仓库的 find_dsh_plugin 实现中看不到对应逻辑。搜到之后如果让智能体帮忙装，它会去跑返回的安装命令——装的仍然是第三方代码。
核心功能¶
结合 README 和源码（src/index.ts、src/github.ts、src/registry.ts），当前能力可以概括成下面几条。
1、按 topic 做实时仓库搜索。 查询会拼成 GitHub 搜索 关键词 topic:dsh-plugin，走匿名 API，不需要你配置 Token。同一查询有 5 分钟内存缓存，源码注释写明未认证搜索大约每分钟 10 次请求，缓存是为了把本地工具调用压在限额内。工具超时 10 秒，GitHub 请求超时 4 秒。
2、按 star 重新排序。 搜索结果按 stargazers_count 降序。默认最多返回 8 条，limit 上限 20。每条包含名称、star 数、描述、仓库 URL，以及一条安装命令，格式为：
dsh plugin --profile web add github:owner/repo
3、精选列表只改描述，不改排名。 如果某个仓库也出现在 awesome-dsh-plugin 的 plugins.json 里，会用列表中人工撰写的双语描述替换 GitHub 仓库简介；lang 参数选语言（例如 zh / en），默认 en。精选列表拉不到时会退回仓库自带的 snapshot，失败则只用 GitHub 描述。排序始终按 star，不受精选列表影响。
4、对话里由智能体自行调用。 安装并重启 dsh web 之后，不需要记工具名。你用自然语言说想要什么能力，智能体在判断「当前 Harness 缺这个能力」或「用户在问有哪些插件」时，会自己调用 find_dsh_plugin。
工具参数如下（来自源码里的 defineTool 定义，不是猜测）：
query：必填。描述能力的关键词，例如wechat notifications、TUI、跨会话记忆。limit：返回条数，默认 8，最大 20。lang：精选条目描述语言，默认en。中文环境可以让智能体带zh。
安装与启用¶
社区目录页给出的安装命令是：
dsh plugin add github:awesome-dsh-plugin/dsh-find-plugin
仓库 README 和 awesome-dsh-plugin 详情页推荐走 npm 预构建包，并显式指定 web profile（这和 DeepSeek Harness 官方文档里 dsh plugin --profile <profile> add ... 的写法一致）：
# npm 包（预构建，README 推荐）
dsh plugin --profile web add dsh-find-plugin
# 或从 GitHub 安装
dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin
需要可复现安装时，按目录页说明把 commit 哈希钉死，不要一直追仓库默认分支：
dsh plugin add github:awesome-dsh-plugin/dsh-find-plugin#<commit>
几点安装时要注意：
- 插件以当前 dsh 进程的权限运行，安装时还可能执行构建脚本。装之前先看源代码仓库和许可证。
- README 写明：装完后要重启
dsh web，工具才会进当前会话。 - 从 GitHub 装 TypeScript 源码时，pnpm 10 及以上可能拦截
prepare/ 构建脚本。awesome-dsh-plugin 详情页写过：第一次add若提示allowBuilds，按提示把包名写进该 profile 的pnpm-workspace.yaml后再执行一次。npm 预构建包一般不需要这一步，所以 README 把它标成推荐路径。 - 这个包在
package.json里声明了dsh.bundle.patch指向./cordis.patch.yml，补丁会把 id 为find-dsh-plugin的一行插入 profile 的插件栈。peer 依赖是@deepseek-ai/cordis和@deepseek-ai/dsh-tools。
典型用法¶
装好并重启之后，直接跟智能体说话即可。README 给的例子如下，可以原样拿去试：
有什么终端 TUI 插件？
我想任务完成时收到微信通知，有插件吗？
找个能在 DSH 里做 git diff 审查的东西。
智能体调用 find_dsh_plugin 后，会得到类似下面这种文本（格式来自源码的 renderText，具体条目随 GitHub 实时结果变化，这里只说明结构）：
1. 某插件名 ★123 — 一句话描述
https://github.com/owner/repo
install: dsh plugin --profile web add github:owner/repo
每条都带 star、描述、仓库链接和安装命令。README 写明：你可以让智能体接着执行其中一条 dsh plugin add。搜不到时，工具会提示换更宽的关键词，或去 https://awesome-dsh-plugin.com 浏览精选列表。
返回结果里还会附一句固定说明：这些都是第三方代码，安装前请审阅源码并锁定 commit。这不是客套，和目录页、官方文档的安全提示是同一件事。
适用场景与注意事项¶
比较适合这几类人：已经在用 dsh web、经常要给智能体加能力，但不想每次切到浏览器翻 GitHub topic 或社区目录。关键词能对应到仓库名或简介时，搜索最有效，例如 TUI、通知、diff、记忆。
使用时有几条边界需要心里有数：
1、它搜的是 GitHub topic，不是「官方认证商店」。 任何打了 dsh-plugin 的公开仓库都可能出现。没有 topic 的插件它搜不到。DeepSeek Harness 官方也只是把该 topic 当作发现约定，并不为社区插件背书。
2、精选描述和搜索范围不是一回事。 awesome-dsh-plugin 详情页有一句「按关键词/分类搜索本精选 registry」；对照源码，真正发请求的是 GitHub 仓库搜索，精选 plugins.json 只用来替换描述。分类并不是工具参数。写文章时以源码和 README 的「How it works」为准。
3、同名插件不要装错。 社区目录里还有 dsh-find-plugins（Nagi-ovo 维护，带安装与验证流程）。本文介绍的是 awesome-dsh-plugin/dsh-find-plugin，安装命令和仓库地址都不同。
4、匿名 API 有限额，也依赖网络。 没有配置 GitHub Token。缓存按查询字符串，换关键词就是一次新请求。GitHub 搜索失败时工具会报 HTTP 错误，不会悄悄编造结果。
5、安全模型与官方一致。 目录页写得很清楚：插件以当前 dsh 进程权限运行，安装时可能执行代码。DeepSeek Harness 官方文档同样提醒：允许构建脚本等于允许安装期在本机执行第三方代码，且不在智能体沙箱里。只装你信任的源，并尽量钉 commit。dsh-find-plugin 自己搜出来的候选，也适用同一条规则——它给你的是命令，不是担保。
DeepSeek Harness 目前仍是 developer preview，官方 README 用大写标明会有破坏性变更。插件的工具 API、profile 安装方式后续都可能跟着变，安装前看一下仓库当前 README。
小结¶
dsh-find-plugin 把「在 GitHub 上找带 dsh-plugin topic 的仓库」收进了 Harness 会话：实时搜索、按 star 排序、带上安装命令，命中精选列表时换用人工写的双语描述。它不替代你对第三方代码的审查，只是少一次切出去翻目录的步骤。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-find-plugin/
GitHub：https://github.com/awesome-dsh-plugin/dsh-find-plugin
npm：https://www.npmjs.com/package/dsh-find-plugin
