前言¶
在 DeepSeek Harness(DSH)里做插件发布或收录,往往需要一条能反复跑通的样本仓库:结构要符合收录约定,行为要足够简单,便于对照发布流程里新增的提交与分支。若直接用业务插件做试跑,文件多、副作用难控,排查「是发布链路问题还是插件本身问题」会拖慢节奏。
dsh-hello-publisher 就是为此准备的极小插件:一行 loader、一个演示工具,专门用来验证 dsh-github-publisher 整条链路是否工作正常。
这是什么¶
dsh-hello-publisher 由维护者 fwcheng-gif 发布,在 SkillHub 目录中归类为工作流。仓库自述的定位是:A minimal DeepSeek Harness plugin used to exercise dsh-github-publisher end to end: one loader row, one demo tool.
它不面向终端用户功能,而是测试夹具(test fixture):故意做得足够小,让发布链路涉及的每个文件都可以人工核对。
核心功能¶
插件在宿主侧注册一个示例工具 hello_publisher,调用后返回一句问候。README 将其说明为存活探针——工具能在会话里出现,即表示插件已被正确加载,且工具注册路径畅通。
行为边界在文档里写得很清楚:只读问候、不写文件、不访问网络、不修改任何状态。
仓库当前在 GitHub 上星标数为 0;这不影响其作为样本的用途,但说明它主要是维护者与发布工具链自用,而非热门社区插件。
目录与文件结构¶
| 文件 | 作用 |
|---|---|
package.json |
声明 dsh.bundle.patch,这是被收录的前置条件 |
cordis.patch.yml |
一行 loader 条目,使插件可安装 |
lib/index.js |
宿主半边:注册 hello_publisher 工具 |
LICENSE |
MIT |
package.json 中 dsh.compatibility 标明:DSH 版本 >=0.2.0-rc.2 <0.3.0,支持 profile web 与 desktop;运行环境要求 Node >=20.18。打包发布时 files 字段仅包含 lib、cordis.patch.yml、README.md、LICENSE。
安装与启用¶
本地开发或自测时,README 给出的安装方式为(将占位符换成本仓库在本机的绝对路径):
dsh plugin --profile desktop add '<本仓库的绝对路径>'
若你通过 profile bundle 手工挂载,需要把 dsh.bundle.patch 所指向的 cordis.patch.yml 里的 loader 行加入对应 profile。
安装前请自行阅读 lib/index.js 与 cordis.patch.yml,并确认 MIT 许可证是否符合你的合规要求。插件以当前 DSH 进程的权限运行;本样本虽无害,养成检查源码的习惯对任何插件都适用。
典型用法¶
启用插件后,在支持工具调用的 DSH 会话中应能看到 hello_publisher。调用该工具即可得到问候语,用于确认加载与注册是否正常。README 未提供更深层的 CLI 子命令或配置项;样本的「用法」本质上就是:装得上、工具可见、能返回固定问候。
若你在验证 dsh-github-publisher,可配合 README 建议:仓库 git log 仅有一次提交、git status 干净时,更容易观察发布流程新增的分支与提交。
适用场景与注意¶
适合谁
- 需要调试或验收
dsh-github-publisher的维护者与贡献者。 - 需要一份「结构完整、要素齐全」的 DSH 插件最小范例的开发者(含
dsh.bundle、loader 行、README、LICENSE、description)。
为什么选它做样本
- 结构完整:收录所需要素齐全。
- 足够无害:仅注册只读问候工具。
- 便于核对:历史提交少、工作区干净,便于对比发布后的变更。
注意
- 不要把它当作生产功能插件;它没有业务逻辑,只有探针意义。
- 安装命令以 README 为准,勿凭仓库名自行拼接
dsh plugin add github:owner/repo一类命令(除非你的环境文档另有说明)。 - DSH 社区目录(如 SkillHub)是独立站点,与 DeepSeek / 幻方无官方从属关系;本文仅介绍该开源仓库与其在生态中的测试用途。
结尾¶
dsh-hello-publisher 的价值在于「小而全」:用一行 loader 和一个 hello_publisher 工具,把插件加载与工具注册这条路径跑通,给 dsh-github-publisher 提供可重复的端到端样本。版本 0.1.0,许可 MIT。
- 目录页:https://www.skillhub.cn/plugins/fwcheng-gif/dsh-hello-publisher
- 源码与说明:https://github.com/fwcheng-gif/dsh-hello-publisher