附录
B · 术语表
T3 Code 中容易混淆的领域、连接、Provider 和平台术语。
| 术语 | 含义 | 不等于 |
|---|
| Project | Server 认知的工作目录及项目设置、线程集合 | 必然是 Git repo |
| Thread | 用户长期工作/对话对象，包含消息、活动、turn 与 checkpoint | Provider session |
| Turn | 一次用户输入到 Agent 本轮结算的生命周期 | 单条 assistant message |
| Message | 用户/assistant 的长期对话内容，由 segment 组成 | Tool activity |
| Activity | 工具/命令/文件等可更新、可结算的运行记录 | 纯文本消息 |
| Command | 对领域状态的意图，交给 decider | 已发生的事实 |
| Domain event | 已提交、带 sequence 的领域事实 | 临时 WebSocket notification |
| Decider | (state, command) -> events/rejection 的纯函数 | 外部副作用执行器 |
| Projector | (state, event) -> state 的纯读取模型转换 | Provider adapter |
| Reactor | 观察已提交事件并执行 Provider/Git 等副作用 | 事务内 projector |
| Command receipt | 幂等键对应的 accepted/rejected 结果 | Provider 执行结果 |
| Read model | 用于决策/展示的当前投影 | 唯一持久事实源 |
| 术语 | 含义 |
|---|
| Provider type | Codex、Claude、Cursor、Grok 或 OpenCode 这一类集成 |
| Provider driver | 从配置 Schema 创建 instance adapter/snapshot/服务的工厂 |
| Provider instance | 某个已配置账号/home/executable 的稳定身份；同一 type 可多个 |
| Provider adapter | 编排层使用的统一 session/turn/approval/stream 接口 |
| Provider session | 外部 Agent 的运行会话，可被 thread 恢复/替换 |
| Canonical provider event | Adapter 对原生协议做第一层统一后的事件 |
| Runtime ingestion | 给 canonical event 补生命周期/关联、缓冲后 dispatch 领域命令 |
| Capability snapshot | Provider 安装、登录、模型/模式和可用能力的可展示状态 |
| ACP | Agent Client Protocol；Cursor/Grok 的共享协议底座 |
| App-server | Codex 暴露的双向 JSON-RPC 服务进程 |
| 术语 | 含义 |
|---|
| Execution environment | 一个稳定的 T3 Server/执行机器身份 |
| Endpoint | 当前可连接 URL/地址；可能变化 |
| Launch method | 本机、SSH、WSL 等启动 Server 的方式 |
| Access method | Direct、managed relay、Tailscale 等网络路径 |
| Catalog | 客户端保存的已知环境描述集合 |
| Registry | 拥有各环境 scope、supervisor、lease 与 cache 生命周期 |
| Lease | “当前仍有人需要该环境连接”的所有权引用 |
| Supervisor | 唯一决定连接 attempt、backoff、probe 与 wakeup 的状态机 |
| RPC session | 一次已建立 WebSocket + typed RPC client，不负责重试 |
| Snapshot | 客户端同步的状态基线，带 sequence/cursor |
| Gap replay | 快照后从 cursor 补发的有界事件窗口 |
| Pairing grant | 新设备一次性兑换环境授权的短期材料 |
| DPoP | 将 token 使用绑定到客户端密钥证明的机制 |
| WS ticket | 由已授权 HTTP 请求兑换、只用于 WebSocket upgrade 的短期票据 |
| Scope | 某 session 被允许调用的一组方法能力 |
| T3 Connect | 环境发现、配对、managed endpoint、活动通知等云控制面 |
| 术语 | 含义 |
|---|
| Checkpoint | 某 thread/turn 边界的 Git 可表示工作树快照 |
| Hidden ref | refs/t3/checkpoints/... 下指向 checkpoint commit 的内部引用 |
| Temporary index | 通过 GIT_INDEX_FILE 隔离的 Git index，不触碰用户暂存区 |
| Worktree | Git linked worktree，可让不同 thread 隔离文件修改 |
| PTY | 伪终端；Server 上的交互 shell 进程与字节流 |
| Preview session | 对发现端口或桌面浏览器 surface 的受控会话 |
| Resource attribution | 把进程 CPU/内存样本关联到 Provider session/thread |
| IPC | Electron main 与 renderer 间的特权桥；不替代业务 RPC |
| 表述 | 真正含义 |
|---|
| RPC returned | 传输收到 typed result；不必然表示外部动作完成 |
| Command accepted | 领域意图与 receipt 已提交 |
| Turn requested | Reactor 应开始/恢复 Provider 并发送输入 |
| Provider accepted input | Adapter 调用成功；仍可能在运行中失败 |
| Turn completed | Runtime event 已回流并由 projector 结算 |
| Session idle | Provider session 当前可接受下一轮，不代表 thread 永久结束 |
| Checkpoint completed | Git 快照成功；不证明所有非 Git 副作用可回退 |
| Client connected | RPC session 可用；snapshot/subscription 仍可能在同步 |
客户端对某个 Execution Environment 租用一条由 Supervisor 管理的 RPC 连接；用户在 Thread 中发出 Command，
Server 的 Decider 产生并提交 Domain Events，Projector 更新可读状态，Reactor 通过指定 Provider Instance 的
Adapter 执行副作用，Runtime Ingestion 再把结果变成新命令，最终所有设备用 Snapshot + bounded gap replay 收敛。