语音输入¶

无需键入，直接在 composer 中口述内容。转写文本会进入你的草稿供审阅，只有发送消息时才会向代理发送任何内容。听写功能同样适用于引用评论、差异与文件注释、拉取请求评论、回复和审查摘要，以及桌面应用中的浏览器注释编辑器。

在 iPhone 和 Android 上，语音输入默认在设备上进行转写。要在该手机上选用指定环境，请打开设置 → 语音 → 开启转写。请参阅移动端语音输入。

选择音频的处理位置¶

在 Web 和桌面上，你可以选择在何处运行转写。在你做出选择之前，不会发送任何内容：打开设置 → 语音，并将转写工具设置为你希望用于转写的环境。在新设备上，点击麦克风或使用听写快捷键会从 composer 中打开该设置。此设备上录制的麦克风音频会通过你的认证连接发送到该环境，在那里完成转写后被丢弃。该选择仅保存在此设备上，因此你使用的每台电脑和每个浏览器都会询问一次。你可以随时将其设回关闭；正在进行中的录制将被丢弃。

如果所选环境离线，语音输入会等待其恢复。T3 Code 绝不会替换为其他环境。

对于云端听写，请通过你想要使用的环境选择 OpenAI 或 Grok Voice Transcribe。如果需要密钥，请输入一个并选择保存并启用。你也可以选择密钥提供程序来代替值（Value），然后输入引用。在听写之前，请先解锁该环境中的保险库。任何拥有该环境听写权限的人都可以使用该密钥，但只有此设备会选用它。如果已保存密钥，只需确认提供程序即可。停止后，环境会将你的录音及任何词汇提示转发给所选提供程序，并由其 API 账户计费。无需下载本地模型或订阅聊天服务。在移动端切回此设备，或在 Web 和桌面端切回关闭，即可停止共享。移除密钥后，该环境中的所有用户都将无法使用该提供程序。

OpenRouter 的工作方式相同，但没有默认模型：启用时从其实时语音转文本目录中选择一个，或之后在管理 OpenRouter 下选择。模型选择仅由你决定，无需设置权限，因此任何拥有听写权限的人都可以在不触碰已保存密钥的情况下选择不同的模型。OpenRouter 决定由谁来运行模型。T3 请求零数据保留；你的 OpenRouter 账户也可以允许安全保留。如果没有符合条件的端点，听写将失败，而不是切换模型。词汇提示不会发送给 OpenRouter；字典拼写会在转写后应用。如果 OpenRouter 不再列出你的模型，听写将停止，直到你选择其他模型。

设置模型¶

在设置 → 语音 → 转写中，下载一个模型，如果尚未选中，请选择使用模型。测试模型可让你在不发送消息的情况下试用。如果在安装模型之前使用 composer 麦克风，系统会提示你下载一个。推荐会使用你的语音语言，或通过自动检测使用系统首选语言。

选择你口述时使用的语言，以比较支持所有这些语言的模型。准确度显示模型在每种语言中把单词或字符识别错误的频率；速度是在参考 GPU 上转写 30 秒音频所需的时间。选择所有语言可浏览完整目录。筛选不会切换你的模型。

高级控制 GPU 或 CPU 的使用以及空闲模型何时被卸载。当硬件设置为自动时，在 GPU 上失败的录制会在同一环境的 CPU 上重试一次；你自己选择的 GPU 则会直接报告错误。绝不会在其他环境上重试。标记为实时预览的模型会在你说话时显示文本。其他模型可以在你录制过程中于停顿处对长录音进行分块处理；内置长录音支持的模型会在你停止时进行转写。

听写¶

按下 composer 中的麦克风按钮，或按 mod+shift+d（mod 在 macOS 上是 Command，在其他系统上是 Ctrl）。再次按下麦克风按钮或勾选标记以完成；按 Esc 可丢弃录制内容并保持草稿不变。录音最长可达五分钟。文本将插入到光标位置，或替换录制开始时你所选中的内容；听写运行时编辑器为只读状态。

在听写过程中按下发送按钮会结束录制，并在转写文本插入后发送草稿。取消操作也会取消已排队的发送。在其他编辑器中，保存、评论、回复、提交审查或附加文件的工作方式相同；快捷键会作用于当前获得焦点的编辑器，如果没有焦点编辑器，则作用于 composer。在桌面浏览器的注释编辑器中，当页面获得焦点时麦克风和快捷键才可用；你所注释的页面永远看不到录音内容，录音在 T3 Code 自身中运行。

语音设置中的听写快捷键决定该按键绑定的行为：自动可点按切换或在按住时录制，按住仅在按键按下时录制，切换则始终需要再次按下。你可以在按键绑定设置中更改该组合键本身。

改善识别效果¶

• 语言选择你所说的语言。自动可让多语言模型自行检测。支持翻译的模型会提供翻译成英文选项。
• 字典存放模型应正确识别的名称和术语。当转写反复产生特定拼写错误时，可以在某个术语下添加别名。你的字典保存在此设备上。你听写时所处项目的名称会作为提示一并发送。
• 项目字典是与项目一起保存在其环境中的词汇表，因此在该项目中听写的每个人都会获得相同的拼写。在设置顶部选择项目以进行编辑；当选择了环境时，这些条目适用于该环境下的所有项目。当项目拼写与你的个人字典重叠时，项目拼写优先。每次录制最多携带两者合计 100 个条目。
• 静音过滤默认开启。你选择的环境会在转写前跳过非语音音频。将其关闭以保留这些部分。过滤发生在上传之后：它并不授予发送音频的权限，也不会减少发送的内容。
• 移除语气词会从完成的转写文本中删除犹豫时的声音。

语言和这些偏好会随每次录制一起发送到所选环境；项目中的其他任何信息都不会被发送。

清理转录¶

转录清理是一个独立的选项，默认关闭。开启后，完成的转录文本以及你所选内容之前、之内和之后各最多 1,024 个字符，都会被发送到草稿所在环境上的清理模型，该模型会修正标点、数字以及口语纠正，例如“把它设为 42，抱歉，24”。根据模型不同，这可能会涉及外部服务。音频绝不会发送给它。可以使用内置指令或编写自己的指令；清理运行期间按跳过可插入原始转录文本；如果清理失败，也会插入原始转录文本。

清理默认使用环境的文本生成模型，除非你为该环境选择了清理模型，例如更便宜或更快的模型。它可以是文本生成器而不是编码代理；参见文本生成模型。

如果清理未能识别你的自我纠正方式，可以设置一个纠正提示：你说出来用于标记纠正的词语或短语，例如“scratch that”（意为“划掉重来”）。清理仅在语境显示确实存在纠正时才应用纠正，并去掉提示词；模型会将提示词作为词典提示来理解。

测试与故障排查¶

在设置 → 语音中，麦克风选择器旁边的测试麦克风会录制最多十秒并在浏览器中回放；音频保留在此设备上，绝不会被转录，因此回放无声可能指向麦克风问题。在所选模型上测试模型会显示一份转录，使用与编辑器相同的环境、语言和词典，但即使转录清理已开启也会跳过，这样你就能看到模型实际听到了什么。浏览器录制需要 HTTPS 或 localhost 以及麦克风权限；对于通过纯 HTTP 访问的远程服务器，请使用桌面应用。如果所选麦克风缺失，请选择另一个或使用系统默认。