Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

术语表

按主题整理。每条给出最短定义和对应的源码位置;读教程遇到不熟的词,先回这里查。

运行时结构

术语含义相关位置
Harness模型循环之外的全部系统:授权、执行、持久化、恢复、协议与 UI第 0 章
Session可恢复的长期会话,包含历史、配置和多个 turnsrc/runtime/session.rs
Turn一次用户输入到最终回答、失败、取消或暂停src/runtime/state.rs
Step一次模型请求及其结果处理,一个 turn 可以包含多个 stepsrc/runtime/agent_loop.rs
ToolExecution一个具体工具调用实例,有独立 ID、状态和执行策略src/runtime/state.rs
ContextSnapshot拥有所有权、不可变的模型输入窗口,负责预算截断src/runtime/context.rs
事实(fact)已经发生的事情,只追加、不修改,进入 event logsrc/durable/event.rs
派生状态(derived state)reducer 从事实计算出来的当前视图src/durable/reducer.rs

模型与 Provider

术语含义相关位置
Provider把模型服务差异翻译成 runtime 能理解的请求和响应src/model/provider.rs
ModelRequest一次模型请求的拥有所有权快照(历史、工具、continuation)src/model/provider.rs
ModelResponse归一化后的模型结果:文本、单个或多个工具调用src/model/provider.rs
MockProvider按脚本返回确定性响应的 provider,也是核心设计工具src/model/mock.rs
ProviderContinuationprovider 自己维护的续传数据,重启后仍可继续响应链src/runtime/state.rs
Wire style线上格式;项目同时支持 Responses 与 Chat Completionssrc/model/openai_protocol.rs

工具、策略与执行

术语含义相关位置
Tool / ToolSpec / ToolContext工具声明、给模型的 schema、执行时的最小能力集src/tools/spec.rs
RiskClass工具风险等级:Read / Write / Executesrc/tools/spec.rs
PolicyDecision授权决策:Allow / Ask / Denysrc/policy/mod.rs
fail-closed无法判断风险时默认拒绝,而不是默认放行src/policy/mod.rs
Executor真正访问文件与进程的能力层src/executor/trait.rs
LocalExecutor本地文件与进程实现,未来可替换为 sandbox 或远程src/executor/local.rs
进程组(process group)取消/超时时按进程组清理,避免遗留子孙进程src/executor/process.rs
三层输出上限分别限制 stdout、stderr 和合计输出src/executor/process.rs
OutcomeUnknown执行可能已产生副作用,但日志没有可靠结果src/runtime/state.rs

持久化与恢复

术语含义相关位置
Event / EventPayload一条事实及其内容src/durable/event.rs
seq / event_id / schema_version会话内序号、事件自身 ID、事件格式版本src/durable/event.rs
Reducer确定性函数 reduce(state, event),不接受外部输入src/durable/reducer.rs
append 事务先验证、再持久化、后提交状态src/runtime/agent_loop.rs
Checkpoint加速重放的派生快照,不是事实来源src/durable/checkpoint.rs
RecoveryFinding恢复时对未完成工作的分类结果src/durable/recovery.rs
RecoveryPolicy每类 finding 的保守恢复建议(重试 / 查 hash / 人工决定)src/durable/recovery.rs

取消与并发

术语含义相关位置
CancellationToken随请求传播的取消信号,沿 turn → child → executor 传递src/runtime/agent_loop.rs
单写者 actor只有唯一写者能修改会话状态和追加事件src/runtime/session_actor.rs
SessionCommand发给 actor 的操作请求(StartTurn、CancelTurn…)src/runtime/session.rs
Steerturn 运行期间提交的新输入,按事实排队src/runtime/session_actor.rs
durable 输入队列排队输入先持久化再确认,崩溃后可恢复src/runtime/session_actor.rs
Scheduler组合多个 session 的任务生命周期,不复制会话状态src/scheduler/mod.rs

协议与 UI

术语含义相关位置
JSONL 协议stdin 请求、stdout 响应与事件、stderr 诊断,一行一个 JSONsrc/protocol/jsonl.rs
response vs notification带 id 的命令回复,与无 id 的事件通知,必须分别路由src/protocol/jsonl.rs
安全投影只向客户端暴露白名单字段,隐藏工具原始输入输出src/protocol/event_projection.rs
input_summary给审批界面看的工具输入短摘要src/protocol/event_projection.rs
Ink TUIui/ 下的 TypeScript 协议客户端,UI 只消费事件ui/src/client.ts

明确不做的事(非目标)

术语含义
exactly-once外部副作用不承诺恰好执行一次;宁可标记 OutcomeUnknown
排队输入取消队列中的输入不单独取消,要么等它开始,要么 abandon-turn
OS 级 sandbox路径检查不等于 sandbox;真实隔离是后续深度专题