入门

在 macOS 上安装

从下载文件到应用能听到电脑里的声音，只需几分钟。应用已签名并经过公证，macOS 打开时不会出现安全警告。

即将推出

MiuWave 尚未发布。以下步骤介绍的是即将发布的安装包。

系统要求

macOS 13 或更高版本，Apple Silicon 或 Intel 均可。Local MLX 引擎需要 Apple Silicon（M1 或更新）以及约 5 GB 磁盘空间。
至少一个可用的引擎。最常用的是 Soniox（需要 API key，约 $0.12/小时）。不想用 key？可以选择 Local MLX（Apple Silicon）或 SenseVoice（任意 Mac，一次性下载约 163 MB 的模型）。见选择翻译引擎。

安装步骤

下载 .dmg 文件 在发布页面中，Apple Silicon（M1/M2/M3/M4）选择 MiuWave_<ver>_aarch64.dmg，Intel Mac 选择 MiuWave_<ver>_x64.dmg。
拖到“应用程序” 打开 .dmg 文件，把 MiuWave 拖进应用程序文件夹，然后推出 DMG。
首次打开应用 从“应用程序”中打开 MiuWave。首次启动时，应用会让你选择一种翻译模式，随后一段简短的应用内导览会带你认识主要按钮。
授予 macOS 权限 打开下方所需权限中列出的权限。要听到系统声音，必须授予录屏权限。
输入 API key 并开始 打开 Cài đặt（设置，⌘ ,）→ Engine dịch（翻译引擎），粘贴 key 并点击 Test。参见获取 API key，然后按照快速入门操作。

所需权限

macOS 权限	用途	何时需要
录屏与系统录音	采集系统声音（YouTube、Zoom、播客…）以及截图翻译（`F3`）	收听 Hệ thống（系统）或 Cả hai（两者）音源时必需
麦克风	通过麦克风收听语音	选择 Mic 或 Cả hai（两者）音源时
辅助功能	Quick Translate（`F2`）复制选中的文字	仅在对选中文字使用 Quick Translate 时

录屏与系统录音

macOS 弹出询问时，点击打开系统设置。
在列表中找到 MiuWave 并打开开关。
macOS 会要求退出并重新打开，点击它以重新打开应用。

如果在授权之前使用 F3，macOS 会在第一次时询问，应用会显示提示 “Cần quyền Ghi màn hình…”（需要录屏权限）以及 Mở cài đặt（打开设置）按钮。打开 MiuWave 的开关后，重新打开应用。

麦克风

当你从 Mic 或 Cả hai（两者）音源开始收听时，macOS 会请求麦克风权限，请选择允许。Mac mini 没有内置麦克风，请接入外置麦克风（USB、耳机、AirPods）。

Quick Translate 所需的辅助功能权限

Quick Translate 通过向最前面的应用发送复制快捷键来复制选中的文字，因此需要辅助功能权限。没有该权限时，Quick Translate 窗口会显示 “Cho phép MiuWave sao chép chữ đang bôi đen: bật MiuWave trong Trợ năng (Accessibility)”（允许 MiuWave 复制选中的文字：在“辅助功能”中打开 MiuWave），并改为翻译剪贴板中的内容。

点击 Mở cài đặt（打开设置），或前往系统设置 → 隐私与安全性 → 辅助功能，打开 MiuWave。每次复制后，你的剪贴板内容都会被恢复。

获取 API key

你只需要为打算使用的引擎准备 key。key 保存在 macOS 钥匙串中。

Soniox（推荐）

前往 console.soniox.com 并注册账号。
选择 Billing，添加付款方式并充值（最低 $10，按约 $0.12/小时计算约可用 80 小时）。
选择 API Keys → Create API Key，复制 key。
在 MiuWave 中：Cài đặt（设置）→ Engine dịch（翻译引擎）→ Soniox API Key 字段，粘贴 key 并点击 Test。

OpenAI（可选）

前往 platform.openai.com 并注册账号。
Settings → Billing：添加付款方式并购买额度（$10 ≈ 2.5 小时 OpenAI Realtime）。
API keys → Create new secret key，复制 key（以 sk- 开头）。

费用

OpenAI Realtime 约 $4/小时，大约是 Soniox 的 34 倍。它适合重要会议；日常使用仍以 Soniox 为佳。

Qwen LiveTranslate Flash（可选，预览期免费）

打开 bailian.console.alibabacloud.com（阿里云 Model Studio）。
登录之前，先在右上角选择新加坡地域。在其他地域创建的 key 会被拒绝，应用会报 WebSocket error。
如有提示，先开通 Model Studio（DashScope），然后进入 API Keys → Create API Key。
立即复制 key（完整 key 只显示一次），粘贴到 Qwen (DashScope) API Key 字段中。

无需 key

Local MLX（Apple Silicon）在你第一次选择它时安装运行环境和模型（约 5 GB）。SenseVoice 只需下载一次约 163 MB 的模型。见选择翻译引擎。

macOS 键盘快捷键

按键	操作
`⌘` `↩`	开始 / 停止
`⌘` `,`	打开设置
`Esc`	关闭设置
`⌘` `1` / `2` / `3`	音源：系统 / 麦克风 / 两者
`⌘` `T`	打开/关闭朗读译文（TTS）
`⌘` `P`	将窗口固定在其他窗口之上
`⌘` `⇧` `L`	关闭点击穿透
`F2` · `F3`	Quick Translate · 截图翻译（可在“设置 → Quick Translate”中更改）

更新

MiuWave 会自动检查新版本。有新版本时，Cài đặt（设置）按钮上会出现一个小圆点；打开 Cài đặt → Giới thiệu（关于），点击 Download & Install。应用会以新版本重新启动，无需再次下载 DMG。