ToolBox一份从源码出发、按模块组织的 DeepSeek Harness（dsh）教程。它带你从「dsh 是什么」一路走到「如何在 dsh 上写出自己的插件」，每一章都对应仓库里的一组真实包（packages/<group>/<pkg>/），并标注关键源码与类型定义的位置，方便你随时回到源码核对。
教程用中文编写；代码标识符、类型名、事件名、
ctx键等保持英文原文，首次出现时给出中文说明。
适合谁
- 想读懂
dsh源码、理清其模块边界的开发者 - 想给
dsh加工具、加能力、加模型适配器、加 Web UI 节点的插件作者 - 想用
dsh组装自己的 agent 应用（CLI / Web / ACP / JSON-RPC）的集成者
前置知识
- 会写现代 JavaScript / TypeScript
- 装了 Node.js（要求
^22.19 || >=24）与 pnpm - 对「大语言模型调用 + 工具调用」的基本流程有概念即可（没有也不怕，零基础导读会补齐）
怎么读
按顺序读即可——每一章都建立在前一章的概念之上。第 3 章是 Cordis 框架速览，是理解后续所有章节的地基；如果已经读过官方 Cordis 教程，可以快速跳过并只保留「服务 / 事件 / 接缝」三个术语。
各章在结尾给出「下一步」指针和对应的源码入口，方便按需深入。
⚠️ 注意：
dsh目前处于开发者预览阶段，接口会以破坏兼容的方式快速演进。本教程以官方仓库当前源码为准。