手把手：从 0 到 1 造一个 DeepSeek Harness 插件（双语教程 + 两个已发布插件复盘）

[kittimzhe]

dsh-session-export（会话导出）和 dsh-session-recall（全文检索）两个插件从 0 发到 npm 之后写的一篇实战复盘——代码逐字来自这两个已发布包，坑都是我真掉进去过的。

里面有什么（9 节 + 附录）：

1. 最小可跑骨架：package.json（dsh.bundle）+ cordis.patch.yml + index.ts 入口
2. 两类挂载：ctx.tools（给模型，花 token）/ ctx.commands（给人敲 /xxx，零 token）
3. 头号坑：inject 漏声明 → 运行时炸，附 grep ctx. 自查办法
4. 一个真实工具的完整 execute：授权边界（sessionQuery 不鉴权、得自己按 cwd 收窄）+ exec.signal 透传
5. cordis.patch.yml 覆盖官方默认（把 session-query-sqlite 从内存库改成磁盘持久化）
6. 打包 → 本地装 profile → 真数据冒烟 → 发 npm → 发 GitHub 的完整闭环
7. 测试怎么搭：副作用藏到接口后面，58 个测试全内存跑，零网络零 IO
8. 坑速查：SQLite FTS 中文不分词、首次建索引超时、内存库重启即失……

两个参考实现（MIT、已发 npm、可照着抄）：

• dsh-session-export：command 注册 + 会话读写 + Markdown/JSON 渲染 + 原子写
• dsh-session-recall：defineTool 完整示例 + 授权过滤 + patch 覆盖官方默认，v0.3.0 多词中文 AND 回退

双语：中文原版 + 英文版同仓。

仓库：https://github.com/kittimzhe/dsh-plugin-authoring-guide

哪里对官方语义理解偏了，欢迎直接指。

[Youchun-show]

为何不让 DSH 自己写插件？