黑鲸出，见全貌——DeepSeek Harness 架构与哲学
English | 中文
一部深入剖析 DeepSeek Harness（
dsh）的十章专著。从"一切皆插件"的灵魂、事件溯源日志的命脉、Agent Loop 的心跳，到工具执行、编排层、数据层、工程质量，再到知乎社区的争论与哲学的升华。
全书共 10 章 + 序言，约 12.2 万中文字符，每章均不少于 1.2 万字。
目录（Table of Contents）
-
序言：当一家模型公司决定开源它的"骨架"
-
第一章 · 初识 Black Whale：dsh 是什么，它想改变什么（约 1.25 万字）
- Model + Harness = Agent 的公式
- 一家模型公司为什么突然要做"骨架"
- 不是竞品，而是"把整个品类开源掉"
- 规模与构成、核心哲学、宏观架构地图
-
第二章 · Cordis 内核与"一切皆插件"（约 1.2 万字）
- 从 Koishi 到 Cordis：五个核心概念
- 插件 / 上下文 / inject / 类型化事件 / 可逆副作用
- "时空可组合性"论文、Profiles/Bundles/Patch、上下文键地图
-
第三章 · 会话系统与事件溯源日志（约 1.2 万字）
- Session 不是聊天记录，而是追加式事件日志
- SessionEventMap 词表、消息从日志派生
- "模型可见即已记录"与 SurfaceOp replace、持久化与崩溃恢复
-
第四章 · Agent Loop 与 Turn / Step / 事件机制（约 1.2 万字）
- turn/step 的心跳分层、inbox、agent/pre-step
- 一次模型请求是日志的"纯函数"
- agent/* 事件、错误与取消纪律、作用域与多 agent
-
第五章 · 能力接缝与工具执行管线（约 1.2 万字）
- Service Definition / Provider / Consumer 三位一体
- "换一个 Provider 就改变整个产品"
- pre → guard → approval → execute → post → finalize → result
-
第六章 · 让模型长出"手脚与耳目"（约 1.2 万字）
- 共享执行世界、bash / 子进程 / 终端 / 沙箱 / LSP / 文件系统 / Web / Code Runtime
-
第七章 · 让模型"分身"去干活：编排类能力（约 1.2 万字）
- 子 Agent 与"持续可续"、Workflow、Goal、Plan、Schedule、Jobs、Ralph
-
第八章 · 存得住、投影得清、检索得到、还呈现得出来：数据层与前馈端（约 1.2 万字）
- 持久化接缝、存储中枢、投影缓存、会话检索、Typert、Web 客户端、SDK/ACP
-
第九章 · 看不见却异常结实的骨架：工程质量与开发者体验（约 1.2 万字）
- 测试分层阶梯、验证世界而非自报、文档即门禁、运行时不变式、类型铁律、Agent Notes、双语即门禁
-
第十章 · 海面上的潮汐：知乎大神们的交锋，与一场哲学的升华（约 1.2 万字）
- 知乎上关于 dsh 的提前预判与两极争论
- "一边喊革命，一边吐槽太糙"
- 哲学升华：智能长出"手脚"、思考被回放、一切皆插件的构成主义、自由与缰绳的控制论
篇幅核验（每章中文字符数）
| 章节 | 中文字符数 | 是否 ≥1.2万字 |
|---|---|---|
| 第一章 | 12541 | ✅ |
| 第二章 | 12016 | ✅ |
| 第三章 | 12080 | ✅ |
| 第四章 | 12052 | ✅ |
| 第五章 | 12015 | ✅ |
| 第六章 | 12008 | ✅ |
| 第七章 | 12089 | ✅ |
| 第八章 | 12035 | ✅ |
| 第九章 | 12026 | ✅ |
| 第十章 | 12012 | ✅ |
全书中文字符合计：约 122,000 字；全书（含标点等非空白字符）约 20 万字符。
本目录文件由质量校验步骤自动生成，篇幅数据在最终交付前已复核。