前言¶
在 DeepSeek Harness (DSH) 的开发与使用过程中,面对不断增长的生态(包括核心仓库和大量带有 dsh-plugin 标签的社区仓库),开发者常常面临一个问题:如何快速定位与当前目标相关的 Harness?以及这些现成的方案是否值得尝试?
dsh-plugin-scout 是什么¶
dsh-plugin-scout 是一个 DeepSeek Harness 插件与技能,由 icefall7 维护,属于「工作流」类别。它的核心作用是侦察 DSH 生态:扫描核心 deepseek-harness 仓库以及所有带有 dsh-plugin 标签的仓库,发现与目标相关的 Harness,并判断每个候选者是否值得尝试。
核心功能¶
该插件提供以下能力:
- 全生态扫描:侦察核心 deepseek-harness 仓库以及所有带有
dsh-plugin标签的公共仓库。 - 列表生成:列出 deepseek-harness 包以及本地已安装的官方包。
- 筛选过滤:仅列出公开、未归档且非 Fork 的仓库。
- 相关性聚焦:根据用户目标缩小候选范围。
- 代码审查:检查候选者的 README、package.json 和文件树。
- 裁决输出:应用判断标准,给出裁决结果(TRY / WATCH / SKIP)。
安装与启用¶
在使用前,请确保你的环境满足 Node.js >= 18.0.0。安装命令如下:
dsh plugin add https://github.com/icefall7/dsh-plugin-scout
安装完成后,该 Bundle 会自动注册 plugin-scout 技能。如果需要单独安装技能目录,也可以复制 skills/plugin-scout 到 $DSH_HOME/skills/。
典型用法¶
你可以向 DSH 提出以下问题来使用该技能:
- “Is there a harness for X in the ecosystem? Should I try it?”
- “Before I build a Y plugin, what already exists?”
- “Survey the dsh-plugin topic and judge what is worth adopting for my goal.”
技能运行时会执行两个确定性脚本:
scripts/survey-harness.mjs:列出 deepseek-harness 包和本地安装的官方包。scripts/search-topic.mjs:列出带有dsh-plugin标签的公共、非归档、非 Fork 仓库(支持分页)。
随后,系统会筛选相关候选者,审查其文档和文件结构,并依据 references/judgment-rubric.md 生成裁决。
适用场景与注意¶
- 定位现有资源:在动手开发新 Harness 前,先确认核心仓库或社区中是否已有现成方案。
- 评估社区方案:面对大量社区插件,利用该工具快速判断其是否符合需求。
- 职责边界:请注意,dsh-plugin-scout 仅负责「侦察」与「判断」。安装选定的插件由
find-plugins负责,构建新插件由make-dsh-plugin负责。 - 权限与安全:插件以当前 dsh 进程的权限运行,安装前建议检查源码与许可证(本项目为 MIT 许可证)。
总结¶
dsh-plugin-scout 是探索 DSH 生态的高效工具。通过它,你可以系统地了解生态现状,并基于客观标准决定是采纳、观望还是跳过某个 Harness。