故障排查
CrossMeet 常见问题快速诊断与修复 —— 安装、激活、音频、ASR、LLM、网络、TTS、vMic。
最后更新：
2026-05-13
按问题分类排查。如本指南未覆盖，发邮件给 support@crossmeet.com 附上日志（%APPDATA%\CrossMeet\logs.db）。
1. 安装与启动
Q: 安装到一半失败
症状：installer 进度条卡住或弹错误
排查：
- 关闭杀毒（临时）
- 右键 installer → 以管理员身份运行
- 检查磁盘空间（C 盘需 1 GB+）
- 不要装到含中文路径的目录
Q: 启动后白屏 / 卡在 Loading
症状：图标双击后窗口出现但内容空白
排查：
- 删除
%APPDATA%\CrossMeet\backend.port，重启 - 检查
%APPDATA%\CrossMeet\logs.db（用 SQLite 浏览器打开） - 杀掉残留 Python 进程：任务管理器搜
cm-backend.exe杀掉 - 仍不行：卸载 → 删
%APPDATA%\CrossMeet\→ 重装
Q: "Backend not responding"
症状：UI 红色错误条
排查：
- Settings → System → Restart Backend
- 检查防火墙是否拦截
cm-backend.exe（应该只在 127.0.0.1 监听） - 查 logs：搜索
[FATAL]字符串
Q: Python 运行时下载失败
症状：首次启动卡在"Preparing Python runtime"
排查：
- 切换网络（公司 VPN 可能拦截 PyPI）
- Settings → Advanced → PyPI Mirror → 选择清华 / 阿里云镜像
- 手动下载 runtime：见 [离线安装包]（待补）
2. 激活问题
Q: "Invalid license key"
- 检查 key 拼写（避免 0/O、1/I、l/1 混淆）
- 检查 key 是否已退款失效
- 联系 support@crossmeet.com 验证
Q: "Device limit exceeded"
- 已用满设备配额，释放旧设备（激活文档 §5/§6）
- 或联系 support 申请扩容
Q: "License expired"
- 检查 my.crossmeet.com → Subscription 状态
- 检查电脑时间是否准确（差太多签名校验失败）
- 检查心跳：Settings → Licensing → Last heartbeat 时间戳
3. ASR（识别）问题
Q: 识别全是乱码 / 错语种
- Settings → ASR → Language 强制指定（不要 auto）
- 检查麦克风电平：Settings → Audio → 看输入波形
Q: 经常断句过早
- Settings → ASR → Advanced → vad_threshold 调高（0.4-0.5）
- 或 min_silence_ms 调大（700-1000）
Q: 经常断句太晚 / 一整段不断
- vad_threshold 调低（0.2）
- min_silence_ms 调小（300）
Q: 漏字 / 部分句子缺失
- 检查 CPU 占用：本地 Whisper 跑不动会丢句
- 切换到 medium 模型（大模型在弱 CPU 上跟不上）
- 启用 GPU 加速
Q: 中文识别质量差
- 切换到阿里云 ASR 或 Qwen3-ASR（中文最佳）
- 本地 Whisper 用 large-v3-turbo（中文优化版）
4. LLM（翻译）问题
Q: 翻译漏字 / 截断
- 检查 prompt 是否完整：Settings → LLM → Prompt Template 看是否有
{text}占位符 - Glossary 太大塞爆 context：删除不相关术语
- 切换更大 context 的模型（Gemini 1.5 Pro 1M）
Q: 翻译速度慢
- GPT-4o-mini > Claude Sonnet > Claude Opus（速度依次降低）
- 关闭 RAG（如果开了 KB）测试是否是检索慢
- 检查网络延迟到 api.openai.com
Q: 翻译质量差 / AI 翻译腔
- 升级到 Claude 3.5 Sonnet
- 加 Glossary 锁定关键词
- 启用 RAG 注入业务上下文
- 修改 prompt template 加风格示例（Few-shot）
Q: 偶尔输出 JSON 或 markdown 格式
- 修改 prompt 末尾：
Output ONLY the translation, no explanation, no JSON, no markdown:
5. TTS（合成）问题
Q: TTS 没声音
- 检查 Settings → Audio → Output Device
- 检查 TTS 引擎是否选对：Settings → TTS
- 看本地预览：Settings → Audio → Test TTS
Q: TTS 卡顿 / 中断
- 切换到云引擎（本地 ChatTTS 慢）
- 检查网络稳定性
- 调小一次合成的字符数（Settings → TTS → max_chars_per_request）
Q: TTS 音色不对
- Settings → TTS → 选不同音色
- ElevenLabs 的话调高 stability 参数
6. vMic（虚拟麦克风）问题
Q: Zoom / Teams 听不到 TTS
- Zoom 麦克风必须选
CrossMeet Virtual Microphone - 不要选
CrossMeet Virtual Microphone (loopback) - 测试：CrossMeet → Settings → Audio → Test vMic
Q: 对方反馈听到 echo
- 关闭 Zoom "Original sound for musicians"
- 你的物理麦不要选成 vMic loopback
Q: 安装驱动后蓝屏
- 卸载 CrossMeet → 重启 → 装最新版（驱动 v2 修复了几个问题）
- 仍蓝屏：邮件 + minidump 给 support
Q: 驱动卸载残留
- 设备管理器 → 音频输入输出 → 右键
CrossMeet Virtual Microphone→ 卸载设备 - 勾选"删除驱动软件"
7. 网络与同步
Q: 显示"无法连接到 license server"
- 检查 api.crossmeet.com 是否可达：
ping api.crossmeet.com - 检查防火墙
- 公司网络：Settings → Networking → 配置代理
Q: 历史记录没自动同步
- Cloud Sync 是付费功能，确认 my.crossmeet.com 已购买
- 检查 Settings → Sync → Status
- 强制同步：右上角 sync 图标右键 → Force Sync Now
8. 性能问题
Q: CPU 占用过高
- 关闭本地 Whisper（用云端）或换 base 模型
- 关闭 RAG（如果文档很多）
- 任务管理器：是不是
cm-backend.exe占用？看 log 找原因
Q: 内存占用增长（疑似泄漏）
- 重启应用（短期解决）
- 上报：Settings → Help → Report Issue 自动附上 memory profile
Q: GPU 不工作
- NVIDIA 驱动 ≥ 525 + CUDA 12.x
- Settings → ASR → Advanced → Use CUDA 勾选
- nvidia-smi 命令看 GPU 是否有进程
9. 数据与隐私
Q: 历史记录在哪？怎么导出？
- 位置：
%APPDATA%\CrossMeet\crossmeet.db（SQLite） - 导出：主界面 → History → 选会话 → Export → Markdown / PDF / DOCX
Q: 怎么清除所有数据？
- 完整重置：卸载 → 删
%APPDATA%\CrossMeet\→ 重装 - 只删历史：主界面 History → 多选 → Delete
Q: 数据会上传到云端吗？
- 默认全部本地。ASR 音频、翻译内容不上传到 CrossMeet 服务器
- 云端 LLM / ASR API 由你的 API key 控制（与 CrossMeet 服务器无关）
10. 还是没解决？
- 收集信息：
- Settings → Help → Generate Diagnostic Bundle → 自动打包 logs + 配置（去除敏感信息）
- 发邮件到 support@crossmeet.com，附 bundle
- 紧急问题：community.crossmeet.com 提问
- Pro / Lifetime / Enterprise 用户：VIP 通道（24h 响应承诺）