前言¶
DeepSeek Harness(DSH)的生态是「一切皆插件」:具体任务往往要装对应能力包,但社区插件分散在第三方目录、用户自配市场和 GitHub 上,名字也不固定。单靠记忆或随手搜仓库,很难在有限时间里核对作者声明、安装前提和版本是否一致。
下面介绍维护者 oxmumu3 的 dsh-plugin-finder(侧栏入口「发现好插件」)。它在 DSH 侧栏提供独立面板,理解你的任务描述,从可查证的来源动态检索候选,阅读作者资料后给出最小方案,并把接续工作交给原生会话草稿——不自动安装插件,也不代替你在宿主里确认安装。
这是什么¶
一句话:找到有来源可查的插件方案,再接着在 DeepSeek Harness 里做。
- 仓库:oxmumu3/dsh-plugin-finder
- 当前版本:
0.3.0-preview.2(Preview) - 分类:联网工具(SkillHub 目录归类)
- 兼容声明:DSH
0.2.0-rc.2或0.2.1-rc.2,Node>=22.13(兼容声明不等于所有环境均已验收)
不需要额外填写模型 Key,沿用 DSH 已配置模型的正常额度。推荐插件仍由 DSH 原生管理器确认安装;会话只准备草稿,由你检查后发送。可选反馈回传默认关闭。
核心功能¶
插件从哪里来¶
Finder 在下列来源内做有界检索,并在页面上展示本次来源、查询时间及实时/缓存/过期/失败状态:
- Awesome DSH 第三方目录:按需读取 plugins.json,并以 index.json 作补充。这是第三方来源,不是 DSH 官方审核目录。
- 用户已配置的 DSH 市场:通过宿主原生市场能力搜索;未配置会明确显示,不自动添加或更改市场源。
- GitHub
dsh-plugintopic:按需求做有界补充检索。
索引与 JSON 读取使用 5 分钟内存缓存;用户市场的缓存由宿主管理。召回后在预算内(例如最多 24 条候选、全轮 45 秒、每候选 8 秒)核对至最多 6 个候选,并读取作者包清单与 README,核对包身份、版本/提交、bundle 声明、兼容前提及安装来源。README 未读到或可能版本不一致时会保留提示。
这是所列来源内的动态检索,不穷尽整个网络;目录条目数、GitHub 热度或候选数量都不等于使用量或任务成功率。
从检索到可用方案¶
相对生态里已有的 dsh-find-plugin 等检索工具,本项目在其上衔接四步:
- 确认用户意图:把任务拆成目标、输入、产出、约束、能力和搜索词,允许修改。
- 理解候选资料:说明作者声称支持什么、需要哪些账号/环境、哪些信息还未知。
- 确认最小方案:允许原生能力够用、单插件、最多两个插件组合或明确供给缺口,并说明每一步的输入输出和分工。
- 原生会话接续:保存所选任务版本,选择工作区,核对目标会话并准备普通文本草稿,由用户检查和发送。
本插件只在宿主侧栏增加入口和主面板,保留原生会话与工作区;不自动安装候选,也不自动提交或执行会话任务。完整流程通常请求宿主模型约 2 次(重新操作可能增加),使用已配置模型的正常额度与计费。
本机历史与可选回传¶
每个本机任务会保存输入、理解、候选资料、方案、主动保存的反馈和原生会话关联。「新需求」只清空输入,旧方案仍在「我的方案」;可导出、导入单个任务的 JSON 备份。集中回传默认关闭;用户明确同意后才同步有界摘要,路径不读取文件、完整会话或模型凭据。详见仓库 数据回传说明。
安装与启用¶
安装前请到 v0.3.0-preview.2 Release 核对附件、校验值和验证记录。
在 DSH「插件 → 添加插件」中粘贴下面地址,安装后点「立即启用」,侧栏会出现「发现好插件」:
https://github.com/oxmumu3/dsh-plugin-finder/releases/download/v0.3.0-preview.2/dsh-plugin-finder-0.3.0-preview.2.tgz
也可把下面这段话交给 DSH,由当前会话的原生插件管理能力尝试安装(能否直接安装取决于工具与宿主权限,不是已验证的自动安装承诺):
请通过当前 DSH 的原生插件管理能力安装并启用“发现好插件”:https://github.com/oxmumu3/dsh-plugin-finder/releases/download/v0.3.0-preview.2/dsh-plugin-finder-0.3.0-preview.2.tgz 。安装到我正在使用的 DSH,不要另建 profile;需要我确认或重启时请提示我,完成后核对侧栏入口。如果当前会话没有安装工具,请给出在宿主插件页安装的步骤。
更完整的步骤见仓库 docs/install.md。
典型用法¶
三步试用¶
- 描述需求,核对目标、材料与约束。
- 查看推荐方案,按所选插件的安装指引在 DSH 安装并启用;已装过的先核对,无需重复安装。
- 选择工作区继续,检查原生会话草稿后发送;有卡点可以反馈、调整方案,旧版本仍在「我的方案」。
安装后:描述任务 → 点击「理解这个需求」并核对六个意图字段 → 「确认需求,搜索并推荐」→ 看方案与安装指引 → 选好工作区后准备草稿,实际任务在原生会话发送。
文档中的观察任务(可直接粘贴试用)¶
README 提供了三个用于观察理解、召回、资料核对与草稿是否进入正确工作区的示例需求,任何任务都可能得到缺口或不确定结论,不是成功保证。
文档批处理(本地优先):
把一批 PDF、Word、Excel 和 PowerPoint 文件转成可供 Agent 阅读的文本,优先本地处理。请动态搜索相关插件,核对作者的格式支持、安装前提和额外账号要求,再给最小方案。
Markdown 预览(Mermaid / KaTeX):
我想在 DSH 中预览 Markdown 里的 Mermaid 流程图和 KaTeX 数学公式。请搜索相关插件,说明哪个覆盖主要需求、需要哪些宿主能力,以及开始使用的步骤。
按日记事与月历回看:
我想按天保存记事和待办,并在月历里回看每天的日志。请找有作者资料支持的插件,区分已声明能力和未验证部分,再把方案带到我选定的工作区。
更完整的实跑说明见 docs/first-use-case.md 与 docs/verification.md。
适用场景与注意¶
适合谁:已经在用 DSH、遇到具体任务却不知道该装什么插件的人;你不必先记住插件名字,由 Finder 理解需求、检索来源并给出最小方案,再在原生会话里继续。
边界与权限:
- 插件在 当前 DSH 进程权限 下运行;安装前应自行检查源码与 MIT License,第三方索引与作者文档遵循各自许可证;收录与资料读取不代表 DSH 官方推荐、安全审计或安装成功。
- 本版不自动判断候选是否已安装、不自动验收组合,也不回读后续任务结果;第三方候选服务可能另有账号、Key 或费用。
- SkillHub 上的社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,勿当作官方应用商店。
创作者被发现:公开仓库可使用 dsh-plugin topic,并在 README 写明任务、可安装 bundle、版本、前提与首次使用步骤;无需向本项目单独申请固定名单。
结尾¶
dsh-plugin-finder 把「该装什么」从记名字、翻仓库,改成按任务从 Awesome DSH、自配市场和 GitHub topic 等有界检索,核对作者资料后给出最小方案,并在原生工作区里以草稿接续——安装仍由你在 DSH 原生插件管理器确认。