支持
故障排除
常见问题及快速解决方法。没找到你的问题？请在“设置 → 关于”中反馈问题。
常规
没有译文，也没有文字出现
- macOS：检查录屏与系统录音权限是否已开启，然后重新打开应用。
- 在 Cài đặt（设置）→ Engine dịch（翻译引擎）中检查所选引擎的 API key；点击 Test 确认连接。
- 确认电脑上确实在播放声音，并且音源（Hệ thống（系统）/ Mic / Cả hai（两者））与你要翻译的内容相符。
“No API key”或“Invalid API key”错误
前往 Cài đặt（设置）→ Engine dịch（翻译引擎），粘贴所选引擎的 key（如何获取 key）。对于 Soniox，key 需要具备 Temporary API keys 权限和实时语音识别权限；缺少时，应用会显示具体提示。
费用高于预期
检查你正在使用哪个引擎：OpenAI Realtime 约 $4/小时，而 Soniox 约 $0.12/小时。开启长时间会话提醒，让应用在长时间静音后询问是否停止。
“No microphone found”错误
你的电脑没有内置麦克风（例如 Mac mini）。请接入外置麦克风：USB、耳机或 AirPods。
OpenAI Realtime
引擎选项显示为灰色
尚未输入 OpenAI key，或 key 格式不对（必须以 sk- 开头）。粘贴新的 key 并点击 Test。
“Two-way”按钮不见了
这是正常现象：OpenAI Realtime 不支持双向翻译。如有需要，请使用 Soniox（或 Apple Silicon Mac 上的 Local）。
Qwen：WebSocket error
| 现象 | 常见原因 | 解决方法 |
|---|---|---|
一点击开始就出现 WebSocket error | key 是在新加坡以外的地域创建的 | 在新加坡地域新建 key（查看方法） |
| 约 5–10 秒后出错 | key 的地域正确，但未开通 Qwen Live 模型 | Model Studio → Model Square → 开通 qwen3-livetranslate-flash-realtime |
| 翻译一句后就停止 | 源语言设成了自动检测 | 在 Source 中明确选择源语言（例如日语） |
| 间歇性出错 | 网络屏蔽了 dashscope-intl.aliyuncs.com（公司防火墙、VPN） | 换一个网络（4G/5G）试试，或关闭 VPN |
Windows
SmartScreen 拦截安装程序
点击更多信息→ 仍要运行。见在 Windows 上安装。
采集不到系统声音
确认电脑上正在播放声音。有些应用使用独占音频模式——请尝试换一个音源。
应用打不开
确认已安装 WebView2 Runtime。Windows 10/11 通常已自带；较旧的版本需要从 Microsoft 安装。
截图翻译提示缺少 OCR 包
提示 “Windows chưa có gói OCR cho ngôn ngữ này…”（Windows 尚未安装该语言的 OCR 包）表示你需要安装对应的语言包。见 OCR 语言包。
macOS 上的快速翻译与 OCR
F2 翻译的是剪贴板内容，而不是选中的文字
MiuWave 还没有辅助功能权限。在快速翻译窗口中点击 Mở cài đặt（打开设置），并打开 MiuWave 的开关（查看方法）。
F3 提示“Cần quyền Ghi màn hình…”（需要录屏权限）
点击 Mở cài đặt（打开设置），在“录屏与系统录音”中打开 MiuWave，然后重新打开应用。
语音朗读（TTS）
- 没有声音？检查 Đọc bản dịch（朗读译文）按钮是否已开启、系统音量以及 Thiết bị phát（输出设备）。
- TTS 按钮是灰色的？你正处于双向翻译，或正在使用 OpenAI Realtime / Qwen。
- Edge TTS 不工作？检查网络连接。
- Google TTS 出错？检查 key 是否正确，以及 Text-to-Speech API 是否已启用。
- 麦克风收进了朗读的声音？调低 TTS 音量，改用耳机播放，或在朗读时暂停会话。
Local MLX
某些更新后，应用会提示重新运行 Local 安装以添加新组件；已下载的模型会被复用，因此不必再下载那 5 GB。Local 只能在 Apple Silicon Mac 上运行——在 Windows 或 Intel Mac 上，请使用 SenseVoice 进行离线翻译。