常见问题与故障排查 (FAQ)
按真实默认快捷键与界面路径整理。多数问题可在 1–2 分钟内定位。
先读：引擎与模型 — 本地/云端如何选、下载镜像与可选代理、第三方 API 责任边界。
Q1: 启动后看不到字幕悬浮窗？
A
- 看托盘是否有 TransBox，双击托盘图标或菜单「显示/隐藏字幕窗口」；
- 试试老板键
Ctrl+Shift+H； - 多屏/分辨率变更后窗口可能在可视区外：从托盘或设置相关入口重置窗口位置，或先隐藏再显示。
Q2: 有字幕条但没有译文/原文？
A
上轨默认不自动启动。悬停控制条，至少打开 【译文】（可选 【原文】）。
若提示本地模型未下载或云端未配置 Key：到 设置中心 → 语音识别 / 机器翻译 下载模型或切换云端并填 Key，然后 保存并生效。
默认本地翻译模型为 腾讯混元 Hy-MT2-1.8B（约 3.6 GB）。详见 引擎与模型。
Q3: 快捷键和旧文章不一样，以哪个为准？
A 以 设置中心 → 快捷键 与本手册默认表为准：
| 功能 | 默认 |
|---|---|
| 老板键 | Ctrl+Shift+H |
| 快速同传 | Ctrl+Shift+T |
| 设置 | Ctrl+Shift+P |
| 历史 | Ctrl+Shift+Y |
| 鼠标穿透 | Alt+L |
| 原文 / 译文 | Alt+S / Alt+D |
| 朗读 | Ctrl+Shift+R |
| 出站模式 | Ctrl+Shift+V |
| 语言切换 | Ctrl+Shift+K |
Alt+Q、Alt+M、Alt+H 等不是当前默认。
Q4: 开了鼠标穿透后字幕条点不了？
A 再按一次 Alt+L 关闭穿透。穿透开启时点击会直接落到下层窗口，这是预期行为。
Q5: Zoom/腾讯会议里对方听不到我的译文？
A 按顺序检查：
- 字幕条已点 【双向通话】，发送形态为 注入译文；
- TransBox 注入输出 =
CABLE Input (VB-Audio Virtual Cable)； - 会议软件麦克风 =
CABLE Output (VB-Audio Virtual Cable)； - VB-CABLE 已安装且设置页检测通过（可用「自动配置驱动」）；
- 你的物理麦克风只给 TransBox，不要再被会议软件同时采集。
只想监听打字幕时，用默认监听/原声直通即可，不必装 CABLE。
Q6: 浏览器字幕模式没有「🌐 浏览器字幕」音源？
A
- 设置 → 浏览器字幕 打开服务（默认端口 8765）；
- 确认内置「浏览器原生字幕」插件未被停用；
- 安装扩展目录名为
browser-extension； - 刷新扩展工坊/重启浏览器后重试。
Q7: 朗读有回声或吵到别人？
A
- 控制条把 朗读设备 指到耳机；
- 保持 压低原音 开启；
- 通话场景避免把朗读设备指到 CABLE 造成环路。
Q8: 术语翻译错，人名/装备名不对？
A
使用或订阅 术语库 扩展。自建时优先 terms.json；若用 terms.txt，分隔符只能是 = 或 Tab，不能用 -> / =>。详见 工坊与词库。
Q9: 插件启用了但没效果？
A
- 主题/语言包是否被其他 full 主题或语言包互斥停用；
- 引擎类插件需在 ASR/MT/TTS 设置里选为当前引擎；
- 中间件/词库需保持启用状态；
- 仍异常：扩展工坊 安全重置 后逐个再开；代码类插件请只用可信来源。
Q10: 如何导出排错信息？
A
设置中心底部有 复制排错诊断信息 与 打开运行日志目录。反馈时附上日志与复现步骤，可发到 GitHub Issues 或 Steam 社区。
Q11: 本地模型下载很慢或失败？
A
- 设置 → 对应引擎 → 下载镜像源 选「国内高速镜像」；
- 仍失败可在下载卡片勾选 启用代理下载，地址按本机代理软件修改（常见
http://127.0.0.1:7897，端口未必相同）； - 海外用户一般用「全球官方节点」即可，不必开代理；
- 磁盘需预留：ASR 约 1.2 GB、MT 约 3.6 GB、TTS 约 350 MB。
Q12: 云端一直 429 / 连接失败？
A
- 确认 API Key、Base URL、模型名与厂商控制台一致，先点 测试连接；
- 限流按厂商主账号计（多 Key 合并），个人档并发通常够单人使用；共用一把 Key 会抢额度；
- 到厂商控制台查看配额/欠费，必要时提额；
- 这属于上游限制，TransBox 不代售也不托管该额度。详见 引擎与模型。
Q13: 软件是否包含云端费用？
A
不包含。 Steam 买断的是 TransBox 客户端使用权。
- 本地开源权重可免费下载使用（流量与磁盘自理）；
- 云端请自行在阿里云 / 腾讯云 / 小米等厂商开通并付费；
- 第三方模型名称、定价与可用性以各厂商公告为准。