术语表¶

以下术语在 T3 Code 中具有全局重要意义。架构和生命周期约束属于概述，而不是这些定义。

工作区与会话¶

Term	Meaning
Environment	一个正在运行的服务器，以及它所拥有的机器、凭据、工作区访问权限和状态。
Client	连接到环境的 Web、桌面或移动端 UI。桌面应用也可以托管服务器。
Project	以目录为根的环境本地工作区记录。
Workspace root	项目在环境中的基础文件系统目录。
Worktree	线程可以使用的独立 Git 检出，以代替项目的主检出。
Thread	项目的持久对话和工作历史。它在提供方进程退出后依然存在。
Turn	一次用户到代理的循环，即一次 V2 运行。提供方的工作可能在检查点和差异工作落定之前结束。
Activity	非消息类时间线条目，例如工具操作、审批或失败。
T3 home	基础数据目录。运行时状态通常位于其 `userdata` 目录下。

Term	Meaning
Command	改变领域状态的请求。接受它并不意味着其副作用已经结束。
Event	由命令产生的持久化事实。
Orchestrator	将命令串行化，并根据当前状态决定其事件的服务，不进行 I/O。
Projection / read model	当前状态的持久化视图，与改变它的事件在同一事务中提交。
Command receipt	命令结果的持久记录，用于使重试幂等。
Outbox effect	与事件一起提交的副作用意图，例如启动提供方轮次或捕获检查点。
Effect worker	提交后运行发件箱效果，并将其结果作为命令反馈的工作器。

Term	Meaning
Provider	T3 Code 控制的代理运行时，例如 Codex 或 Claude Code。
Driver	针对某类提供方的集成。
Provider instance	一个已配置的提供方，具有自己的设置和生命周期。多个实例可以使用同一个驱动。
Text generation	应用自身的一次性写作，例如线程标题、提交消息和记录清理。
Text generator	仅用于文本生成的模型 API。其 ID 会填充模型选择；代理界面永远不会列出它。
Adapter	将提供方原生协议转换为 T3 Code 操作和事件的边界。
Session	附加到线程的提供方运行时。会话可以在不删除线程的情况下停止和恢复。
Runtime mode	线程的权限策略。参见权限模式。
Interaction mode	代理处理任务的方式，例如规划。与权限策略相互独立。
Checkpoint	用于差异和恢复的已保存工作区状态，以隐藏 Git 引用的形式存储。
Checkpoint baseline	在被比较的工作开始之前捕获的工作区状态。
Turn diff	归属于一个轮次的工作区变更。

Term	Meaning
Pull request link	由主机、仓库和编号标识的持久化线程关联。链接可以跨环境内的项目，并携带服务器维护的快照。
Pull request sync	按既定节奏刷新每个不同的关联审查，并发现原生堆栈层的工作器。显式刷新和失败的堆栈读取会触发另一次读取。
Current pull request	单审查控件和旧客户端使用的链接。进行中的工作优先；已完成的单一链指向其顶层。无关的终态链接使用最新更新。

Term	Meaning

上下文记录	Composer chip 背后的类型化载荷，以 `message.context.records` 中的 `contextId` 为键。它从不包含字节数据。
上下文引用	记录在消息文本中的一次出现：`[label](t3-context://v1/<kind>/<contextId>)`。多个引用可以共享同一条记录。
附件绑定	从图像或文件记录到其服务端所拥有附件之间的链接。其附件 ID 可以在不更改 `contextId` 的情况下改变。
附件清单	按顺序排列的图像记录，以缩略图形式显示在正文上方，包括没有行内引用的图像。

参见 Composer 上下文引用了解其契约与生命周期。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 t3/t3code