源码版本 47f943859bef60e4160492346772ded9b24f765a

深入浅出 DeepSeek Harness

从一次回车到完整 Agent 平台

沿 DeepSeek Harness 官方仓库的固定 commit，从你在终端敲下 dsh 或在浏览器按下回车讲起，追踪消息怎样穿过 Inbox 进入 Agent Loop，事件日志怎样同时支撑模型上下文、持久化与界面投影，并继续拆解工具治理、Goal、多 Agent、Cordis、MCP、SDK、安全与验证体系。

开始阅读查看源码

查阅索引

!!js表达式: cordis.yml 怎样声明可替换的组合
.dsh directory auto-discovery: Repository Plugin 和 Self-modification
参数校验: 工具参数校验与并行执行池
分层注册域 (ScopedLayers): global / ancestor / own: 工具调度器与注册域
滚动并行池: 工具参数校验与并行执行池
模型顺序提交保证: 工具参数校验与并行执行池
取消语义: ABORTED vs ABORTED_BEFORE_DISPATCH: 工具调度器与注册域
三层环境加载与 bootstrap-only 拒绝: 从敲下 dsh 到补丁栈组装完成
五层补丁栈叠合顺序: 从敲下 dsh 到补丁栈组装完成
五层patch叠加: cordis.yml 怎样声明可替换的组合
字节预算 reserve 策略: 结果太大了：Spill、截断和外溢
abort draining: 并行工具调用：顺序和屏障
AbortController per phase: turn/start 之前：谁有权开始新一轮 Retry、Abort 与 turn 结账
AbortController per turn: Inbox 双队列：消息不是直接进模型的
ACP harness: Mock LLM 和 Snapshot 测试
Activation disposal: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
admitWaking: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
Agent identity: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
Agent Preset: Agent Preset：给单个会话换一套运行时
agent-plane composition: Agent Preset：给单个会话换一套运行时
AgentLoop: Agent、Session 和那个共用的身份证
AgentRegistry: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路 Agent、Session 和那个共用的身份证
ApiProxy: 为什么 Web 新建会话不是 CLI 的前端按钮 ApiProxy 与 SDK：Web 的控制面和客户端协议
append vs replacement: 历史从事件日志重建，不是从聊天界面
append-only log: append-only Session 与 Event 信封
append-origin events: Conversation UI：消费事件但不冒充事实源
assistant/chunk event logging: LLM Service、流式 chunk 与 BlockAssembler
AsyncLocalStorage: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
backpressure: JSON-RPC Server：长期进程的暴露方式
best-effort flush 不阻塞: 收束：Cancel、Dispose 和多 Agent 清理
BlockAssembler: 流式响应：chunk 怎样变成消息
BlockAssembler incremental assembly: LLM Service、流式 chunk 与 BlockAssembler
blockedReason policy: Phase、Revision、Round——三道演化闸门
boot() 的两阶段错误处理: 从敲下 dsh 到补丁栈组装完成
cancel 四类原因: Retry、Abort 与 turn 结账
Cancel vs Dispose 方向相反: 收束：Cancel、Dispose 和多 Agent 清理
canonical value 与 model-facing content 区分: 结果太大了：Spill、截断和外溢
Capability Seam 三角色架构: Capability Seam 与 cordis.yml 组合
catalog generation: Invariant：每个包都有自己的守卫
causal chain: append-only Session 与 Event 信封
child-first disposal: Subagent 出生与 lineage 管理
child-first disposal ordering: 收束：Cancel、Dispose 和多 Agent 清理
ChildLock: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
chunk event persistence: 流式响应：chunk 怎样变成消息
CI gate: Invariant：每个包都有自己的守卫
claim consumption: Inbox 双队列：消息不是直接进模型的
CLI 分发器 vs 主程序: 从敲下 dsh 到补丁栈组装完成
Client Runtime: 为什么 Web 新建会话不是 CLI 的前端按钮
cold resume: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
compaction replace: 历史从事件日志重建，不是从聊天界面
Compaction two-phase: Resume、Fork、Compaction——上下文改写术
companion plugin: Invariant：每个包都有自己的守卫
complete section 替换语义: System Prompt 四层组装
composeFrom子agent继承: Agent Preset：给单个会话换一套运行时
compositionStamp generation轮转: Agent Preset：给单个会话换一套运行时
CONFIGURED_AGENT_IDENTITIES_KEY: Agent、Session 和那个共用的身份证
connection management: TypeScript 和 Python SDK 共享一套协议
connection supervisor: MCP 工具注册与 Repository Plugin
Context Proxy: Cordis：不是依赖注入，是生命周期状态机
context-overflow recovery: Resume、Fork、Compaction——上下文改写术
contextFold: 投影（Projection）：同一份日志长出不同状态
contexts 渲染为 user-role 消息: System Prompt 四层组装
contiguous seq: Event Envelope：每个事件必须带的身份证
continuable subagent: Subagent 出生与 lineage 管理
control plane: ApiProxy 与 SDK：Web 的控制面和客户端协议
Conversation UI: Conversation UI：消费事件但不冒充事实源
ConversationNodeAssembler: Conversation UI：消费事件但不冒充事实源
Cordis: Cordis：不是依赖注入，是生命周期状态机
Cordis dynamic plugins: Repository Plugin 和 Self-modification
cordis:group isolate realm: cordis.yml 怎样声明可替换的组合
cordis.yml 每次启动覆写的原因: 从敲下 dsh 到补丁栈组装完成
cordis.yml 声明式组合: Capability Seam 与 cordis.yml 组合
cordis.yml root空数组: cordis.yml 怎样声明可替换的组合
CreateAgentOptions: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
credential redaction: 凭证隔离、Telemetry 与 Mock 测试
deepFreeze: 投影（Projection）：同一份日志长出不同状态
defense in depth: 安全分层：Trust、Permission、Sandbox、Network
delegation depth: Subagent 出生与 lineage 管理
delegationDepth resume survival: Resume、Fork、Compaction——上下文改写术
delta-only protocol tolerance: 流式响应：chunk 怎样变成消息
dependency closure: Invariant：每个包都有自己的守卫
derivedGeneration: 投影（Projection）：同一份日志长出不同状态
deriveMessages: 历史从事件日志重建，不是从聊天界面 Surface 投影：模型看到的历史不等于你看到的
detached checkout: 从一个 commit 到下一版：这本书怎样更新
detached process-group tree: Bash、Subprocess 和 PTY：各管哪段生命周期
disabled 互斥平台切换: Capability Seam 与 cordis.yml 组合
discriminated union: Event Envelope：每个事件必须带的身份证
disposal memoization 幂等: 收束：Cancel、Dispose 和多 Agent 清理
doc drift: 从一个 commit 到下一版：这本书怎样更新
doc-sync gate: 从一个 commit 到下一版：这本书怎样更新
docs drift: Invariant：每个包都有自己的守卫
domain projection: Conversation UI：消费事件但不冒充事实源
drain to quiescence: Retry、Abort 与 turn 结账
drainDescendants 范围隔离: 收束：Cancel、Dispose 和多 Agent 清理
dsh web alias: 为什么 Web 新建会话不是 CLI 的前端按钮
durable storage: Telemetry 不能反过来定义会话
durable-before-wait: Retry、Abort 与 turn 结账
effect Scope cleanup: cordis.yml 怎样声明可替换的组合
embedded runtime: TypeScript 和 Python SDK 共享一套协议
empty message null: 历史从事件日志重建，不是从聊天界面
enter reject decision: turn/start 之前：谁有权开始新一轮
EntryOptions: cordis.yml 怎样声明可替换的组合
epoch: Cordis：不是依赖注入，是生命周期状态机
error 结构化: Retry、Abort 与 turn 结账
event envelope: append-only Session 与 Event 信封
event lineage: Trajectory、Query 和 Replay
event mux stream: ApiProxy 与 SDK：Web 的控制面和客户端协议
event type system: Event Envelope：每个事件必须带的身份证
event-sourced goal: Goal 为什么是事件流而不是字段
event-sourced UI: Conversation UI：消费事件但不冒充事实源
evidence levels: 从一个 commit 到下一版：这本书怎样更新
evidence refresh: 从一个 commit 到下一版：这本书怎样更新
exclusive barriers: 并行工具调用：顺序和屏障
execution groups: 并行工具调用：顺序和屏障
executionMode 分类: 工具参数校验与并行执行池
exit_plan_mode user approval gate: Plan、Todo、Schedule——Goal 的三个邻居
fail-closed: 安全分层：Trust、Permission、Sandbox、Network
fail-closed classification: 工具注册和作用域：谁能看到什么工具并行工具调用：顺序和屏障
feedback: Telemetry 不能反过来定义会话
fetch carrier: ApiProxy 与 SDK：Web 的控制面和客户端协议
Fiber: Cordis：不是依赖注入，是生命周期状态机
Fiber dispose/reload: Repository Plugin 和 Self-modification
finally turn/end 保证: Retry、Abort 与 turn 结账
finish reason default: 流式响应：chunk 怎样变成消息
firstLiveSeq boundary: Resume、Fork、Compaction——上下文改写术
five-dimension comparison: 从一个 commit 到下一版：这本书怎样更新
fixed commit: 从一个 commit 到下一版：这本书怎样更新
fork boundary validation: Resume、Fork、Compaction——上下文改写术
Fork prefix seed: Resume、Fork、Compaction——上下文改写术
four evidence types: 从一个 commit 到下一版：这本书怎样更新
four-quadrant RPC model: ApiProxy 与 SDK：Web 的控制面和客户端协议
freezeRestoredObject iterative freeze: Resume、Fork、Compaction——上下文改写术
FTS: Trajectory、Query 和 Replay
generator effect rollback: Agent、Session 和那个共用的身份证
GoalActivation process-local: Goal 为什么是事件流而不是字段 Phase、Revision、Round——三道演化闸门
GoalChangeMeta: Goal 为什么是事件流而不是字段
GoalFoldState: Goal 为什么是事件流而不是字段
GoalPhase finite state machine: Goal 为什么是事件流而不是字段
GoalPhase state machine: Phase、Revision、Round——三道演化闸门
GoalProjection: 投影（Projection）：同一份日志长出不同状态
graceful shutdown: JSON-RPC Server：长期进程的暴露方式
HarnessClient: ApiProxy 与 SDK：Web 的控制面和客户端协议
HarnessSdkJsonRpcServer: Headless CLI 与 JSON-RPC Server——两种产品面 ApiProxy 与 SDK：Web 的控制面和客户端协议
head-of-line blocking: 并行工具调用：顺序和屏障
head-tail 50/50 split 预览: 结果太大了：Spill、截断和外溢
headerFold: 投影（Projection）：同一份日志长出不同状态
Headless CLI: Headless CLI 与 JSON-RPC Server——两种产品面
Headless entry: 为什么 Web 新建会话不是 CLI 的前端按钮
Headless startup: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
headless-runner: Headless CLI 与 JSON-RPC Server——两种产品面
higher-seq-wins: Conversation UI：消费事件但不冒充事实源
HMR effect scope undo: Repository Plugin 和 Self-modification
HMR Fiber dispose/reload: cordis.yml 怎样声明可替换的组合
Host control plane: 为什么 Web 新建会话不是 CLI 的前端按钮
hot reload: Cordis：不是依赖注入，是生命周期状态机
HTTP/WebSocket bridge: 为什么 Web 新建会话不是 CLI 的前端按钮
id-targeted patch: cordis.yml 怎样声明可替换的组合
idle maintenance running: turn/start 之前：谁有权开始新一轮
ignorable marker: append-only Session 与 Event 信封 Event Envelope：每个事件必须带的身份证
Inbox dual-queue: Inbox 双队列：消息不是直接进模型的
incremental assembly: 流式响应：chunk 怎样变成消息
incremental fold: 投影（Projection）：同一份日志长出不同状态
incremental projection: 历史从事件日志重建，不是从聊天界面
inherited tools: 工具注册和作用域：谁能看到什么工具
initiator scope 级联: 收束：Cancel、Dispose 和多 Agent 清理
InitiatorScope: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
inject declaration: Cordis：不是依赖注入，是生命周期状态机
insert patch: cordis.yml 怎样声明可替换的组合
invariant: Invariant：每个包都有自己的守卫
invariant checking: Mock LLM 和 Snapshot 测试
isConcurrencySafe: 工具注册和作用域：谁能看到什么工具工具参数校验与并行执行池
isolate 服务隔离: Capability Seam 与 cordis.yml 组合
isolate realm强制: Agent Preset：给单个会话换一套运行时
jitter 对称抖动: Retry、Abort 与 turn 结账
JSON Schema 编译: 工具参数校验与并行执行池
JSON-RPC: ApiProxy 与 SDK：Web 的控制面和客户端协议
JSON-RPC contract: TypeScript 和 Python SDK 共享一套协议
JSON-RPC Server: Headless CLI 与 JSON-RPC Server——两种产品面 JSON-RPC Server：长期进程的暴露方式
keepInbox interrupt 语义: 收束：Cancel、Dispose 和多 Agent 清理
lineage tracking: Subagent 出生与 lineage 管理
LLM mock: Mock LLM 和 Snapshot 测试
llm-retry 指数退避: Retry、Abort 与 turn 结账
llm/stream waterfall interception: LLM Service、流式 chunk 与 BlockAssembler
LlmRuntime adapter registry: LLM Service、流式 chunk 与 BlockAssembler
long-lived server: Headless CLI 与 JSON-RPC Server——两种产品面
long-running process: JSON-RPC Server：长期进程的暴露方式
markAgentLoopRequest deep-freeze: LLM Service、流式 chunk 与 BlockAssembler
max-tokens 粘滞性: Retry、Abort 与 turn 结账
max-tokens tool-call discard: 流式响应：chunk 怎样变成消息
maxParallelToolCalls 滚动并发池: 工具调度器与注册域
MCP client bridge plugin: MCP 工具注册与 Repository Plugin
minimal closure: 从一个 commit 到下一版：这本书怎样更新
MockLlm server: 凭证隔离、Telemetry 与 Mock 测试
model-visible history: Surface 投影：模型看到的历史不等于你看到的
multi-session: JSON-RPC Server：长期进程的暴露方式
multiplicative composition: 安全分层：Trust、Permission、Sandbox、Network
namespace prefixing: MCP 工具注册与 Repository Plugin
network hygiene: 安全分层：Trust、Permission、Sandbox、Network
next-step queue: Inbox 双队列：消息不是直接进模型的
next-turn queue: Inbox 双队列：消息不是直接进模型的
normal 模式与 always 模式: Retry、Abort 与 turn 结账
normalizeApiKey: 凭证隔离、Telemetry 与 Mock 测试
notification subscription: TypeScript 和 Python SDK 共享一套协议
notifySettlement: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
one-shot agent: Headless CLI 与 JSON-RPC Server——两种产品面
one-shot subagent: Subagent 出生与 lineage 管理
one-shot vs long-lived: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
OPEN_TURN rejection: Resume、Fork、Compaction——上下文改写术
OpenTelemetry backend: 凭证隔离、Telemetry 与 Mock 测试
optimistic concurrency: Telemetry 不能反过来定义会话
output collection with spill: Bash、Subprocess 和 PTY：各管哪段生命周期
own tools exemption: 工具注册和作用域：谁能看到什么工具
parallel vs exclusive: 工具参数校验与并行执行池
parent mailbox: Subagent 出生与 lineage 管理
Parent Mailbox: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
parent-child tree: Subagent 出生与 lineage 管理
parentSession lineage: Resume、Fork、Compaction——上下文改写术
PartialBlock state machine: 流式响应：chunk 怎样变成消息
pass-through args 设计: 从敲下 dsh 到补丁栈组装完成
permission gate: 安全分层：Trust、Permission、Sandbox、Network
persona complete section: Agent Preset：给单个会话换一套运行时
phase state machine: Inbox 双队列：消息不是直接进模型的
phase transition validation: Phase、Revision、Round——三道演化闸门
Plan Mode collaboration state: Plan、Todo、Schedule——Goal 的三个邻居
plan/mode event last-wins fold: Plan、Todo、Schedule——Goal 的三个邻居
pre/around/post 瀑布管线与 monotonic guard: 工具调度器与注册域
PreparedLlmCall one-shot dispatch: LLM Service、流式 chunk 与 BlockAssembler
preset discovery: Agent Preset：给单个会话换一套运行时
PresetRoot trust分级: Agent Preset：给单个会话换一套运行时
PresetTree Include子类: Agent Preset：给单个会话换一套运行时
preStep waterfall: Inbox 双队列：消息不是直接进模型的 turn/start 之前：谁有权开始新一轮
product surface: Headless CLI 与 JSON-RPC Server——两种产品面
Profile 目录结构与自动初始化: 从敲下 dsh 到补丁栈组装完成
projection caching: Surface 投影：模型看到的历史不等于你看到的
projection last-wins: Goal 为什么是事件流而不是字段
Projection pattern: 投影（Projection）：同一份日志长出不同状态
ProjectionValueStore: Conversation UI：消费事件但不冒充事实源
PromptAssembly 四层结构: System Prompt 四层组装
protocol framing: Headless CLI 与 JSON-RPC Server——两种产品面
provider retryAfterMs: Retry、Abort 与 turn 结账
PTY terminal-bash backend: Bash、Subprocess 和 PTY：各管哪段生命周期
Python SDK: TypeScript 和 Python SDK 共享一套协议
ReactLoopAgent phase: turn/start 之前：谁有权开始新一轮
read 工具 anti-loop 跳过规则: 结果太大了：Spill、截断和外溢
recompose blank-session切换: Agent Preset：给单个会话换一套运行时
reconnect recovery: Conversation UI：消费事件但不冒充事实源
record/replay: Mock LLM 和 Snapshot 测试
ReflectService: Cordis：不是依赖注入，是生命周期状态机
registerAdapter atomic replace: LLM Service、流式 chunk 与 BlockAssembler
releaseOwnership ordering: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
replaceGeneration: Surface 投影：模型看到的历史不等于你看到的
replaceGeneration counter: Resume、Fork、Compaction——上下文改写术
replay: Trajectory、Query 和 Replay
reportFrom: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
Repository Plugin: Repository Plugin 和 Self-modification
Repository Plugin self-modification: MCP 工具注册与 Repository Plugin
resolveSessionPreset resume恢复: Agent Preset：给单个会话换一套运行时
Resume ownership transfer: Resume、Fork、Compaction——上下文改写术
Revision CAS optimistic lock: Phase、Revision、Round——三道演化闸门
role secret: 凭证隔离、Telemetry 与 Mock 测试
Round counter: Phase、Revision、Round——三道演化闸门
RpcMethodMap: ApiProxy 与 SDK：Web 的控制面和客户端协议
run_code internal scheduler: 并行工具调用：顺序和屏障
run_code lazy load: 工具注册和作用域：谁能看到什么工具
RuntimeContextProjection: 投影（Projection）：同一份日志长出不同状态
sandbox confinement: 安全分层：Trust、Permission、Sandbox、Network
schedule after/at/every rules: Plan、Todo、Schedule——Goal 的三个邻居
schedule dispatch framing injection: Plan、Todo、Schedule——Goal 的三个邻居
ScheduleRuntime durable timer: Plan、Todo、Schedule——Goal 的三个邻居
scope parent binding: Agent Preset：给单个会话换一套运行时
ScopedLayers: 工具注册和作用域：谁能看到什么工具 Skills：发现、装载和上下文注入
ScopedLayers per-session: Repository Plugin 和 Self-modification
SDK: ApiProxy 与 SDK：Web 的控制面和客户端协议
SDK client: TypeScript 和 Python SDK 共享一套协议
SDK protocol: JSON-RPC Server：长期进程的暴露方式
sections order 数值约定: System Prompt 四层组装
seedLength durable boundary: Resume、Fork、Compaction——上下文改写术
self-modification boundary: Repository Plugin 和 Self-modification
sendWaking: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
seq contiguity: append-only Session 与 Event 信封
Service Definition vs Provider vs Consumer: Capability Seam 与 cordis.yml 组合
service resolution: Cordis：不是依赖注入，是生命周期状态机
Session identity: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
session lifecycle: JSON-RPC Server：长期进程的暴露方式
session management: ApiProxy 与 SDK：Web 的控制面和客户端协议
session multiplexing: Headless CLI 与 JSON-RPC Server——两种产品面
session query: Trajectory、Query 和 Replay
session telemetry: 凭证隔离、Telemetry 与 Mock 测试
session tree: TypeScript 和 Python SDK 共享一套协议
session.event notification: JSON-RPC Server：长期进程的暴露方式
session/end-seed: Agent、Session 和那个共用的身份证
session/end-seed marker: Resume、Fork、Compaction——上下文改写术
session/prompt: JSON-RPC Server：长期进程的暴露方式
SessionEvent envelope: Event Envelope：每个事件必须带的身份证
SessionHeader: Agent、Session 和那个共用的身份证
SessionId: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
SessionPreparation: Agent、Session 和那个共用的身份证
SessionPreparation disposable: Resume、Fork、Compaction——上下文改写术
SessionStore: Agent、Session 和那个共用的身份证
settlement notice: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
shadowed nodes: Surface 投影：模型看到的历史不等于你看到的
shared protocol: TypeScript 和 Python SDK 共享一套协议
shell stream-level 独立截断: 结果太大了：Spill、截断和外溢
ShellExecutor capability seam: Bash、Subprocess 和 PTY：各管哪段生命周期
side effect 不回滚: 收束：Cancel、Dispose 和多 Agent 清理
sidecar: Telemetry 不能反过来定义会话
SIGTERM-grace-SIGKILL escalation: Bash、Subprocess 和 PTY：各管哪段生命周期
skill-filesystem: Skills：发现、装载和上下文注入
skill-filesystem project roots: Repository Plugin 和 Self-modification
SkillCatalog: Skills：发现、装载和上下文注入
SkillInvocationPolicy: Skills：发现、装载和上下文注入
SkillProvider: Skills：发现、装载和上下文注入
SkillRegistry: Skills：发现、装载和上下文注入
snapshot fixture: 凭证隔离、Telemetry 与 Mock 测试
snapshot testing: Mock LLM 和 Snapshot 测试
source verification: 从一个 commit 到下一版：这本书怎样更新
sourceEventSeqs: append-only Session 与 Event 信封
sourceEventSeqs provenance: 流式响应：chunk 怎样变成消息
spill-policy 插件架构: 结果太大了：Spill、截断和外溢
SpillStore best-effort 存储语义: 结果太大了：Spill、截断和外溢
splice durable append: Inbox 双队列：消息不是直接进模型的
standing mount: Agent Preset：给单个会话换一套运行时
standing mount generation: Repository Plugin 和 Self-modification
state projection: 为什么 Web 新建会话不是 CLI 的前端按钮 Conversation UI：消费事件但不冒充事实源
stdio transport: JSON-RPC Server：长期进程的暴露方式 ApiProxy 与 SDK：Web 的控制面和客户端协议
straggler delta rejection: 流式响应：chunk 怎样变成消息
StreamChunk protocol: LLM Service、流式 chunk 与 BlockAssembler 流式响应：chunk 怎样变成消息
strict variable interpolation: System Prompt 四层组装
subagent-settled source: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
SubagentDepthError: Subagent 出生与 lineage 管理
SubagentReportDelivery: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
SubprocessRuntime process primitive: Bash、Subprocess 和 PTY：各管哪段生命周期
surface eligible events: 历史从事件日志重建，不是从聊天界面
surface metadata: Event Envelope：每个事件必须带的身份证
surface projection: append-only Session 与 Event 信封
Surface projection: Surface 投影：模型看到的历史不等于你看到的
Surface replace operation: Resume、Fork、Compaction——上下文改写术
SurfaceFoldResult: Surface 投影：模型看到的历史不等于你看到的
surfaceOp: Surface 投影：模型看到的历史不等于你看到的
SurfaceOp: append-only Session 与 Event 信封
surfaceOp marker: 历史从事件日志重建，不是从聊天界面
syncTools atomic swap: MCP 工具注册与 Repository Plugin
synthetic error result: Retry、Abort 与 turn 结账
synthetic errors: 并行工具调用：顺序和屏障
telemetry: Telemetry 不能反过来定义会话
Todo whole-list replacement: Plan、Todo、Schedule——Goal 的三个邻居
todo_write allowParallelInProgress: Plan、Todo、Schedule——Goal 的三个邻居
tombstone: Goal 为什么是事件流而不是字段
tool presentation view: Conversation UI：消费事件但不冒充事实源
tool-bash agent interface: Bash、Subprocess 和 PTY：各管哪段生命周期
tool-pairing balance: Resume、Fork、Compaction——上下文改写术
tool-skill: Skills：发现、装载和上下文注入
ToolArgsError: 工具参数校验与并行执行池
ToolExecutionMode: parallel vs exclusive 的 fail-closed 分类: 工具调度器与注册域
ToolPresentationMode: native / code / both 三种呈现: 工具调度器与注册域
ToolRestriction: 工具注册和作用域：谁能看到什么工具
ToolRestriction: allow/deny 交集过滤: 工具调度器与注册域
ToolRuntime: 注册表 + 执行管线 + 调度器三合一: 工具调度器与注册域
tools 排序与 toolOrder: System Prompt 四层组装
top-down cancellation propagation: 收束：Cancel、Dispose 和多 Agent 清理
trajectory tracing: Trajectory、Query 和 Replay
transcript vs model surface: 历史从事件日志重建，不是从聊天界面
transport layer (stdio/streamable-http): MCP 工具注册与 Repository Plugin
transport peer: Headless CLI 与 JSON-RPC Server——两种产品面
trust boundary: 安全分层：Trust、Permission、Sandbox、Network
turn boundary: Inbox 双队列：消息不是直接进模型的
turn start append order: turn/start 之前：谁有权开始新一轮
two-arm 设计（模型面与 durable log）: 结果太大了：Spill、截断和外溢
TypeScript SDK: TypeScript 和 Python SDK 共享一套协议
variables 近覆盖远: System Prompt 四层组装
verify-cordis-config 静态验证: Capability Seam 与 cordis.yml 组合
wakeDriver: Inbox 双队列：消息不是直接进模型的 turn/start 之前：谁有权开始新一轮
wakeup vs quiet: Parent Mailbox：父 Agent 怎样接住子 Agent 的结果
wakingAfterAbort: Inbox 双队列：消息不是直接进模型的
waterfall 拦截: System Prompt 四层组装
waterfall redaction: 凭证隔离、Telemetry 与 Mock 测试
Web entry: 为什么 Web 新建会话不是 CLI 的前端按钮
Web startup: Agent 和 Session 共用一个身份证——但 Headless 和 Web 走的不是同一条路
web-app bundle: 为什么 Web 新建会话不是 CLI 的前端按钮
whole-value snapshot: Goal 为什么是事件流而不是字段
workspace-level capabilities: Repository Plugin 和 Self-modification