如何设置翻译、语音朗读和 AI 聊天

1. 在商店中点击安装按钮，并确认添加扩展程序。
2. 打开浏览器的扩展程序菜单，将 VoxyFlow 固定到工具栏。
3. 点击 VoxyFlow 图标，打开完整设置。在这里配置 API 密钥、翻译服务、聊天、语音朗读和快捷键。
4. 连接 DeepL、OpenRouter 或 Ollama。刷新已打开的页面，翻译一个简短的短语。

开始时只需连接一种翻译服务。聊天和朗读可以稍后配置，它们的服务提供商和模型分别选择。

如何翻译选中文本

连接一种翻译服务，用简短的短语测试结果。

1. 1打开 VoxyFlow 完整设置，连接 DeepL、OpenRouter 或 Ollama，然后保存设置。
2. 2刷新页面，选中短语并按 Alt + Shift + V；Mac 上使用 Option + Shift + V。
3. 3在弹出的窗口中选择目标语言。在可编辑字段中，右键单击 →“Translate with VoxyFlow”。

在 VoxyFlow 窗口中选择源语言和目标语言，以明确翻译方向。您可以点击图钉按钮固定窗口，并拖动顶部栏移动窗口。

如何连接 DeepL

您需要自己的 DeepL API 密钥。

1. 1打开 DeepL API 账号，复制身份验证密钥。
2. 2在 VoxyFlow 设置的“API 凭据与服务”中，将密钥粘贴到 DeepL API 字段。
3. 3在“翻译引擎”中选择 DeepL API，点击“保存”，再点击“检查 DeepL”。

在 DeepL 账号中打开 API 密钥部分，完整复制密钥。API 访问需单独开通，与 DeepL 网页翻译器和应用的服务不同。

DeepL 账号中的 API 密钥 · DeepL API 套餐

保存后点击“检查 DeepL”。然后在页面上选中简短的短语并调出译文。DeepL 密钥用于翻译；语音朗读和 AI 聊天需分别连接。

如何通过 OpenRouter 连接 AI 翻译

一个 API 密钥用于连接 OpenRouter 账号；翻译、聊天和语音模型分别选择。

1. 1在 OpenRouter 账号中创建 API 密钥，并将其粘贴到“API 凭据与服务”。
2. 2在“翻译引擎”中选择 OpenRouter AI 和翻译模型。您也可以使用 OpenRouter 模型目录中的模型标识符添加模型。
3. 3点击“保存”，测试 OpenRouter，然后在页面上翻译一个简短的短语。

1. 登录 OpenRouter 账号并创建 API 密钥。按需设置付款，或选择免费模型。
2. 在 OpenRouter 模型目录中找到模型，并复制其标识符。
3. 如果 VoxyFlow 列表中没有该模型，请将标识符粘贴到添加模型的字段中，点击“添加”，再将其选为当前翻译模型并保存设置。

AI 聊天使用的模型在聊天设置中指定，自然语音朗读使用的语音模型则在语音设置中选择。这些设置相互独立。

如何连接 Ollama 本地模型

安装 Ollama，下载模型，并在 VoxyFlow 中配置连接。

1. 1安装 Ollama，下载用于翻译的模型，例如 translategemma:4b。
2. 2在 OLLAMA_ORIGINS 中允许您的扩展程序连接，然后重启 Ollama。指南中提供了各操作系统的命令。
3. 3在 VoxyFlow 中填写 http://localhost:11434，选择 Ollama 作为翻译服务，输入模型名称，点击“保存”，再点击“检查 Ollama”。

ollama pull translategemma:4b
ollama list

launchctl setenv OLLAMA_ORIGINS "chrome-extension://YOUR_EXTENSION_ID"

[Service]
Environment="OLLAMA_ORIGINS=chrome-extension://YOUR_EXTENSION_ID"

sudo systemctl daemon-reload
sudo systemctl restart ollama

环境变量和允许的 origin 设置：Ollama 官方指南。本地连接使用默认服务器地址即可，无需开放互联网访问。

如何启用自然语音朗读

使用 OpenRouter 语音模型，或浏览器和操作系统的声音。

1. 1要使用 AI 朗读，请在“API 凭据与服务”中添加 OpenRouter 密钥，然后点击“保存”。
2. 2在“语音设置”中选择 OpenRouter AI、语音模型和声音。要使用系统声音，请选择“本地（Web Speech API）”。
3. 3调整播放速度，然后点击原文或译文旁的朗读按钮。

原文和译文旁的按钮分别播放对应文本。语速可设为 0.5 到 2，1.0 为正常速度。译文有独立的语速设置。

AI 朗读由 OpenRouter 语音模型提供，按模型费率计费。浏览器和操作系统声音无需 OpenRouter 密钥。

如何开始与 AI 聊天

为聊天单独选择模型，并将需要理解的文本加入对话。

1. 1在“AI 聊天设置”中选择 OpenRouter 或 Ollama，填写聊天模型并点击“保存”。密钥或服务器地址在“API 凭据与服务”中设置。
2. 2按 Alt + Shift + D 打开 VoxyFlow 侧边栏，Mac 上使用 Option + Shift + D，然后切换到聊天。
3. 3手动粘贴文本，或点击“插入选中内容”，补充问题后点击“发送”。

创建新对话。在页面上选中短语，点击“插入选中内容”，或手动粘贴。例如，补充问题：“解释这里为什么使用这个语法结构，并举两个例子。”

检查草稿并点击“发送”。您可以停止回答、返回已保存的对话，或为其他主题创建新对话。

如何保存译文和表达

历史记录收集翻译结果，词典保存您选中的单词和短语。

1. 1在设置中开启“记录 Flow 翻译流”，将成功的翻译保存到历史记录。
2. 2点击翻译窗口中的星形按钮，将单词或短语添加到词典。
3. 3打开侧边栏，在 Flow、“单词”或“短语”中查找记录。要保存完整句子，请选中整个句子。

开启记录后，Flow 历史记录会自动添加成功的翻译。词典由您手动添加：点击翻译窗口中的星形按钮，或按 F。已保存的表达可在“单词”和“短语”选项卡中查找。

要将完整句子及其译文一起保存，请选中整个句子。要填写自己的译法，请在 VoxyFlow 窗口中按 G，然后输入文本。

翻译和设置快捷键可在 VoxyFlow 的“键盘快捷键”部分更改。点击“设置快捷键”，然后按下所需的组合键。

在浏览器扩展程序设置中配置打开侧边栏的命令：Chrome 使用 chrome://extensions/shortcuts，Edge 使用 edge://extensions/shortcuts。Firefox 中打开 about:addons，点击齿轮图标，再选择扩展程序快捷键管理。

翻译窗口处于活动状态时：F 保存到词典，G 填写自己的译法，C 复制结果，Space 或 P 控制译文朗读，Esc 关闭窗口。在输入框中，请通过右键菜单翻译。

• DeepL API：请求用量按您的 DeepL API 套餐计算。
• OpenRouter：翻译和聊天按所选模型的费率计费，目录中也有免费模型。AI 朗读适用语音模型的费率。OpenRouter 模型与费用。
• 本地 Ollama：模型在您的电脑上运行，无需支付云端 API 请求费用。
• 浏览器和操作系统声音：无需连接付费 AI 模型。

历史记录、词典和已保存的聊天位于浏览器中该扩展程序的配置文件内。使用云端服务时，用于翻译、朗读或生成回答的文本会发送给所选服务提供商。使用本地 Ollama 连接时，由您的电脑处理。

了解数据和隐私