术语表

这些术语的含义在 T3 Code 各处都会用到。架构和生命周期上的约束写在概览里，不写在这些定义中。

工作区与对话

术语	含义
环境（environment）	一个正在运行的服务器，以及由它拥有的机器、凭据、工作区访问权限和状态。
客户端（client）	连接到某个环境的 Web、桌面或移动界面。桌面应用也可以托管一台服务器。
项目（project）	一条以某个目录为根、属于该环境本地的工作区记录。
工作区根目录	该项目在这个环境上的基础文件系统目录。
工作树（worktree）	对话线程可以改用的另一份 Git 检出，用来代替项目的主检出。
对话线程（thread）	一个项目上持久保存的对话与工作历史。提供方（provider）进程退出之后，它仍然存在。
回合（turn）	一次从用户到智能体的循环，即一次 V2 运行。提供方的工作可以先结束，检查点（checkpoint）工作和差异工作随后才落定。
活动（activity）	时间线上不属于消息的一项，例如一次工具操作、一次批准或一次失败。
T3 home	基础数据目录。运行时状态通常位于其 userdata 目录下。

编排

术语	含义
命令（command）	一条要求改变领域状态的请求。请求被接受，并不表示它的副作用已经完成。
事件（event）	由命令产生、并已持久化的事实。
编排器（orchestrator）	把命令串行化，并且不进行 I/O、只根据当前状态来决定其事件的服务。
投影 / 读模型	当前状态的一份持久化视图，与改变它的那些事件在同一个事务中提交。
命令回执	一条命令的结果的持久记录，用来让重试保持幂等。
发件箱效应（outbox effect）	与事件一起提交的副作用意图，例如启动一次提供方（provider）回合（turn），或捕获一个检查点（checkpoint）。
效应工作器	在提交之后运行发件箱效应，并把结果作为命令送回的工作器。

提供方与检查点

术语	含义
提供方（provider）	T3 Code 所控制的智能体运行时，例如 Codex 或 Claude Code。
驱动（driver）	针对某一种提供方的集成。
提供方实例	一个已配置的提供方，拥有自己的设置和生命周期。多个实例可以使用同一个驱动。
文本生成	由应用自己完成的一次性写作，例如对话线程标题、提交说明和转录清理。
文本生成器	只用于文本生成的模型 API。它的 id 会填入某一项模型选择；智能体界面从不会把它列出来。
适配器（adapter）	把提供方的原生协议翻译成 T3 Code 操作和事件的边界。
提供方会话（session）	附着在某条对话线程上的提供方运行时。会话可以停止后再恢复，而不删除这条对话线程。
运行时模式	这条对话线程的权限策略。参见权限模式。
交互模式	智能体着手处理任务的方式，例如做规划。它与权限策略是分开的。
检查点（checkpoint）	为差异比较和恢复而保存的工作区状态，以一枚隐藏的 Git ref 存放。
检查点基线	在被比较的那部分工作开始之前捕获的工作区状态。
回合差异	归属于一次回合的工作区变更。

拉取请求

术语	含义
拉取请求链接	一条按主机、仓库和编号标识、并已持久化的对话线程（thread）关联。链接可以跨越同一环境（environment）中的不同项目（project），并携带一份由服务器维护的快照。
拉取请求同步	按周期为每一个不同的已链接评审刷新一次，并发现原生堆叠各层的工作器。显式刷新，以及读取堆叠失败，都会再触发一次读取。
当前拉取请求	单评审控件和较旧客户端（client）所使用的那条链接。未关闭的工作优先；一条已经完成的单链指向它的顶层。彼此无关的末端链接则采用最近一次更新。

Composer（编写器）上下文

术语	含义
上下文记录	编写器芯片背后那份带类型的载荷，以 contextId 为键，存放在 message.context.records 中。它从不持有字节。
上下文引用	某条记录在消息文本中的一次出现：[label](https://github.com/pingdotgg/t3code/blob/d2c25950b4d9183ea342d5d5fc14c326b9e0172a/docs/internals/t3-context:/v1/<kind>/<contextId>)。多个引用可以共用同一条记录。
附件绑定	从一条图像或文件记录指向其服务器所持附件（attachment）的链接。附件 ID 可以改变，而 contextId 不必改变。
附件清单	按顺序显示为正文上方缩略图的图像记录，包括没有任何行内引用的图像。

契约与生命周期见Composer 上下文引用。