📚 DeepSeek Harness 源码级拆解全攻略

一份带你从源码层面深入理解 DeepSeek Harness 的教程，共 11 章，覆盖基础、核心、进阶与实战。适合想自己构建 AI Agent 编排框架的开发者。

---

📌 教程结构

第一部分：基础入门

· 第1章 开篇 – 项目简介、设计哲学（一切皆插件、事件溯源）、Seam 架构总览
· 第2章 Cordis 插件框架深度解析 – Context/Fiber/Events/Plugin 源码，四种事件模式 + Effect 系统

第二部分：核心模块

· 第3章 Agent 系统 – Agent 接口、Inbox 机制、生命周期（followup/steer/inject）
· 第4章 Session 会话系统 – 事件溯源、事件类型、消息派生（模型可见即已记录）
· 第5章 工具系统 – 工具注册、执行管线、Code Mode（defineTool、守卫、并发控制）
· 第6章 LLM 适配器体系 – 适配器模式、StreamChunk 协议、重试策略

第三部分：进阶主题

· 第7章 作用域系统 – 隔离机制、作用域链、事件过滤
· 第8章 Goal 目标与 Jobs 任务系统 – 目标状态机、后台任务管理、AbortController
· 第9章 Seam 架构与能力替换 – 文件系统/Shell/沙箱/子代理的可替换能力

第四部分：实战与附录

· 第10章 实战：构建完整 Harness – 完整可运行示例（LLM 适配器 + 4 个工具 + 交互式聊天）
· 第11章 附录 – 术语表、类型速查、事件速查表、学习路径

---

🧩 核心架构分层
用户界面层（CLI / Web / ACP API）
→ 编排层（Agent Loop / Tool Registry / Session Store / LLM Service / System Prompt）
→ 能力层（Filesystem / Shell / Subprocess / LSP / Web）
→ 基础设施层（Cordis Framework：Events / Fiber / Context / Scope）

---

💡 四大设计理念

· 一切皆插件 – 每个部件都可从配置替换
· 模型可见即已记录 – 所有到达模型的内容均可从会话日志重建
· 事件即扩展点 – 选对事件域是多数改动的第一步
· Seam 架构 – 替换 Provider 即可改变整体行为

---

📖 学习建议

· 按章节顺序阅读，先扎实 Cordis 基础
· 每章含真实源码片段与 Mermaid 图表
· 第10章提供可运行示例，建议动手实践
· 术语不熟时查阅附录速查表

本教程由 DeepSeek Harness 源码分析整理而成。

#deepseek #harness #dsh