使用文档 · Voice Translator · Mac · 更新于 2026-09-10
装好之后，开会只看浮层。
Voice Translator 的 Mac 面是一款 macOS 菜单栏 App，做「听」和「谈」两个姿势：对方说的秒变中文字幕，轮到你时屏幕上已经有一句能开口的英文，会后自动留下笔记与术语表。装它要五步：拖进应用程序、双击、下模型、授一次权限、看浮层 —— 不用注册账号，也不用自己开 key。下面把每一步、想自带 key 的话怎么开、权限记在谁头上、会中坏了怎么办、数据存在哪、怎么卸载，一次写清。
这份文档对应 1.6.0（2026-09）。
安装：五步
1 · 拖进「应用程序」
把 Meeting Translator 拖进「应用程序」文件夹。1.6.0 的安装包还叫 Meeting Translator（Meeting-Translator-1.6.0.dmg，装出来是 Meeting Translator.app），下一版随产品改名；数据目录已从 ~/Documents/MeetingTranslator 迁到 ~/Documents/VoiceTranslator，旧路径留软链。
2 · 双击它
菜单栏出现 🎧，浮层出现在右下角。第一次会问一次「访问文稿文件夹」（数据目录在 ~/Documents/VoiceTranslator），点允许。没有终端，没有浏览器。
3 · 下模型，然后直接开会
浮层第一次是钥匙页：豆包同传 2.0（字幕 + 中文）和智谱 GLM（我要说 / 招式 / 笔记）各一行，旁边有「去开通」。贴上 → 验证并保存：App 各握手一次，通了才存进本机数据目录，重装、换版本不用重填。只填豆包也能开始，「我要说 / 招式 / 笔记」先灰着。之后换 key 在回顾窗 › 偏好 › 钥匙。
4 · 开始监听并授权
点 🎧 → 开始监听。第一次会要一次「屏幕与系统音频录制」权限：系统设置 → 隐私与安全性 → 屏幕与系统音频录制 → 勾上 Meeting Translator。签名固定，这一次授权永久有效。
5 · 看浮层
字幕出现在悬浮窗上（⌥S 显示 / 隐藏）。开会用的东西全在浮层上：■ 结束 · ⌥⏎ 我要说 · ⌥1–7 招式 · ⚙ 会中开关（,）· × 收起。试用是 5 分钟处理时长，不按天：浮层状态行写着「试用 · 还剩 m:ss」，用完按用量充值。
声音是 App 自己采的：抓系统音频，不用装虚拟声卡，不用改系统的输入输出，也不需要浏览器参与。它不进会议，对方看不到它。短语库、存档、笔记全文这些会前会后才翻的东西在主界面：⚙ →「⧉ 主界面」。
想自带 key 的话（可选）
装好就能开会 —— 这一节是给想直连厂商的人的：自带 key 更快更准，内容也不经过我们。两把 key 各管一条车道，你自己在厂商那里开、按量付给厂商，key 只存在你本机的数据目录里。
| key | 管什么 | 在哪开 | 贴在钥匙页哪一行 |
|---|---|---|---|
| 火山引擎 · 豆包同传 2.0 | 英文字幕 + 中文字幕，端到端，不经大模型；默认链路 | 火山引擎控制台开通豆包同传，创建 API Key | 「豆包同传 2.0」那一行（技术上是 VOLC_API_KEY） |
| 智谱 · GLM | 我要说、建议、会后笔记；豆包连不上时的备用字幕 | 智谱开放平台创建 API Key；默认模型 glm-5.3-flash（付费但便宜；免费档 glm-4.7-flash 白天常被限流） | 「智谱 GLM」那一行（技术上是 GLM_API_KEY） |
贴错了会当场说：「豆包不认识这把 key」「智谱账户欠费或额度用完」「连不上（网络）」三句不同的话，各带一个能点的动作。豆包连续连不上会自动降级到 AssemblyAI + GLM 出字幕，再连不上就交给本机识别（不要网络也不要 key），界面提示一次并把状态灯变黄，不用你动手。「我要说 / 建议 / 笔记」也可以走本机的 LM Studio，一个字都不出网。
权限：两项，记在启动它的进程头上
- 屏幕与系统音频录制：抓会议的声音用的。第一次点「开始监听」时系统会问一次，勾上 Meeting Translator。
- 麦克风：只在开「我的声音」时要，用来听你自己说的英文。识别在端侧，你的声音不出本机。
- 记在谁头上：macOS 把授权记在启动采音进程的那个 App 上。双击 Meeting Translator 起的，勾它就对；如果你是从终端起的服务，要勾的是那个终端，勾 Meeting Translator 没用。签名是固定的 Developer ID，所以重装、升级都不会再问。
第一场会
会前
把会议邀请贴进浮层的会前卡，术语表和与会者名字自动入库。菜单栏 🎧 → 开始监听。
会中
只看浮层：对方说话看中文大字；❓ 亮起说明对方在问你，SAY 行已经预填了一句能开口的英文；招式盘七格 ⌥1–7 一按一句；✎ 我要说：中文进、地道英文出，复制完念底下那一行。
会后
■ 结束 → 会后卡（时长、句数、你开口几次、自动标题）→ 📝 笔记：值得记的表达、你说过的话的更地道版本、可复用句式。每条旁边有 ⭐，点一下进短语库，下场会自动喂回建议。
会中坏了怎么办
| 看到什么 | 是什么 | 怎么办 |
|---|---|---|
| 状态灯变黄，提示了一次「已降级」 | 豆包连续连不上，已自动换到备用字幕；再不行会换到本机识别 | 不用动手；会后看状态行上的延迟数字就知道这一场走的是哪条链路 |
| 系统音频 0 字节，或满屏都是「我」 | macOS 的录屏服务（replayd）卡住了，App 采不到会议的声音 | App 会自动踢它一次并亮红条；红条不消失就点条上的「再踢一次」；还不行重启 Mac |
| 故障条说「豆包不认识这把 key」/「额度用完」 | key 贴错、过期，或账户欠费 | 点「去钥匙」重新贴，或点「去充值」；字幕会先自动换到备用链路 |
| 状态行「余额用完了 · 充值」，浮层出充值卡 | 5 分钟试用用完，或余额归零 —— 这一段说完才停，一场不劈开 | 去价目页充值，或点「输入账户码」贴进已有的码；回顾窗、短语库、偏好照常可用 |
| 勾了权限还是没权限 | 服务是终端起的，不是这个 App 起的，授权记在终端头上 | 退掉终端那份，双击 Meeting Translator |
| ❓ 亮了但 SAY 行是模板句 | 模型的具体句还没到（这一跳 p50 4.2 s，没达预算） | 模板句本来就是给你先开口的，念它；具体句到了会原地替换 |
还不行：菜单栏 🎧 →「导出诊断…」，桌面上会出现一个 zip（检查结果、日志末 300 行、设置；key 和许可证全部打码，里面没有任何能用的钥匙）；「反馈…」会顺手打开一封写好主题的邮件，把那个 zip 拖进去发给 leederek285@gmail.com，说清哪一场、看到什么。
数据存在哪，去了哪
全部在 ~/Documents/VoiceTranslator，只写本机（旧路径 ~/Documents/MeetingTranslator 留着一个软链，指向同一份）。删掉这个目录就是清空一切。
- .env 自己的 key（在偏好里贴进来的，只有你能读）
- settings.json 偏好与账户码
- meetings/ 每场一个目录：字幕流、会议信息、笔记
- phrases.json 短语库 · glossary.txt 术语表（可以直接用编辑器改）
- settings.json 全部设置 · metrics.jsonl 延迟事件
数据去向
- 本地链路与你的声音不出本机。
- 豆包链路：会议音频送到火山引擎（北京）识别。
- GLM：字幕文本送到智谱（北京）出建议与笔记。
没有账户，没有遥测。每个开始按钮旁边写着这一场的数据去哪。
试用、充值与退款
- 试用 5 分钟，每台设备一次，按处理时长算（听 + 谈 + 讲合计），不按天 —— 装着不用不会过期。任何链路都能用，包括云端最贵的那条：试用要让你看到最好的那一版。5 分钟里不要账号、不要邮箱；浮层状态行写着「试用 · 还剩 m:ss」。
- 之后按用量充值：$5 / $15 / $40 三档，充了不过期、用完再充。每条链一个时价 —— 本地 $0.01 / 小时，云端按成本三倍，自带 key 按本地价 —— 写在价目页，那张表从后端扣费的代码生成。美元结算，账单上的商户名是 Clize.ai。
- 账户码：首充给你一个账户码（TR1. 开头的一串字符），在另一台设备输同一个码就共用余额 —— 没有账号、没有密码。「输入账户码」在浮层的充值卡上：余额用完时它自己出现，贴进去就到账。
- 归零那一刻不劈开一场：这一段说完才停，充完接着记，同一场。断网时只有本地模型在跑，余额见底还能透支 60 分钟，连网后一起结。
- 买过 1.6.0 买断的：那个模式停了，已经买的按 $29 折成余额进你的账户 —— 输一次原来的许可证就到账，不用联系我们。
- 退款：写信到 support@voicetranslator.app。
- 充值以外的花费默认没有。自带 key 的话，那部分按量付给火山引擎和智谱，我们不经手，也不收钱。