DeepSeek Harness 从入门到精通

🏛️

宏观模块抽象

以"能力缝（capability seam）"为主线，梳理 Service Definition / Service Provider / Consumer 三种角色与 50+ 个服务在配置树中的组装方式。

🔄

事件驱动内核

详解 Cordis 插件框架、四种事件派发模式（emit / waterfall / parallel / serial）、agent 轮次流程与工具执行流水线。

🧠

各模块内部策略

逐模块拆解 shell、沙箱、文件系统、subagent、workflow、jobs、goal、schedule、compaction、skill、web、前端等内部机制与设计决策。

📚

规范文档 + 引用

每章按标准文档结构撰写，标注源码出处（仓库路径 + GitHub 链接），可逐条溯源验证。

🚀

从入门到精通

六部分递进：入门 → 核心概念 → 系统架构 → 模块精讲 → 进阶实践 → 精通（源码构建、设计哲学、术语表）。

🧩

面向扩展

以官方 cookbook 为基础，讲解如何添加工具、LLM 适配器、agent preset，把"理解架构"转化为"扩展架构"。

如何使用本站

快速入门：先读第 0 章入门篇，把 npx @deepseek-ai/dsh web 跑起来。

建立心智模型：读完第二部分核心概念与第三部分系统架构，你就掌握了 DSH 的宏观图景。

按需查阅：需要理解某个具体模块（如 subagent、沙箱）时，直接跳到第四部分模块精讲对应章节。

动手扩展：参照第五部分进阶实践，编写你的第一个 DSH 插件。

学习对象与版本说明

本站在 2025 年基于以下来源编写：

源码仓库：deepseek-ai/deepseek-harness（本地镜像位于 deepseek-harness-src/）

官方文档：仓库内 docs/ 目录（architecture.md、capability-seams.md、tool-catalog.md、子系统页等）

设计决策：.agents/notes/ 目录的 Agent Notes（约 1300+ 篇，含已实现/已拒绝/已归档）

WARNING

DSH 处于开发者预览阶段，官方声明"未来将出现破坏兼容性的变更"。本文描述的 API 与配置以所引用的 commit（HEAD）为准，学习时请以源码为准。

阅读路径建议

读者	建议路径
想先用起来的人	0.1 → 0.2 → 0.3 → 2.1 → 3.13
想理解架构的人	第二部分全部 → 2.1 → 2.2 → 2.3 → 2.4 → 2.5
想扩展 DSH 的插件作者	1.1 → 1.2 → 1.4 → 2.3 → 第五部分全部
想研究多智能体编排	3.4 → 3.5 → 3.6 → 3.7 → 3.8 → 3.9
想贡献源码的开发者	5.1 → 5.2 → 4.4 → 4.5

读者

建议路径

想先用起来的人

0.1 → 0.2 → 0.3 → 2.1 → 3.13

想理解架构的人

第二部分全部 → 2.1 → 2.2 → 2.3 → 2.4 → 2.5

想扩展 DSH 的插件作者

1.1 → 1.2 → 1.4 → 2.3 → 第五部分全部

想研究多智能体编排

3.4 → 3.5 → 3.6 → 3.7 → 3.8 → 3.9

想贡献源码的开发者

5.1 → 5.2 → 4.4 → 4.5

DeepSeek Harness从入门到精通