SOURCE-ALIGNED ARCHITECTURE · 47f9438

一张地图看懂 DeepSeek Harness

这不是按目录复述文件,而是把启动时组合、运行时主干、能力替换、控制接缝、事实存储与客户端表面放到同一张因果地图里。

49 package families3 event domains6 reasoning planes1 append-only truth
六平面架构地图 SOURCE ALIGNED
Profile · Bundle · Patch · Cordis

组合平面

决定哪些插件存在、如何分层以及卸载时如何回收。

bootbundlepresetextensions
EVENT SEMANTICS

先问“属于哪个事件域”,再问“发生了什么”

把实时状态和持久事实混在一起,是读 Harness 最常见也最危险的误区。

01session/event

Durable truth

可排序、可回放、模型可见的事实;持久化 transcript 和投影都从这里生长。

02agent/*

Live runtime

状态、流式增量、steer/cancel 等运行控制;观察当前执行但不冒充历史真源。

03capability events

Open seams

工具、审批、提示词、压缩等子系统公开的可组合接缝,插件在这里改写或拒绝。

TURN FLOW · INTERACTIVE TRACE

一条用户输入,不只产生一次模型调用

Turn 是需要结清的工作单元;Step 是一次 LLM 请求。工具调用会留下“债务”,只有结果写回并继续推理,Turn 才能结束。

深读 Turn / Step
● ● ●agent-turn.trace
01
认领一条输入

同一时刻只有一个 Turn 拥有消费权。

组合,不继承

Profile、Bundle、Patch 和插件作用域共同决定产品形态。

契约,不穿透

消费者依赖 Service Definition,不直接 import Provider。

事件,不镜像

客户端从 SessionEvent 投影,而不维护第二套权威状态。

守卫,不旁路

工具的拒绝、取消和失败都必须沿同一管线结算。

Learn DeepSeek Harness

独立教学项目。解释力来自源码,判断边界以官方仓库为准。