T3 Code 非官方中文翻译不是官方产品,也不是 T3 Tools 官方文档。源提交 d2c25950b4d9英文原文GitHub 源文件
Skip to content

消息与上下文 ​

在 Composer(编写器)中给智能体布置任务。任务需要更多上下文时,可以添加文件、引用先前的回复,或加入一项技能。

消息最多可以包含 120,000 个字符。更长的草稿会留在 Composer 中,方便你缩短内容,或拆成多条消息。

粘贴 32 KiB 或更多文本时,该片段会作为文本文件附件加入,这样智能体可以查看它,又不会占满模型上下文。较小的粘贴内容如果插入后会超出消息上限,也会变成附件。使用硬件键盘时,在 Apple 设备上用 Cmd+Shift+V,在其他设备上用 Ctrl+Shift+V,可以让大段粘贴内容仍然能在 Composer 中编辑。

格式 ​

Composer(编写器)会写入 Markdown,并在你输入时显示样式。光标落在已设置样式的文本上时,改为显示其 Markdown,例如 **bold**;这些标记可以像其他文本一样编辑:删掉它们即可去掉样式,或把 ** 改成 * 以使用斜体。光标离开后,样式会更新。若要书写不带样式的纯 Markdown,请关闭 设置 → 聊天 → 富文本编写器。以 - 、1. 、- [ ] 、> 、# 或 --- 开头的行会变成列表、任务列表、引用、标题和分隔线;``` 之后按 Enter 会打开代码块。你输入的内容就是智能体收到的内容,标记和编号都包括在内;即使后面没有空格,#1234 仍然会查找拉取请求(pull request)。

有些已设置样式的文本包含或紧挨着字面 Markdown 字符,例如加粗的 path\ 或 2*3,会保持样式而不显示标记。请使用格式快捷键,或关闭富文本,来编辑这些范围的格式。

