VoxyFlow 快速上手指南
学习如何安装、配置和使用 VoxyFlow — 专为流畅翻译和高效外语学习打造的浏览器端生态工具。
快速安装
一键从 Chrome 应用商店安装 VoxyFlow 扩展。插件轻量，无需注册即可使用。
选择您的 AI 引擎
VoxyFlow 本身完全免费，采用 Bring-Your-Own-Key (BYOK) 模式以最大限度保护您的隐私。请选择您偏好的服务商：
OpenRouter (先进大模型)Advanced
连接顶尖的云端 AI 模型（如 Gemini 2.5 Flash、Claude 3.5 或 DeepSeek）以处理整句的复杂翻译。
Get OpenRouter API KeyOllama (本地离线 AI)Offline
在本地电脑运行开源神经网络模型（如 translategemma:2b），100% 隐私且支持完全离线工作。
默认情况下，Ollama 会阻止浏览扩展的请求 (CORS)。您必须通过运行以下命令来启用访问：
macOS：在终端中运行 `launchctl setenv OLLAMA_ORIGINS "*"` 并完全重启 Ollama 软件。
Windows：添加名为 `OLLAMA_ORIGINS` 的用户环境变量，其值为 `*`，然后重启 Ollama。
Value: *
Linux：运行 `sudo systemctl edit ollama.service`，在 `[Service]` 下插入 `Environment="OLLAMA_ORIGINS=*"`，然后重启服务。
基础配置
首先，为了使用方便。点击 Chrome 中的拼图图标 🧩，找到 VoxyFlow，然后点击图钉图标 📌，将其固定在您的工具栏上。
现在点击固定在栏上的 VoxyFlow 图标以打开快速设置。粘贴您的 API 密钥，选择您的 AI 模型，然后点击“保存”。
三种翻译模式
通过直接内置于网页中的灵活视觉模式，开启无缝阅读体验：
悬停模式：按住快捷键，只需将鼠标停在生词上，翻译即刻呈现，松开按键窗口即关闭。
划词模式：高亮选中文段或短语，按下快捷键即可在翻译弹窗中播放发音或一键保存。
PDF 与右键菜单：在选中的文本上右击，选择 'Translate with VoxyFlow'。完美契合复杂文档格式翻译。
控制中心 (键盘快捷键)
让您的双手保留在键盘上。VoxyFlow 专为极速无感交互而设计，让您时刻处于心流中。
全局激活快捷键
翻译窗口内的操作按键
控制台：Flow 与专属词库
您翻译的所有内容都可以成为您的记忆素材。通过侧边栏轻松管理您的词汇：
手动翻译面板：手动输入文本。开启“自动发送至 Flow”可自动保存您的每一次查询。
Flow 信息流：实时记录翻译的历史流水。每条记录都会带上原网页中的上下文例句。
智能分类词库：扩展会自动将单词和长短语分类存储在不同标签页下，便于复习。
Anki
导出到 Anki：下载包含生词和例句的 CSV 文件，可直接导入您的 Anki 卡片组中。
Quizlet
导入到 Quizlet：只需一键将专有格式的文本复制到剪贴板，在创建模块时直接粘贴即可。
技术实现
扩展程序的精妙架构可节省您的 API 限制并确保即时响应：
智能三级缓存：在内存和 IndexedDB 中保留 14 天。重复翻译无需等待，免费瞬间加载。
API 熔断保护：在网络波动时，熔断器会自动暂停请求，保护您的密钥不被云端接口封禁。
智能语言识别：对于超短单词，插件会自动获取网页 `html lang` 属性，防止自动语系识别混淆。
温和模型策略：为防止 Token 消耗过快，大模型翻译下悬停模式自动停用，并适度延长了超时时间。