hoco-scy/deepseek-harness-deep-dive

深入 DeepSeek Harness

English（默认） · 中文

English

对插件优先的编码智能体运行时进行的源码锚定系统剖析

深入 DeepSeek Harness — 36 章与 1,094 条证据记录

DeepSeek Harness 不仅仅是一个编码智能体界面。这项独立研究从真实入口点、状态变更、失败分支和持久化边界出发，重建了其插件图、Agent 循环、会话日志、工具流水线、权限、沙箱、重放以及多 Agent 编排的实际运作方式。

| 已验证章节 | 证据记录 | 目录路径 | 已映射的上游包 |
|---:|---:|---:|---:|
| 36/36 | 1,094 | 533 | 219 |

阅读交互式报告 →

中文版本 · 单文件 Markdown · 证据目录 · 锚定的上游源码

独立研究，并非 DeepSeek 官方出版物。每一项事实性主张都锚定到上游提交 47f943859bef60e4160492346772ded9b24f765a。

值得首先了解的五个发现

- 重放不是一个单一功能。 DeepSeek Harness 为模型状态、请求、流、崩溃、客户端和分叉定义了各自独立的重建契约。阅读重放分析 →
- 并行完成并不意味着真相可以乱序。 工具可能乱序完成，但策略处理和持久化结果仍按模型的原始顺序提交。阅读并行性分析 →
- 持久化历史不是自主记忆。 该运行时支持显式的跨会话召回，但默认不附带任何自主长期记忆循环。阅读记忆分析 →
- Code Mode 不是权限逃逸通道。 每一次嵌套工具调用都会重新进入审批、防护、沙箱和结果流水线。阅读 Code Mode 分析 →
- 崩溃恢复拒绝凭空捏造成功。 它以确定性方式关闭未知状态，而不会声称某个外部副作用已经完成。阅读恢复分析 →

选择一条阅读路径
- 核心运行时： 设计哲学 → Turn / Step / Loop → 提示词组装 → 会话事件
- 持久性： 持久化 → 投影与检查点 → 压缩 → 重放与分叉
- 执行治理： 工具原语 → 权限与审批 → 沙箱与文件系统 → 安全边界
- 编排： 多 Agent → 工作流与 Ralph → 收件箱与延续 → 故障恢复

报告涵盖的内容

这 36 章涵盖设计哲学、Cordis 组合、启动配置、Agent 生命周期、提示词与上下文组装、LLM 适配器、会话事件、持久化、投影、压缩、记忆、计划与目标、完整的工具系统、权限、沙箱、shell 与终端执行、Skill/MCP/LSP/Web 能力、Code Mode、多 Agent 协调、工作流、故障恢复、可观测性、API/SDK/ACP、Web UI、安全、测试以及设计权衡。

每一章都区分三类论断：

- 源码事实： 在固定提交处由代码、配置、测试或官方文档直接证明的内容。
- 机制层面的推断： 由多个源码事实综合得出的控制流或语义结论。
- 设计评估： 作者对权衡、优势、成本和运行边界的判断。

覆盖数字是基于已发布证据目录的确定性导航指标。它们并不声称完整的符号覆盖、架构完整性或证明质量。

本地预览

npm run build
npm run check
python3 -m http.server 8080 --directory docs
严格的源码范围校验默认使用同级 ../deepseek-harness 检出。如需使用其他位置，请运行 node scripts/build-markdown.mjs --check --source-check required --upstream-root PATH。

打开 http://127.0.0.1:8080/ 查看英文版，或打开 http://127.0.0.1:8080/zh/ 查看中文版。该站点完全静态。“My Learning Notes”仅保存到此浏览器的 localStorage；它绝不会被提交或发送到服务器。

状态与边界

在固定基线下，全部 36 章均标记为 Verified。未来的上游变更需要新的固定快照；它们绝不会静默改写本报告的事实基线。

本仓库仅包含对公开可用的 DeepSeek Harness 源码的独立分析。它不包含来自任何其他项目的私有实现细节或私有架构结论。

许可