Enter 用于发送。在列表或引用中,Shift+Enter 会延续当前结构;在空行上按 Shift+Enter 会先退出一层,然后再离开该结构。Tab 把列表项嵌套到上一项之下,Shift+Tab 则把它移回外层。在代码块中,Enter 会按当前缩进另起一行,Tab 和 Shift+Tab 缩进所选各行;结尾的 ``` 之后按 Enter,或在末尾留下两个空行,都会离开代码块。在代码块开头按 Backspace,会把它变回普通行。在代码块一角选择语言即可更改语言。非常大的代码块显示时不带语法高亮。

附加文件 ​

每条消息最多可以附加 100 个文件。每张图片最大 10 MiB,一条消息中的图片合计最多 80 MiB。其他文件(包括视频)每个最大 50 MiB,具体取决于环境(environment)的上传支持与上限。智能体在该环境的机器上收到这些文件。提供方(provider)和模型的限制仍然适用,包括对话中已经存在的图片。视频附件交给智能体的是一条文件路径;只有 Antigravity 会把受支持的视频作为视频发送给 Gemini 模型。

添加附件后即开始上传。全部上传完成之后,消息才能发送。上传失败时可以重试或移除。在 Web 端和桌面端,如果在上传完成之前重新加载,需要重新附加该文件。

可以把图片拖入或粘贴到 Web 端或桌面端的 Composer(编写器)。HEIC 和 HEIF 照片会在此处转换为 JPEG,从移动端照片图库中选择时也会转换;超出图片上限的照片还会被缩放以适配。在移动端,也可以通过其他应用的系统分享面板把文件发送给 T3 Code。在 Android 上,还可以在分屏中把图片从其他应用拖入消息输入框。

预览和保存媒体,请参见图片与视频。

在智能体工作时发送 ​

在 Web 端和桌面端,选择 设置 → 聊天 → 后续行为,可以把新消息排队到稍后的回合(turn),或立即转向正在运行的回合。该设置作用于这个客户端(client);已经排队的消息保持原有位置。排队的消息保存在服务器上,发送之前可以编辑或移除。当 Enter 用于发送时,macOS 上的 Cmd+Enter,或 Windows 与 Linux 上的 Ctrl+Enter,会使用相反的动作:默认是排队时它会转向,默认是转向时它会排队。如果 发送快捷键 需要 Cmd+Enter 或 Ctrl+Enter,该快捷键使用你的默认后续行为;加上 Shift 则使用相反的动作。只有在你选择多行发送选项时,这才适用于多行消息。

在 macOS 上使用 Cmd+Shift+Enter,或在 Windows 与 Linux 上使用 Ctrl+Shift+Enter,可以把最早排队的消息作为一次转向发送。当前草稿保持原样,并且需要有一个支持转向的活动回合。如果该快捷键会对你的草稿执行相反的动作,请把焦点移出 Composer(编写器),再转向那条排队的消息。在 设置 → 快捷键 中更改 thread.steerQueuedMessage,即可改用另一个快捷键。

在 macOS 上按 Option+Up,或在 Windows 与 Linux 上按 Alt+Up,并且光标位于 Composer 开头时,可以编辑最近排队的消息。更改 thread.editQueuedMessage 即可改用另一个快捷键。

移动端在 设置 → 聊天 下有同样的选择。回合运行期间,发送按钮会显示它将执行的动作。长按该按钮,可以对单条消息使用另一种动作。使用硬件键盘时,Cmd+Return(Android 上为 Ctrl+Return)会使用另一种动作;当 Return 插入新行时,则使用 Cmd+Shift+Return(Ctrl+Shift+Return)。只有正在运行的智能体支持转向时,按钮才会提供转向。

在移动端离线排队消息 ​

移动端会在本地保留草稿附件的副本,因此断开连接时仍可以预览它们并排队消息。重新连接后,上传会继续。草稿和已排队的消息在应用重启后仍然保留。退出 T3 Connect 后,这些内容会留在你的设备上,直到你重新登录同一个账户。

自定义模型 ​

在 Web 端和桌面端,使用「设置 → 提供方 → 模型」添加未列入目录的模型,并指定自定义名称和选项。只有提供方(provider)集成所支持的选项才会影响回合(turn)。Antigravity 使用自己的账户目录,不支持自定义模型。

要在每一个客户端(client)上重命名内置模型,请编辑服务器 userdata 目录中的 settings.json。在该提供方实例下添加一条自定义模型条目,使用内置模型 ID 和新名称:

json
{
  "providerInstances": {
    "codex": {
      "driver": "codex",
      "config": { "customModels": [{ "slug": "gpt-5.5", "name": "Team GPT" }] }
    }
  }
}

模型默认值 ​

T3 Code 会记住你为新对话线程(thread)选用的提供方(provider)、模型以及模型选项。项目(project)中配置的模型优先;重置这项项目设置后,会回到所记住的选择。

推理级别或服务层级留空时,使用提供方自己的配置。

引用助手回复 ​

在 Web 端和桌面端,在一条助手回复中选中文本,然后选择 在 Composer(编写器)中引用。你可以为这段引文添加评论,并在它周围写下指示。

在草稿或已发送的消息中选中这段引文,即可回到其来源。如果来源不可用或已经改变,保存的引文仍然可以阅读。

有评论时,标签显示你的评论;否则显示一小段引文预览。使用铅笔按钮添加或更改评论。要移除这条引用,把插入符放在其标签旁边,像删除其他行内上下文一样删除它。复制、重新加载以及恢复已暂存的提示词时,每条评论都会与其引文留在一起;发送时会告诉智能体哪些文字被引用,以及你写了哪条评论。被引用的文本和评论都计入消息上限。

移动端会显示已保存的引文和评论,但不能创建引用,也不能跳转到它们的来源。

召回已发送的提示词 ​

在空的 Composer(编写器)中按 ArrowUp,可以召回你在这个对话线程(thread)里发送的上一条提示词。再按 ArrowUp 会继续往回,按 ArrowDown 则向前。向前越过最新的一条提示词后,Composer 会被清空。召回依次经过该对话线程中已加载的提示词。原消息中的附件、终端上下文和其他附加内容都不会恢复,只恢复你输入的文本。Composer 中如果已经有附件或选取的元素,就不算空。

Composer 中已有文本时,方向键照常移动插入符。只有当文本是一条未经编辑的已召回提示词,并且插入符位于 ArrowUp 的第一可视行,或 ArrowDown 的最后一可视行时,召回才会接管;折行也计算在内。编辑已召回的提示词后,它就变成普通草稿。

建议的下一条提示词 ​

在「设置 > 实验室」中打开 建议下一条提示词。Claude 或 Codex 的回合(turn)完成后,空的 Composer(编写器)会显示一条预测的下一条消息。按 Tab 将其填入,然后编辑或发送;按 Escape 则将其关闭。每条建议都是一次额外请求,会复用该回合的提示词缓存,因此会占用你套餐用量的一小部分。Claude 会跳过对话线程(thread)的第一个回合,也会在接近用量上限时跳过建议。Codex 需要 0.165 或更高版本;如果由 T3 Code 管理 Codex,请在「设置 > 提供方」中更新它。Codex 会立即遵循这项设置的更改;已打开的 Claude 对话线程要在重启之后才遵循。建议显示在 Web 端和桌面端。

编辑更早的提示词 ​

在 Web 端和桌面端,于已发送的消息下方选择 从此处编辑,可以把对话倒回到该消息之前。选择 还原并保留更改,工作区文件保持原样;选择 同时还原文件,则把工作区恢复到该消息之前的检查点(checkpoint)。这也会撤销你自己所做的编辑。只有在工作树(worktree)中运行的对话线程(thread)才提供文件恢复;如果另一个对话线程或其他提供方会话(session)也在使用该目录、其中的文件夹,或包含该目录的文件夹,恢复会被拒绝,因为恢复会抹掉它们的更改。在项目(project)目录中工作的对话线程只会倒回对话。所选提示词及其附件会回到 Composer(编写器),供你编辑并重新发送。任何未发送的草稿都会留在恢复后的提示词上方。

这会从活动对话线程和提供方(provider)历史中移除所选消息及其后的对话。它不会撤销外部操作,也不会撤销提供方另存的记忆。只有提供方支持倒回时,才能使用这个操作。

提示词暂存 ​

在 Web 端和桌面端,于 macOS 上按 Cmd+S,或于 Windows 与 Linux 上按 Ctrl+S,可以把当前提示词及其附件保存下来以后再用。请先等上传完成。Composer(编写器)为空时,同一快捷键会恢复唯一的一条暂存;有多条时则打开暂存菜单。

包含已上传文件的暂存必须在原来的环境(environment)中恢复。这些文件会保留 24 小时。上传过期之后,先恢复提示词,再使用 重新附加,或在发送前移除缺失的文件。

Web 端和桌面端的语音输入 ​

使用 Composer(编写器)的麦克风或 mod+shift+d,把语音听写进草稿。音频会在你于 设置 → 语音 中选择的环境(environment)上转写;在你选定之前,不会发送任何内容。参见语音输入。

移动端的语音输入 ​

使用 Composer(编写器)的麦克风录音,然后确认以进行转写。文本会插入到开始录音时选区所在的位置,供你在发送前审阅和编辑。

默认情况下,音频留在手机上。本地转写需要受支持的 iPhone,且系统为 iOS 26 或更高版本;或者 Android 12 或更高版本,并具备兼容的 Google 语音服务。若要改用已配对的环境(environment),请打开 设置 → 语音 → 转写位置,选择该环境并确认。完成的录音只会发往那个环境,即使草稿属于另一个环境也是如此。没有本地语音识别的手机也可以这样使用。如果所选环境断开连接,听写会停止,并且绝不会改换主机。选择 本设备 可以撤销访问并丢弃尚未处理的音频。对于云端听写,在 设置 → 语音 里该环境下方打开 云提供方,并确认哪一个提供方(provider)可以接收录音。在 Android 上,录音和转写期间请保持 T3 Code 处于打开状态。

设备端听写第一次可能需要网络连接来下载语音模型。之后,该语言可以离线使用。iPhone 会在你的首选语言(设置 → 通用 → 语言与地区)中,使用 Apple 语音模型所支持的第一种语言来听写。如果一种都不支持,则尝试应用自身的语言。Android 在你录音时于设备上转写,并在你停止后完成。录音最长可以到五分钟。取消或音频被打断时,会丢弃这段录音,并保留你现有的草稿。转到另一个屏幕时,听写仍然继续;使用浮动控件来完成或取消。录音期间屏幕保持唤醒;录音停止后可以照常休眠。

在 设置 → 语音 中排定优先顺序。语音输入会请求列表中第一个已连接的麦克风。列表把类别(内置、其他有线、其他蓝牙,以及 iOS 上的 CarPlay)和你曾经用来听写的有线与蓝牙设备放在一起,并按名称列出。拖动即可把它们一起排序:例如,把 其他蓝牙 放在 AirPods 之上,这样新耳机更优先,而 AirPods 的麦克风仍保持靠后。在 iOS 上,CarPlay 默认排在内置麦克风之后。向左滑动某个设备即可忘记它。当首选麦克风无法路由时,Android 可能会改用另一个输入。同名设备可能共用一条已保存的偏好,但同时存在的同名输入仍然可以分别选择。

转写或取消之后,T3 Code 会从你的手机上删除临时录音。转写文本会留在草稿中,直到你把消息发送给智能体。

排队的消息 ​

在 Web 端和桌面端,智能体正在工作且草稿为空时,Composer(编写器)会显示 中断。加入文本或附件后,它会换成发送按钮,并显示你的后续行为:排队使用排队图标,转向使用转向箭头。单击该按钮,或按下发送快捷键,即可使用该动作。在 macOS 上按住 Cmd,或在 Windows 与 Linux 上按住 Ctrl,可以把按钮切换成相反的动作,然后再单击;也可以使用上文所述的相反动作快捷键。

在 Web 端和桌面端,排队的消息出现在对话线程(thread)末尾,显示为尚未发送的虚线消息。在移动端,它们出现在 Composer 上方。每条都会显示其文本和所附图片。立即发送 会马上发出一条消息;如果已有正在运行的回合(turn),就发进该回合。你也可以编辑或移除它。

如果你停止智能体,或服务器重启,排队的消息会保持顺序并被搁置。在空的 Composer 中按 继续 即可接着进行。继续 也会继续一次已停止的运行,或一次触及用量上限的运行,即使队列里什么都没有。发送一条新消息也会恢复队列,除非这条消息是在转向一个已经在运行的回合。你可以编辑或移除被搁置的消息,而不会把它们启动起来。

排队消息上的铅笔会在 Composer 中打开它以供编辑。在你保存之前,原来的消息仍留在队列中,编辑期间会高亮显示。该消息的附件出现在文本上方,并带有移除控件;新图片可以按平常的方式添加。勾号会就地保存这条排队消息;旁边的 取消 则保持它不变。开始编辑之前你在 Composer 里输入的内容,结束后会恢复。如果在你编辑时这条排队消息开始发送或被移除,编辑即告结束:Composer 为空时,改过的内容会移入 Composer;否则这些改动会被丢弃。

命令与技能 ​

输入 / 可使用命令(command),或输入 $ 从所选环境(environment)和提供方(provider)添加一项技能。在移动端,开始对话线程(thread)之前,二者也可以在 新建任务 上使用。

斜杠菜单也会包含技能,除非你在「高级」下关闭 设置 → 聊天 → 在斜杠菜单中显示技能。列出的只有为该提供方启用的技能。

添加或更改技能、插件或 MCP 服务器之后,在 Web 端和桌面端的命令面板中使用 重启智能体会话。对话会继续,你的下一条消息会用新的配置重新启动智能体。

提供方命令必须位于消息开头才会运行。T3 Code 的命令(例如 /model)和技能提及在任意一行都可以使用。

在已有对话中发送 /compact,可以在提供方支持时降低上下文用量。

单独发送 /clear,或从斜杠菜单中选择它,可以在同一对话线程中开始一个新的提供方会话(session)。你的下一条消息会进入一个看不到先前消息的新提供方会话,对话线程会用 新会话 标出它开始的位置。更早的消息和差异仍留在对话线程中。关闭 Composer(编写器)上方的提示,则改为保留当前提供方会话。

在 Web 端和桌面端,于 设置 → 外观 → 对话线程详情 中打开 上下文窗口,即可在对话线程详情卡片中查看上下文用量。提供方报告用量之后,它才会出现。

Claude 实例也可以为你压缩空闲的对话线程。参见压缩长对话。

目标 ​

对于 Codex、Claude,以及 OpenCode 2.2.5 或更高版本,发送 /goal,并在后面写上「完成」的含义,例如 /goal all tests in packages/api pass。智能体会跨回合(turn)持续工作,直到它判断目标已经达成。工作期间,对话线程(thread)会显示 目标;对话线程末尾的一行(移动端位于 Composer(编写器)上方)会显示该目标及其进度。

  • /goal 单独使用时显示当前目标。/goal clear 会移除它。
  • Codex 和 OpenCode 还支持 /goal pause 与 /goal resume。停止它们的目标会将其暂停。Codex 在工作结束却未达成目标时也会暂停。
  • 停止 Claude 会结束当前回合,但目标仍然保持设置。Claude 会在你下一条消息结束时再次检查它。
  • 在智能体工作期间发送一个新目标,或发送 /goal resume,会停止当前回合并启动该目标,除非你把它排队。/goal clear 和 /goal pause 只有在回合正在处理该目标时才会停止该回合。其他目标命令会等到回合结束。

消息中的上下文 ​

你附加的上下文会出现在光标所在处,成为文本中的一枚标签:终端摘录、来自差异或文件的审查评论、预览批注,或一个文件。你可以在标签前后输入,通过剪切和粘贴移动它,也可以像删除一个字符那样删除它。悬停在标签上可查看简要详情。选中终端摘录可打开其捕获的输出;选中审查评论、选取的元素或预览批注,可打开完整详情。对屏幕阅读器,标签会读作「终端摘录,终端 1 第 3-4 行」以及类似的说法。

拉取请求(pull request)显示为其图标和编号。颜色反映附加时它是开放、草稿、已合并还是已关闭。选中它可以查看捕获的标题和分支,然后选择 打开拉取请求 前往该拉取请求。在 Web 端和桌面端,输入 # 可以浏览当前项目(project)仓库中最新的拉取请求。与该对话线程(thread)关联的拉取请求会来自任何仓库,并排在最前,仅次于精确编号匹配。继续输入数字,可以按拉取请求编号的任意部分筛选最近列表。完整编号也会被直接解析,即使该拉取请求比最近列表更早。在 # 后输入一个单词,可以按文本在仓库中搜索拉取请求。选择一条结果,即可把它作为标签插入。

另一个对话线程也可以作为上下文。输入 @,再输入标题的一部分,即可从同一台服务器中选取;「已链接环境」测试功能开启时,也可以从它所链接的机器上选取,这些条目会显示机器的名称。在 Web 端和桌面端,你也可以把对话线程从侧边栏拖出,放到 Composer(编写器)上;多选会一起放下。在任何客户端(client)上,复制对话线程 会复制一条指向该对话线程的链接,粘贴到 Composer 中即成为它的标签。标签显示对话线程的当前标题,选中后会打开它。你的提示词只携带一个引用:智能体按需读取该对话线程的历史,因此在智能体查看之前,附加一条很长的对话线程不会产生开销。附加对话线程不会改变它;除非你提出要求,智能体也不能向它发送消息。

来自已链接机器的对话线程,无论是选取、粘贴还是放下,都仍然是一个引用,由智能体在那台机器上读取。粘贴指向任何其他机器上对话线程的链接,则仍然只是链接。从任何其他环境(environment)放下一条对话线程,会附加一份已保存的记录文件。来源环境必须处于连接状态并且是最新的。这份记录包含放下当时的可见历史和已保存的文本上下文;之后的消息以及所附文件的内容不会被复制。来源断开之后,智能体仍可以阅读这份已保存的记录。普通的文件附件限制仍然适用。

输入 @ 以及模型或提供方(provider)名称的一部分,例如 @opus,即可向智能体指明该模型,例如在委派时。这不会改变对话线程的模型。用 :、/ 或 - 连接词语,如 @opus:opencode 所示。

图片会把缩略图栏留在文本上方,同时在光标处也放一枚标签,这样你可以确切指出指的是哪张图片。删除图片标签后,图片仍留在栏上;如果文本里仍然提到这张图片,移除缩略图时会先询问,然后两者一起移除。文件只以标签形式存在:删掉某个文件的最后一枚标签,就会把该文件从消息中移除。

复制含有标签的文本,并粘贴到另一份草稿中(同一对话线程或其他对话线程均可),标签会连同它们所指向的内容一起过来。图片和文件会从来源环境重新获取;在此期间标签显示虚线轮廓。如果无法完成,T3 Code 会告知你,并留下这枚标签,供你移除或替换。上下文已不再可用的标签也会显示同样的虚线轮廓;悬停可查看该怎么做。

用复制按钮复制一条消息,或从中复制文本,会给其他应用一份可读的 Markdown,其中每枚标签都换成一个链接。在标签出现之前发送的较旧消息,仍然会显示它们的上下文。暂存提示词时会保留其标签及所指向的内容;恢复时会把它们带回来。

在移动端,点按标签即可查看其内容。文件引用会打开当前文件;附加的文件显示的是附加到该消息上的那一份副本。

附加的文件 ​

在草稿或已发送的消息中选中文件标签即可预览。代码和 JSON 使用语法高亮;Markdown、HTML、CSV 和 TSV 提供渲染视图和原始视图。音频文件带有播放控件。较大的文本文件只显示有限预览;保存该文件后即可完整阅读。

在 Web 端和桌面端,文件会在对话旁边打开,控件与工作区文件相同:标题行里有视图切换、复制内容 和 保存文件。在移动端,文档会在与工作区文件相同的文件屏幕中打开;其菜单包含 复制内容、保存或分享 和 在文件查看器中打开。图片、视频和 PDF 仍使用各自的原生查看器;Word 或 Pages 等其他文档格式,在设备自带查看器可用时会用它打开。如果设备上没有任何程序能显示某种格式,请保存或分享,再到别处打开。不超过 50 MB 的 ZIP 在各个端上都会作为文件夹列表打开;在移动端,选中其中的文件即可预览、保存,或添加到聊天。

消息中的图片与视频 ​

选中图片或视频附件,或选中其链接,即可预览。能否播放取决于你的浏览器或设备;不受支持的视频可以保存后用其他应用打开。

在 Web 端和桌面端,右键单击媒体即可保存,或复制其路径或 URL。在移动端,触摸并按住图片或视频缩略图,然后选择 保存或分享。在 iOS 上,看完全屏视频后,回到缩略图即可打开此菜单。

文件链接指向环境(environment)的机器,远程连接时也是如此。预览使用的是原始文件,即使它在工作区之外。移动或删除该文件可能使预览失效,因此如果需要保留,请保存一份副本。

工作区之外的文件 ​

顺着智能体的文件链接,可以阅读工作区之外的报告或其他文件。这些文件以只读方式打开。工作区之外的 HTML 文件不能从相邻文件加载脚本、样式或图片。

文件查看器中的 HTML 与 PDF 文件 ​

在 Web 端和桌面端,HTML 和 PDF 文件会作为渲染后的页面打开。把 HTML 文件切换到源码视图即可阅读其标记;指向特定行的链接会自动打开源码。HTML 预览无法访问你的 T3 Code 会话。

文件查看器根据文件扩展名识别图片、HTML 和 PDF 文件,包括文件名或文件夹名中含有 # 或 ? 的情况。

在移动端,选中 PDF 附件或链接即可打开。iOS 使用原生查看器;Android 会打开已安装的兼容文件查看器。

非官方译文 · 源提交 d2c25950b4d9 · 不代表 T3 Tools