常见问题

1. 手机扫二维码后提示"绑定失败"

配对二维码有效期 10 分钟，超时后需要刷新。

解决方法：

1. 在电脑端 VoiceBridge Agent 窗口，点击"刷新二维码"。
2. 用手机重新扫描新的二维码，并在 10 分钟内点击"允许并绑定"。

如果仍然失败，可能是该电脑已被其他账号绑定。请确认当前登录的是你自己的账号。

2. 手机端录音时提示"无法访问麦克风"

浏览器需要获得麦克风权限才能录音。

iPhone / iPad（iOS Safari）：

1. 打开系统"设置" → "隐私与安全性" → "麦克风"。
2. 找到"Safari 浏览器"，打开开关。

Android（Chrome）：

1. 长按地址栏左侧的锁形图标 → "权限" → "麦克风" → 允许。
2. 或系统"设置" → "应用" → "Chrome" → "权限" → "麦克风"。

3. 录音完成但提示"没有录到声音"

通常是因为录音时间太短，或手机麦克风被其他 App 占用。

解决方法：

• 点击录音按钮后至少说话 1 秒再停止。
• 关闭可能占用麦克风的 App（微信语音、其他录音软件）。
• 检查手机是否处于静音模式（部分机型会禁用麦克风）。
• 插上耳机再试一次（排除手机麦克风硬件故障）。

4. 手机发送文字，电脑端没有反应

这通常是因为电脑端 VoiceBridge Agent 没运行，或网络断开。

排查步骤：

1. 确认电脑端 VoiceBridge Agent 窗口是打开的，状态显示"已上线"。
2. 如果状态显示"等待上线"，点击窗口内的刷新按钮。
3. 检查电脑和手机是否都能上网（可以分别打开任意网页测试）。
4. 如果手机端设备列表显示"（需更新）"，请重新下载最新版桌面客户端。

5. 语音识别提示"本月额度已用完"

免费版每月有 600 秒（10 分钟）的语音识别额度。用完后需要等到下个月 1 号自动重置，或升级到专业版。

• 免费版：每月 600 秒，单次最长 60 秒。
• 专业版：每月 18000 秒（5 小时），单次最长 60 秒。

可在账户设置 → "用量明细"查看剩余额度。

6. 语音识别准确率不高怎么办

语音识别的准确率受以下因素影响：

• 环境噪音：尽量在安静的环境录音，靠近手机说话。
• 语速和清晰度：正常语速、吐字清晰时效果最好。过快或含糊会降低准确率。
• 语言：目前针对普通话优化。方言或中英混杂可能效果不佳。
• 录音距离：手机离嘴 15-30 厘米效果最佳。距离过远或扬声器外放录音会影响效果。

7. macOS 提示"已复制，自动粘贴失败"

VoiceBridge 需要系统"辅助功能"权限来模拟键盘粘贴。这是 macOS 的安全机制。

开启方法：

1. 打开系统"设置" → "隐私与安全性" → "辅助功能"。
2. 在列表中找到 VoiceBridge Agent，打开开关。
3. 如果没有出现，点列表下方的"+"，手动添加 VoiceBridge Agent 应用。
4. 可能需要重启 VoiceBridge Agent 才能生效。

8. iPhone 上用 Safari 打开后无法录音

iOS 系统只允许在 Safari 浏览器中使用麦克风录音。如果你用的是 Chrome、微信内置浏览器等，录音功能无法使用。

正确做法：

1. 用系统自带的 Safari 打开 voicebridge-6kr.pages.dev。
2. 系统版本需 iOS 14.5 或更高。
3. 建议点击 Safari 底部的分享按钮 → "添加到主屏幕"，下次直接从桌面图标进入，体验更好。

9. 登录后提示"云端连接失败"

这通常是网络问题或登录会话过期导致的。

解决方法：

1. 刷新页面（下拉或重新打开网址）。
2. 如果仍然失败，退出登录后重新输入邮箱密码登录。
3. 检查手机网络是否能正常访问网页。
4. 如果你在使用 VPN，尝试关闭 VPN 后重试（部分 VPN 会拦截 Supabase 连接）。

10. 桌面端二维码一直显示"等待配对"

如果手机扫码后电脑一直没有反应，可能是二维码已失效或网络问题。

1. 在电脑端点击"刷新"按钮，重新生成二维码。
2. 确认电脑已联网（电脑端窗口不会主动显示网络状态，但需要联网才能完成配对）。
3. 如果你更换过电脑硬件或重装系统，可能需要先在手机端"账户设置 → 已连接设备"删除旧的电脑设备，再重新配对。