DeepSeek Harness:插件树与 Agent Turn 剖面
它不是‘核心 + 插件’的老结构。Profile 先选择产品外壳,patch 按顺序重写装配,Cordis 再把服务注入同一棵插件树;运行中的每次输入、模型流、工具结果和停止事件最终都落到一条可重建的日志。
同一仓库,五种产品入口
Developer Preview · MIT · Node 22.19+ / 24+
先读边,再读模块
绿色=组合与执行;蓝色=服务提供;紫色=模型与工具;琥珀=事件写入与回放。
PROFILE → HOME PATCH → --PATCH → PLUGIN TREE
后一层可覆盖前一层;最终结果仍是一棵按生命周期启动与回收的插件树。
01: profile base
→
02: home patch
03: --patch
04: plugin tree
可读,不可当成冻结接口
官方明确标注 Developer Preview;这里画的是当前文档契约,不是永久 API。
从配置装配到一次 Agent Turn
从装配器读到服务背板,再进入一次 Agent Turn。绿色表示启动路径,紫色表示运行路径,琥珀色回路把日志接回下一轮。可放大模块,或展开画布查看细节。
Profiles → Patch Stack
Profile 是产品装配单,不是主题皮肤;patch 按顺序叠加,最后产出可启动、可替换、可回收的插件树。
WEB: UI
HEADLESS: CLI
SDK: HOST
ACP: PROTO
L0 · BASE: profile plugins
L1 · HOME: user patch
L2 · CLI: optional --patch
BOOT RESULT: ordered plugin tree
ctx.* Service Seams
服务定义、provider 与 consumer 在 shared context 相遇。替换一个 provider,所有 consumer 得到同一实现。
CORDIS SHARED CONTEXT: definition → provider → consumer
ctx.agents: identity
ctx.agentLoop: steps
ctx.systemPrompt: assemble
ctx.llm: stream
ctx.tools: execute
ctx.sessions: append
LIFECYCLE EFFECTS: start · dispose · replace
Agent Loop + Session Log
一次输入会穿过准备、模型流和可选工具分支;所有消息与事件只追加,再由日志派生恢复、分叉和重放。
T0 · INBOX: input / webhook
T1 · PRE-STEP: session + prompt + schemas
T2 · LLM STREAM: assistant chunks
T3 · TOOL BRANCH: pre → execute → post
T4 · APPEND: message + result + event
DERIVED: resume · fork · replay · persistence · telemetry
EXECUTE: 装配 / 主执行
PROVIDE: 服务注入
MODEL / TOOL: 流与工具分支
EVENT: 追加 / 回放
五个入口,不是五套内核
横轴是五个官方 Profile;亮格表示它选择的产品表面,Shared runtime 则贯穿全部入口。
DSH profile surface matrix
web、headless、sdk、sdk-minimal 与 acp 的产品表面选择矩阵。
同一运行时的三圈结构
内环分成装配、服务与运行三域;外环继续展开 5 个 Profile、3 层 patch、6 条 service seam 与 5 个 turn phase。弧长是文档单元计数,不是代码行数。
DSH architecture hierarchy
DeepSeek Harness architecture hierarchy across composition, services and turn phases.
四个机制,各守一条边界
Profile 解决产品差异;patch 解决有序覆盖;Cordis 解决服务替换;append-only log 解决时间与恢复。四件事被拆开,才没有需要绕过插件系统的特权核心。
用 9 个检查点复述一次运行
这是事件顺序,不是包依赖。工具是否被调用会形成分支,但消息与结果最终都回到同一条 session log。
00: Inbox
01: Pre-step
02: Prompt
03: LLM
04: Stream
05: Tool?
06: Append
07: Next / Stop
08: Replayable
来源、版本状态与图形编码
资料截面冻结于 2026-08-31,来自 DeepSeek Harness 官方 README、Architecture 与 Development 文档。Profile 矩阵编码的是文档化产品表面;Sunburst 的弧长是文档单元计数,不代表代码量、调用量或复杂度。该项目处于 Developer Preview,接口和行为仍可能发生破坏性变化。