A
Abort
请求停止正在进行的模型、工具或外部操作。它不回滚已经发生的副作用。
Agent
持有模型、消息、工具与队列，并运行 Agent Loop 的核心对象。
Agent Loop
模型生成、ToolCall、Tool 执行、ToolResult 回传与继续判断形成的循环。
Agent Run
一次用户任务触发的整体自动运行，可包含多个 Turn。
AgentSession
在 Agent 之上组合资源、Extension、Session 持久化、Retry、Compaction 和 Coding Tools 的运行时。
AgentSessionRuntime
拥有当前 AgentSession 和 CWD-bound Services，并负责 New/Resume/Fork/Replacement。
B
Branch
Session Tree 中从根到某个 Leaf 的一条路径。
Broker
宿主控制的最终工具执行服务，用权限规则重新验证 Canonical 动作。
C
Canonical Arguments
经过规范化后、可用于审批、哈希和最终执行比对的工具参数。
Capability
宿主签发的有限授权，通常绑定 Session、ToolCall、参数、过期时间和使用次数。
Compaction
用摘要与保留尾部替代较早活动上下文的机制，不删除 Session 历史 Entry。
Context
一次模型请求实际看到的 System Prompt、Messages、Tools 等输入。
Custom Entry
不自动进入模型上下文、但位于 Session Tree 中的自定义状态记录。
CWD
当前工作目录，也是许多 Settings、Resource 与 Tool 的作用域。
D
Details
ToolResult 中适合 UI/状态的结构化数据；区别于发给模型的 Content。
Diagnostics
资源、Runtime、模型回退、Session、RPC 或宿主产生的可操作诊断。
E
Entry
Session JSONL 中带稳定 ID 和 Parent 关系的一条记录。
EventBus
Extension 间的进程内事件通道；无持久化、Ack、Replay 和 Backpressure。
Extension
运行在 Pi 进程中的本地代码，通过 Factory 注册 Tool、Handler、Command、Provider 等能力。
Extension Factory
模块导出的初始化函数，接收 ExtensionAPI 并完成注册。
F
Fail Closed
安全组件失败时默认拒绝动作，而不是继续执行。
Faux Provider
测试使用的确定性模型替身，按脚本返回文本、ToolCall 或错误。
Follow-up
在当前 Run 原本要停止时注入并继续同一个 Agent Loop 的排队消息。
G
Generation
宿主为 Runtime/Worker 实例生成的代数，用于拒绝旧 Event；不是 Pi Event 原生字段。
H
Handled Input
在 Prompt Preflight 中被 Extension Command 或 Input Handler 处理、未启动普通 Agent Run 的输入。
I
Idempotency Key
让重复提交能被后端识别为同一业务操作的稳定键。
Indeterminate
操作可能已成功但确认丢失，当前无法判定最终结果的状态。
J
JSONL
每行一个 JSON Object 的记录格式。Pi RPC 和 Session 均使用换行分隔，但具体 Schema 不同。
L
Leaf
当前 Session Branch 的末端 Entry。
LLM Message
Provider 最终接受的消息格式；可能由 Agent Message 转换而来。
M
Message
User、Assistant 或 ToolResult 内容。普通 Agent Message 没有统一稳定 ID。
Model
描述 Provider、API、能力、上下文窗口和成本的模型元数据。
ModelRuntime
管理 Provider、Model、Auth 与动态刷新等运行时能力。
O
Operations Interface
Built-in Tool 把文件、Shell 等实际执行委托给本地、远程或 Sandbox 后端的接口。
P
Project Trust
决定是否加载项目级动态配置与资源的信任决策；不是 OS Sandbox。
Prompt Template
可展开为输入内容的资源；不同于完整 Skill 工作流。
Provider
把通用 Model/Message/Tool 请求映射到具体模型服务的实现与配置。
Provisional Item
桌面层从无 Entry ID 的 Live Message Event 建立、等待 Session Entry 对账的临时 UI 项。
R
ResourceLoader
发现、合并并诊断 Skills、Prompts、Extensions 等资源的组件。
RPC Mode
通过 stdin/stdout JSONL 控制独立 Pi Worker 的运行方式。
Run ID
桌面宿主用于关联一次运行的标识；不是所有 Pi Event 原生携带的字段。
S
Sandbox
由 OS、Container 或受控进程真正实施的文件、网络和进程权限限制。
Session
可持久化的 Agent 工作历史、Tree、配置变化与压缩记录集合。
SessionManager
读取、追加、导航和恢复 Session Entry Tree 的组件。
Skill
可发现、按需读取的专业工作方法，通常以 SKILL.md 为入口。
Snapshot Barrier
桌面 Rehydrate 时用 Snapshot Response 的本地序号划分已覆盖事件与待 Replay 事件的边界。
Steering
希望尽快影响当前运行、在下一个合适 LLM 边界送入的消息。
System Prompt
定义 Agent 角色、能力、环境与高层规则的模型上下文部分。
T
Thinking
Assistant Content 中与可见 Text 分离的推理内容/事件，能力依 Provider/Model 而异。
Tool
向模型声明 Schema、由 Runtime 执行并返回 ToolResult 的能力。
ToolCall
Assistant 生成的结构化工具调用，包含 ID、名称与参数。
ToolResult
回应 ToolCall 的消息，Content 可进入模型，Details 可服务 UI/状态。
Turn
一次模型调用以及随后属于该 Assistant Message 的 Tool 执行阶段。
U
UI Message Key
桌面层生成的消息渲染标识。Pi 普通 Message 不提供统一稳定 ID。
Usage
模型调用的 Token、缓存与成本相关统计，Streaming Estimate 与 Final Usage 应区分。
W
Worker
RPC 模式中运行 Pi AgentSession 的独立进程。