DeepSeek Harness 源码学习

DEEPSEEK HARNESS · 源码精读

从一条请求出发，读懂
Agent 系统如何运转

不是 README 翻译，也不是 API 罗列。这是一套基于固定源码提交的 12 章中文课程：先建立系统地图，再沿真实调用链追到模型、工具、事件账本和产品界面。

开始第一章阅读说明与证据

12: 章完整课程
47f9438: 固定源码基线
4: 个学习模块

DeepSeek Harness 源码学习路线总览：从入口、Agent 循环、模型与工具到事件账本 — 课程总览先看全景，再进源码

源码基线 47f943859bef60e4160492346772ded9b24f765a Developer Preview · dsh 0.1.0-rc.5

01 · MENTAL MODEL

先抓住两条不变式

后面的组件很多，但判断设计是否合理只需要反复检查这两件事。

COMPOSITION

一切皆插件

模型适配器、工具注册表、Session 日志、Agent Loop 都是 Cordis 插件。扩展优先挂接服务与事件，不直接修改循环。

OBSERVABILITY

模型可见，必须入账

发送给模型的内容必须能从 Session Event Log 重建。恢复、分叉、转录、遥测与界面都读同一条事实流。

02 · REQUEST FLOW

一条请求怎样穿过系统

输入不会直接“扔给模型”。它会被 Inbox 接收、组装上下文、流式执行，再把每一步写入事件账本。

入口CLI / Web用户输入

接收Agent Inboxturn / start

组装Prompt + Tools上下文与能力

执行LLM ↔ Tool流式循环

事实源Event Log持久化 / 恢复 / UI

03 · CURRICULUM

12 章，按四个模块读完

每章都从“本章学习目标”和“一句话讲明白”开始，再进入源码证据与调用链。

课程怎么读

MODULE A

看懂骨架

入口、插件内核与主循环

01项目地图与启动从 dsh 命令追到插件树 02Cordis 插件内核Context、Service、Effect、Waterfall 03Agent 主循环Turn、Step、Inbox 与停止条件

MODULE B

追踪一次执行

事件账本、模型流与工具管线

04Session 事件账本唯一事实源与消息投影 05LLM 流式适配路由、准备、SSE 与错误归一 06工具执行管线Schema、审批、调度与结果

MODULE C

理解上下文与扩展

Prompt、持久化和委托机制

07Prompt 与上下文协作式组装与日志闭环 08持久化与恢复Write-behind、JSONL、SQLite 09Skills 与 Subagents发现、装载、委托与生命周期

MODULE D

落到真实产品

命令行、界面与扩展实战

10CLI 与 ProfilesBundle、Patch 与无头运行 11Web / TUI 界面薄入口与事件投影 12扩展、测试与实战新增能力的最小闭环

04 · READING PATH

不用拘泥于顺序

按你的目标选择最短路线；需要补背景时，再回到相邻章节。

架构速读

01 → 02 → 03 → 04

讲清插件树、Agent 循环和事实账本的关系。

开发模型能力

03 → 05 → 06 → 07 → 09

新增模型、工具、Skill 或 Subagent Provider。

参与项目开发

01 → 08 → 10 → 11 → 12

启动、调试、扩展，并用真实入口完成验证。