专题篇章
拆开 DeepSeek Harness
沿着插件化 Agent 基础设施，追踪会话日志、工具调用、压缩、收件箱和沙箱执行。它是一条可选的源码阅读路线，适合想看懂界面背后抽象的人。
专题篇章29篇札记
本页解决的问题
先给结论「拆开 DeepSeek Harness」AI 学习路径适合解决什么问题？
沿着插件化 Agent 基础设施，追踪会话日志、工具调用、压缩、收件箱和沙箱执行。它是一条可选的源码阅读路线，适合想看懂界面背后抽象的人。 路线包含 29 篇免费札记，每篇聚焦一个可以独立搜索、理解和验证的问题。
判断标准
核心主题包括：系统地图、会话与循环、上下文工程、工具系统。
下一步
从「一切皆插件：官宣与源码对照」开始，再按当前任务选择下一篇。
常见误区
不要为了完成目录而跳过实践；能用自己的例子解释一个取舍，比读完更多标题更重要。
这条路径会练什么
从第一篇打开
每个章节都围绕一类真实决策展开。可以顺着走，也可以从正在处理的工作切入。
01一切皆插件：官宣与源码对照把发布文案里的四种模式、会话日志、插件生态逐条对到仓库里的 YAML 预设与包结构↗02Profile / Bundle / Patch：用户能把产品改到什么程度配置三层结构怎么让用户不改源码就换掉深层能力↗03Model-visible ⟺ logged：一条会崩给你看的不变量从 invariant.ts 的逐字节比对讲起：为什么模型看到的一切必须能从日志重建↗04followup / steer / inject：双队列 Inbox拆解 next-turn 与 next-step 两条队列的入队、claim 与唤醒语义，对照 Claude Code 的中断模型↗05Esc 之后发生了什么：取消、崩溃恢复与重入每轮一个 AbortSignal，中断也要写回日志，崩溃重启还能接着跑↗06Goal：消息溯源即权限长期目标怎么存、谁有权改，鉴权看消息来源↗07Compaction 双路径与 replaceGeneration压力触发与溢出恢复两条正交路径，以及用世代号证明「压缩确实发生过」才允许重试↗08Token 计量：决策用重放，展示用投影两套计量各干各的，压缩决策从不信 UI 上那个数↗09Spill：工具输出太大怎么办超限输出落盘存档，给模型留一张取回凭证↗10会话检索与跨会话引用旧会话是可检索的资料库，引用还能带出处↗11工具执行流水线：三段瀑布与单调 Guardpre-execute 到 post-execute 的三段管线，Guard 只能收紧不能放行↗12工具输出契约：值与展示分离同一个结果，模型看的和人看的可以不一样↗13文件编辑的工程学：先读后写read / edit / write 三件套，没读过的文件不许改↗14DSH 独有的工具面：terminal / lsp / jobs别家没有的几个工具各解决什么问题↗15审批与权限：两个旋钮，一个下拉框沙箱模式和审批策略是两个独立旋钮，预设只是常用组合↗16沙箱：从 seatbelt 到执行世界ctx.fs 和 ctx.subprocess 同享一个路径命名空间，执行环境可以整体换掉↗17Code Mode：一段代码顶多轮工具调用官宣叫 PTC，源码叫 code mode：worker 沙箱的隔离、通信协议与双重记账↗18Subagent 是一个 seam：从进程内到委派 Claude Code子 Agent 是能力接缝，进程内、远程、别家产品都能接↗19workflow / schedule / plan / todo：编排原语的取舍四种编排原语各管什么，为什么没做成一个大而全↗20Skill、Preset 与自我修改cordis_define 让 Agent 在运行时改写自己的运行时↗21MCP 与 Extensions：外部工具接入的两条路桥接生态标准与原生扩展怎么分工↗22LLM 适配层：单次尝试、显式重试、双流持久推理流与正文流分开存，重试是显式事件↗23测试一个非确定性系统确定性回放、性质测试、专门骗 LLM 客户端的故障服务器↗24持久化治理：版本、fork 边界与拒绝解读日志格式怎么演进，分叉边界怎么定，读不懂的数据宁可拒绝↗25凭据、设置、存储与遥测不起眼但全是坑：凭据每次现取、配置不落盘↗26多入口与 Typert：一个内核，五张面孔Web、headless、ACP、SDK、HTTP 共享同一个内核↗27Agent Notes 与 AGENTS.md：用 AI 开发 AI 的规训四状态设计笔记和给 AI 看的编码规范，团队立刻能抄↗28KV Cache 是接口prompt 前缀稳定性当成兼容性承诺来维护↗29终章：五种工程观，我们该抄什么五家 harness 设计哲学总表，附最小可抄清单和体量陷阱清单↗