研究内容与视觉资产依据 CC BY 4.0 许可。软件与构建工具依据 MIT License 许可。有关确切的文件边界与第三方排除项，请参阅双语 许可范围。

中文

深入 DeepSeek Harness：一份固定源码基线、逐条可追溯的 Coding Agent 系统解剖

深入 DeepSeek Harness——36 章与 1,094 条证据记录

DeepSeek Harness 不只是一套 coding-agent 界面。这份独立研究从真实入口、状态变化、失败分支与持久化落点出发，复原其插件图、Agent 循环、Session 日志、工具管线、权限、沙箱、重放和多 Agent 编排究竟如何工作。

| 已复核章节 | 证据记录 | 证据目录路径 | 已盘点上游包 |
|---:|---:|---:|---:|
| 36/36 | 1,094 | 533 | 219 |

阅读交互式中文版 →

English（默认） · 单篇中文 Markdown · 证据目录 · 固定上游源码

本仓库是独立研究，并非 DeepSeek 官方发布。所有事实结论均固定到上游 commit 47f943859bef60e4160492346772ded9b24f765a。

建议先读的五个结论

- “重放”不是一种功能。 DeepSeek Harness 为模型状态、请求、流、崩溃、客户端与分叉分别定义了不同的重建契约。阅读重放分析 →
- 并行完成不等于事实乱序。 工具可以乱序结束，但策略处理与持久结果仍按模型原始顺序提交。阅读并行分析 →
- 持久历史不等于自主记忆。 运行时支持显式跨会话召回，但默认并未提供自主运行的长期记忆循环。阅读记忆分析 →
- Code Mode 不是权限逃逸通道。 每个嵌套工具调用仍会重新进入审批、Guard、沙箱与结果流水线。阅读 Code Mode 分析 →
- 崩溃恢复拒绝制造成功。 它会确定性闭合未知状态，但不会声称外部副作用已经完成。阅读恢复分析 →

选择阅读路径
- 核心运行时：设计哲学 → Turn / Step / Loop → 提示词组装 → Session 事件
- 持久化：数据库与持久化 → Projection 与 Checkpoint → 压缩 → 重放与 Fork
- 执行治理：工具原语 → 权限与审批 → 沙箱与文件系统 → 安全边界
- 编排：多 Agent → Workflow 与 Ralph → Inbox 与 Continuation → 故障恢复

报告覆盖范围

36 章覆盖设计哲学、Cordis 组合、启动 Profile、Agent 生命周期、提示词与上下文组装、LLM Adapter、Session 事件、持久化、Projection、压缩、记忆、Plan 与 Goal、完整工具系统、权限、沙箱、Shell 与 Terminal、Skill/MCP/LSP/Web、Code Mode、多 Agent、Workflow、故障恢复、可观测、API/SDK/ACP、Web UI、安全、测试与设计取舍。

每篇正文严格区分三类结论：

- 源码事实：可由固定 commit 下的代码、配置、测试或官方文档直接证明。
- 机制推导：由多处事实串成的控制流或语义结论。
- 设计评价：作者对取舍、优势、代价和适用边界的判断。

覆盖数字是对已发布证据目录的确定性导航指标，不代表完整的符号覆盖、架构完整性或证明质量。

本地查看

npm run build
npm run check
python3 -m http.server 8080 --directory docs

严格源码行号验证默认读取同级 ../deepseek-harness checkout；如位于其他目录，运行 node scripts/build-markdown.mjs --check --source-check required --upstream-root PATH。

英文版打开 http://127.0.0.1:8080/，中文版打开 http://127.0.0.1:8080/zh/。站点是纯静态文件；每页的“我的学习体会”只保存在当前浏览器的 localStorage，不会提交到仓库或发送到服务器。

状态与边界

固定基线下的 36 章全部标记为已复核。后续上游变化需要建立新的固定快照，不会静默改写本报告中的事实基线。

本仓库只包含基于公开源码的 DeepSeek Harness 独立拆解，不包含任何其他项目的非公开实现或内部架构结论。

许可证

研究内容与视觉资产采用 CC BY 4.0，软件与构建工具采用 MIT License。准确的文件适用范围与第三方材料排除项请见双语许可说明。