支持
应用设置
用顶部栏的齿轮按钮或 ⌘ ,(Windows:Ctrl ,)打开设置。主页面把所有选项归入六张卡片。

六张设置卡片
| 卡片 | 包含内容 | 另见 |
|---|---|---|
| Engine dịch(翻译引擎) | Engine、带 Test 按钮的 Soniox / OpenAI / Qwen API key、Translation Type(One-way / Two-way)、Dịch bằng(翻译方式)、Source、Target、Language A/B、Strict language detection、Endpoint Delay、Audio Source、Cảnh báo phiên dài(长时间会话提醒)、Context | 选择翻译引擎、实时翻译 |
| Giọng đọc (TTS)(语音朗读) | Provider、Thiết bị phát(输出设备)、语音、语速、各服务商的 key | 语音朗读 |
| Dịch nhanh(快速翻译) | 快速翻译和截图(OCR)快捷键、Ngôn ngữ chữ trong ảnh(图片中文字的语言)、Dịch sang(译成)、Engine hiển thị(显示的引擎)、DeepL / Gemini key、OpenAI 模型、Ollama | 快速翻译与 OCR |
| AI Companion | Nguồn AI(AI 来源)、Ngôn ngữ trả lời(回答语言) | AI Companion |
| Hiển thị(显示) | Opacity、Font Size、Max Lines、Show original text、Thư mục lưu phiên(会话文件夹)、Khởi động(启动) | 会话文件夹 |
| Giới thiệu(关于) | 版本、更新、GitHub 链接和问题反馈 | 更新 |
点击 ‹ Cài đặt(‹ 设置)返回主页面,点击 Lưu và đóng(保存并关闭)保存,按 Esc 关闭。

API key 与钥匙串
- key 字段旁的状态标记表示 key 格式是否有效;点击 Test 可检查与服务商的真实连接。没有有效 key 的引擎在列表中显示为灰色。
- API key 保存在 macOS 钥匙串 / Windows 凭据管理器中,而不是
settings.json。旧版本中的 key 会在首次启动时自动迁移,无需重新输入。 - 如果钥匙串拒绝访问,应用会发出警告,并只在应用关闭前保留该 key;它绝不会把 key 写入明文文件。
登录时打开
Cài đặt(设置)→ Hiển thị(显示)→ Khởi động(启动)→ Mở MiuWave khi đăng nhập máy(登录时打开 MiuWave):登录时应用以最小化方式打开,不会自行开始翻译。
显示
- Opacity:窗口的透明度。
- Font Size:12–140 px。Max Lines:屏幕上保留的行数。
- Show original text:在译文上方显示原文(Aa 菜单中也有此选项)。
- 用顶部栏的按钮切换浅色和深色主题,你的选择会被记住。
更新
MiuWave 内置更新程序。有新版本时,Cài đặt(设置)按钮上会出现一个小圆点。打开 Cài đặt(设置)→ Giới thiệu(关于),点击 Download & Install;应用会下载更新并以新版本重新启动。你也可以在 Updates 中手动检查更新。
在应用改名为 MiuWave 之前就用过它?你的设置、已保存的会话和 macOS 权限都会保留。