# Chat Translation (聊天翻译) 规范地址：https://xstavern.com/wiki/extensions/translation/ 原文：https://sillytaverncn.net/extensions/translation/ 核对日期：2026-11-03 授权迁移，保留作者、上游许可与出处。 Chat Translation (聊天翻译) # Chat Translation (聊天翻译) ## 概述 聊天翻译扩展使用各种翻译提供商实现聊天消息在不同语言之间的实时翻译。它支持手动和自动翻译模式。 ![使用"Translate Message/翻譯訊息"消息操作按钮将英文消息翻译成中文](../static/extensions/translation/sensei.png) +++ English !["Translate Chat", "Translate Input"](../static/extensions/translation/wand-menu-en.png) +++ 简体中文 !["翻译聊天", "翻译输入"](../static/extensions/translation/wand-menu-zh-cn.png) +++ 繁體中文 !["翻譯聊天內容", "翻譯輸入內容"](../static/extensions/translation/wand-menu-zh-tw.png) +++ 한국어 !["채팅 번역하기", "입력 번역하기"](../static/extensions/translation/wand-menu-ko.png) +++ Русский !["Перевести чат", "Перевести моё сообщение"](../static/extensions/translation/wand-menu-ru.png) +++ ## 使用方法 翻译聊天消息的所有方式： ** 翻译聊天**按钮在** 扩展**菜单中 - 一次性翻译整个聊天历史 ** 翻译输入**按钮在** 扩展**菜单中 - 仅翻译当前输入文本 - 在发送消息前很有用 ** 翻译消息**图标在任何消息的** 消息 操作**工具栏中 - 点击仅翻译该消息 - 再次点击恢复原文 **自动模式**配置在** 扩展**面板的**聊天翻译**抽屉中 - 自动翻译用户输入、AI 回复或两者 **/translate** 斜杠命令 - 使用 `/translate [target=language_code] text` 翻译文本 ## 配置 配置选项在** 扩展**面板的**聊天翻译**抽屉中。 #### 提供商 - 选择您偏好的[翻译服务](#翻译提供商) - 如果出现** API 密钥**图标，点击输入 API 密钥 - 如果出现** 自定义 URL**图标，点击输入自定义 API URL #### 目标语言 选择您想要用来写消息或阅读 AI 回复的语言。 #### 自动模式 配置自动翻译行为。 - **无**：不自动翻译 - **翻译回复**：自动将 AI 回复翻译成目标语言 - **翻译输入**：自动将用户输入翻译成英语 - **全部翻译**：翻译用户输入和 AI 回复 #### 清除翻译 ** 清除翻译**按钮移除当前聊天中所有消息的翻译。原始消息会保留。 ### 配置示例：中英聊天 要设置一个让说中文的用户可以用中文与使用英语的 AI 聊天的工作流程： 1. 将自动模式设置为"全部翻译" 2. 将目标语言设置为"中文（简体）"或"中文（繁体）" 3. 选择具有良好语言自动检测功能的翻译提供商（例如 Google 或 DeepL） 此设置将： - 将用户的中文输入翻译成英语供 AI 使用 - 将 AI 的英语回复翻译回中文供用户使用 此设置依赖于输入的自动语言检测。为了更精确的控制，未来的更新可能会包括明确的源语言选择。 ## 翻译提供商 **:icon-cloud:** 云端 **** 本地，自定义 URL **** 需要 API 密钥 | 提供商 | 位置 | 特点 | |---------------------------------------------------------------------|-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------| | [Libre Translate](https://libretranslate.com/) | :icon-cloud: | 专有翻译服务的自托管（AGPL-3.0）替代品，带有云托管的专业版 | | [Google Translate](https://cloud.google.com/translate) | :icon-cloud: | 使用广泛，支持多种语言，准确度高 | | [Lingva Translate](https://lingva.ml/) | | Google Translate 的替代前端，开源（AGPL-3.0），注重隐私 | | [DeepL](https://www.deepl.com/) | :icon-cloud: | 高质量翻译，尤其是欧洲语言 | | [DeepLX](https://github.com/OwO-Network/DeepLX) | | 自托管 DeepL 代理，开源（MIT），免费但代理 DeepL Pro 需要 DeepL API 密钥 | | [Bing Translator](https://www.bing.com/translator) | :icon-cloud: | 微软的翻译服务，与 Azure 服务集成 | | [OneRing Translator](https://github.com/janvarev/OneRingTranslator) | | Google Translate 和其他提供商的自托管前端，注重隐私，开源（AGPL-3.0） | | [Yandex Translate](https://translate.yandex.com/) | :icon-cloud: | 适用于俄语和东欧语言 | ### DeepL 特定配置 - 德语、法语、意大利语、西班牙语、荷兰语、日语和俄语可用正式程度级别 - 通过 [config.yaml](/Administration/config-yaml.md#deepl-配置) 中的 `deepl.formality` 配置 ## 斜杠命令 使用 `/translate` 命令进行快速翻译。语法：`/translate [target=language_code] text`。如果未提供目标语言，将使用扩展设置中的值。 ### 基本用法 将文本翻译成当前目标语言并在弹出窗口中显示： ``` /translate Welcome to the Tavern | /echo ``` ![中文（简体）弹出窗口，'欢迎来到酒馆/Welcome to the Tavern'](../static/extensions/translation/welcome-tavern.png) 将文本翻译成西班牙语并添加到聊天中： ``` /translate target=es Hello world | /send ``` ![西班牙语用户消息，'Hola Mundo/Hello world'](/static/extensions/translation/hola-mundo.png) ### 测试、管道翻译、本地化 提示用户输入消息和语言，将消息翻译成该语言，然后重新翻译成配置的目标语言，并在弹出窗口中显示两个翻译。此示例使用 `/input` 和 `/buttons` 命令收集用户输入： ```shell /input default="Hello, world!" Sample text | /let key=input || /buttons labels=["zh-CN", "zh-TW", "es", "hu", "en"] Language | /let key=lang || /translate target={{var::lang}} {{var::input}} | /let key=tx_target | /translate | /let key=tx_orig || /echo escapeHtml=false cssClass=wider_dialogue_popup Test message: {{var::input}}
Output ({{var::lang}}): {{var::tx_target}}
Output (target language): {{var::tx_orig}}
``` 这对于在将翻译写入重要位置之前，检查翻译成您不会说的语言的质量很有用。 ![弹出窗口，'Welcome to the Tavern/欢迎来到酒馆/welcome to the pub', en, zh-CN, en](../static/extensions/translation/welcome-tavern-en-cn.png) ![弹出窗口，'My hovercraft is full of eels/我的氣墊船裡裝滿了鰻魚/My hovercraft is filled with eels', en, zh-TW, en](../static/extensions/translation/eels-out-zh-tw.png) UI 控件以当前语言环境显示，独立于配置的目标语言。 | `/input` | `/buttons` | |-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------| | ![输入对话框，'发送测试消息/Send Test Message'](../static/extensions/translation/eels-input-zh.png) | ![按钮对话框，'语言/Language'](../static/extensions/translation/eels-lang-zh.png) | ![弹出窗口，'我的氣墊船裡裝滿了鰻魚/My hovercraft is full of eels', zh-TW -> en -> zh-TW](../static/extensions/translation/eels-out-tw-en.png) 在以下示例中，输入语言检测相对有效： ![弹出窗口，'(My hovercraft is full of eels)/A légpárnás hajóm tele van angolnával/我的氣墊船裡裝滿了鰻魚', zh-TW -> hu -> zh-TW](../static/extensions/translation/eels-out-tw-hu.png) ![弹出窗口，'我的氣墊船裡裝滿了鰻魚/Mi aerodeslizador está lleno de anguilas/My hovercraft is full of eels', zh-TW -> es -> en](../static/extensions/translation/eels-out-tw-es-en.png) ![弹出窗口，'Il mio hovercraft è pieno di anguille/我的气垫船里装满了鳗鱼/My hovercraft is filled with eels', it -> zh-CN -> en](../static/extensions/translation/eels-out-it-zhCN-en.png) ## 技术说明 - 支持 UTF-8 编码、特殊字符和表情符号 - 在需要时通过分块处理大型消息 - 保留消息中的格式和嵌入图像 - 缓存翻译以避免重复的 API 调用 ### AI 输入语言 `internal_language` 控制用户消息在发送给 AI 之前自动翻译成的语言。在默认设置中硬编码为'en'，无法通过 UI 更改。因此，发送给 AI 的消息的翻译目标语言始终是英语。之前的测试表明，AI 在接收英语消息时表现更好，但随着更多 LLM 在更多样化的语言数据上训练，这种情况可能会改变。我想可以在 `settings.json` 中更改 `internal_language` 并进行尝试。 ### 中文变体处理 扩展支持简体中文和繁体中文，但并非所有翻译提供商都支持。UI 分别将它们显示为"中文（简体）"和"中文（繁体）"，语言代码为'zh-CN'和'zh-TW'。它们被映射到以下翻译提供商的语言代码： * Libre Translate：'zh-CN'映射到'zh'，'zh-TW'映射到'zt'。 * DeepL 和 DeepLX：两种变体都映射到'ZH'。 * Bing：'zh-CN'映射到'zh-Hans'，'zh-TW'保持不变。 * 其他提供商按原样使用'zh-CN'和'zh-TW'。 ### 文本长度限制 一些提供商对每个请求有字符限制： - Yandex：5000 字符 - DeepLX：1500 字符 - Bing：1000 字符 - Google：5000 字符 较长的文本会自动分块进行翻译。 许可与致谢：https://xstavern.com/wiki/licensecredits/