文档

客户端使用

服务器配置完成后,客户端的各个界面都会通过同一个地球图标提供翻译。结果按条目缓存,来回切换不会重复请求。

聊天面板消息

每条消息的头部都有翻译图标——你的消息在时间旁,模型回复在发送者名称和时间右侧,推理块在 思考中... 标签右侧:

  • 第一次点击把消息的原始 Markdown 发送给服务器,并将消息正文替换为译文。显示译文时图标会高亮;
  • 再点一次恢复原文;
  • 会话保持打开期间译文一直跟随消息,展开的 思考中... 块同样如此。

译文消息按 Markdown 正常渲染,列表、表格和代码块都保持原形。

聊天消息头部的翻译图标与下方的译文正文

提交信息草稿

在 Git 面板的提交框中,草稿超过一行后,AI 按钮旁会出现翻译按钮:

  • 点击翻译整段草稿——译文以只读预览的形式替换输入框内容;
  • 再点一次回到你的原稿(草稿本身从未被修改);
  • 预览显示期间无法输入;先切回原稿再继续编辑。
提交框中的翻译按钮与译文预览

提交详情弹窗

在 Git 历史中悬浮某次提交打开详情弹窗。哈希复制按钮旁是翻译图标:点击在弹窗内翻译提交信息;再点一次查看原文。译文与原文渲染方式一致——标题行、Markdown 正文、代码块都保留。

提交详情弹窗——哈希一行上的复制与翻译按钮

代码编辑器选区

在代码编辑器中选中文字——普通选区和块(矩形)选区都可以——右键选择 翻译(菜单第一项):

  1. 选中范围首行的行号上会出现一个实心地球角标;
  2. 译文卡片立即弹出并显示「翻译中…」占位,服务器返回后原地填充;
  3. 卡片是粘性的:滚动时保持不动,只有关闭按钮、Esc 或点击外部才会收起。悬浮角标可再次打开。

每个翻译过的选区都有自己的角标,翻译相同行只会重新显示缓存的卡片。打开其他文件后角标消失。

代码编辑器中的选区与右键菜单中的翻译项

差异视图选区

差异视图的用法相同:在差异正文中选中若干行,右键、翻译。角标替换首行的新行号,结果卡片锚定在其下方。编辑模式下的选区同样可以翻译;切换到其他文件或提交后角标清空。

差异中被翻译的选区——行号槽角标与译文卡片

翻译的内容

服务器会告诉模型文本的来源:

  • 散文(聊天消息、提交信息)——保留 Markdown 格式,只翻译自然语言;
  • 文件选区(编辑器、差异)——请求会携带文件名,模型由此知道该文件的注释标记(//、#、--……)。注释标记被去除,注释文字按散文翻译;注释内的 Markdown(标题、列表、代码块)保留。如果选区是普通代码,只翻译注释和字符串字面量——标识符与结构原样保留。