dsh-hello-publisher:为 dsh-github-publisher 准备的端到端测试插件

前言

在 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye