插件示例模板 chenhz01/dsh-sample-plugin

dsh-sample-plugin

一个为 DeepSeek Harness 编写插件的极简、经过验证的示例（“一切皆插件”）。非官方——只是一个能运行的社区示例。

两个插件，一个组合：

- src/tool-hash-sum.ts —— 一个模型可调用的 hash_sum 工具（对文本或文件进行 sha256/sha1/md5）。遵循官方文档中的 defineTool 契约：带类型的参数、规范的 JSON 输出、面向模型的 render、exec.signal 取消。
- src/result-logger.ts —— 一个钩子插件，观察文档中记载的 tools/result 扩展点，在不触及分发的情况下统计每一个最终结果。

经过验证，而非“应该能跑”

针对真实服务栈（Timer + SystemPrompt + ToolRegistry，与 harness 自身的测试辅助工具相同）进行端到端运行，8/8 项检查通过：

| # | 检查项 | 结果 |
| 1 | schemas() 面向模型的投影 | 通过 |
| 2 | 规范的 JSON 值 + render 输出 | 通过 |
| 3 | 已知答案检查：sha256("abc") = ba7816bf…15ad | 通过 |
| 4 | 通过感知 exec.signal 的 I/O 进行文件哈希 | 通过 |
| 5 | 跨字段校验（text/path 中恰好一个）以 isError 形式被包含 | 通过 |
| 6 | 不支持的算法被包含，不崩溃 | 通过 |
| 7 | tools/result 钩子观察到 5/5 个结果 | 通过 |
| 8 | 基于 effect 的注销（dispose 移除工具） | 通过 |

运行它

npm install
node --import tsx verify.ts

需要 Node 22+。依赖从 npm 解析：@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-system-prompt、@deepseek-ai/cordis-plugin-timer。无需 API 密钥——该示例以无密钥方式运行，与官方 Cordis 教程相同。

三个值得了解的坑（血泪教训）

1. output.schema 是一种 DSL，而非原始 JSON Schema（ValueSchemaSpec）：对象节点必须声明 additionalProperties，required 仅在参数属性上受支持，并且 type: 'json' 只存在于该 DSL 中。
2. 原始的 registry.register() 则针对普通 JSON Schema 进行校验——在那里 type: 'json' 并不存在。
3. registry.execute() 需要调用方的 signal —— registry 会无条件读取 callerSignal。

许可证

MIT。使用的第三方包基于 MIT / BSD-3-Clause —— 见 THIRD_PARTY_NOTICES.md。

作为 dsh 插件生态的首次贡献探针而构建。欢迎反馈：hcac4735@agent.qq.com · GitHub @chenhz01

合作

本仓库中的一切均可自由使用——没有锁定的层级，没有追加销售。

- 免费：本示例、其验证脚本，以及上述三个坑。尽管复制。
- 定制插件开发：我承接付费项目，构建生产级 dsh 插件（工具、钩子、协议桥接）。邮件中需包含两件事：你的 harness 部署需要什么，以及你的时间线。
- 不提供：对 DeepSeek 路线图的看法——那是他们的地盘，不是我的。
如果你正在决定是否要发邮件：上面的验证表就是质量标准。如果它看起来符合你的标准，我们大概会合得来。