# Tab键翻译 — Liu Terminal

> Liu Terminal Tab 键翻译。在发送给编码代理前实时翻译提示行输入以节省 Token。

URL: https://liu.software/zh/docs/translate/  
Language: zh  
Updated: 2026-10-17

## Translate-on-Tab

在将非英语提示词发送给编码智能体之前，在您本地的机器上进行翻译——从而缩减 token 数量并提升智能体的准确度。

## 如何触发

当您在被 Liu 识别为支持的智能体终端提示词输入框中键入内容时，在 translate\_tab\_window\_sec（默认为 0.4 秒）内连续双击 Ctrl 和 Cmd 键。Liu 会截获此组合键，翻译当前的提示词行（支持混合代码和文本的代码段感知翻译），并在您提交前用翻译结果替换该行。

**按键组合：** 双击 Ctrl+Cmd（不仅是单独按下 Tab 键）。可通过按下 Cmd+K 并选择 Toggle Translate、Translate: Cycle Target Language、Translate: Cycle Backend，或进入 Settings: Translate 来启用、禁用或重新配置该功能。

## 翻译后端

translate\_backend 是一个整型枚举值（位于 src/translate/translate.h）：

- **0 — Agent** — 启动一个单次执行的 CLI 智能体（claude / codex / opencode / grok）并通过固定的提示模板完成翻译。
- **1 — Local LLM** — 默认值。内置 USE\_LOCAL\_LLM 时，使用 Metal 加速的本地 GGUF 模型；完全离线运行。
- **2 — API** — 云服务提供商：anthropic、openai、openrouter 或自定义 OpenAI 兼容的基准 URL。若 api\_key 为空，则自动后备使用 ANTHROPIC\_API\_KEY / OPENAI\_API\_KEY / 等环境变量。

## 活动智能体

翻译功能仅在与选定智能体关联的提示中运行。默认启用 Claude、Codex、OpenCode、Grok、Antigravity、Cline 和 Command Code（所有 translate\_active\_in\_\* 标志默认为 true）。可在设置 → 翻译或 config.json 中配置。

## 配置参数项

在 ~/.config/Liu/config.json 中（默认值来自于 translate\_config\_default）：

```
{
  "translate_enabled": true,
  "translate_backend": 1,
  "translate_source_lang": "Turkish",
  "translate_target_lang": "English",
  "translate_tab_window_sec": 0.4,
  "translate_active_in_claude": true,
  "translate_active_in_codex": true,
  "translate_active_in_opencode": true,
  "translate_active_in_grok": true,
  "translate_active_in_antigravity": true,
  "translate_active_in_cline": true,
  "translate_active_in_commandcode": true
}
```

翻译进行时会显示一个视觉加载图标（spinner）。当选择本地后端时，可以在设置中管理本地模型的下载与路径。

[下一步 配置 →](https://liu.software/zh/docs/config.md)