CrossMeet / 使用指南
故障排查
按输入、引擎、授权和输出逐步排查 CrossMeet，保留本地数据并收集有用的错误信息。
更新于
先判断故障发生在哪一段，再一次修改一个设置。不要为排查问题直接删除整个用户数据目录；其中可能有会议、术语、声音资料与密钥保护文件。
安装或启动失败
- 确认安装包来自官方下载入口，核对版本、文件来源和签名信息。
- 查看磁盘空间、系统权限与安全软件提示。不要关闭防护或为整个目录添加排除项。
- 按客户端显示的运行环境检查处理缺失组件；组件或模型下载失败时，检查网络后重试。
- 正常退出并重新启动应用。仍白屏或无法连接本地服务时，保留错误信息并联系支持。
不要随意结束其他应用的 Python 进程，也不要照旧路径删除端口、令牌或数据库文件。
没有识别文字
- 检查选中的是麦克风、系统音频还是应用音频。
- 确认目标音源确实有声音，设备未静音，权限已允许。
- 查看当前 ASR 绑定和模型是否可用。
- 云端引擎还需检查凭据、余额和网络；本地引擎需检查模型与硬件状态。
- 用短音频重试，并留意客户端的错误提示。
识别出错误语种时，检查源语言设置。音频过小、噪声或断续也会影响结果。
原文正常，翻译异常
- 检查翻译用途的实际引擎绑定、目标语种与服务状态。
- 如果改过提示词，核对模板列出的变量，必要时恢复客户端提供的默认模板后重试。
- 检查输入是否已被识别错写，以及术语是否有冲突。
- 查看服务额度、请求限制和网络错误。
- 涉及关键数字、名称或承诺时，对照原文手工确认。
提示词变量和配置方式见引擎指南。本页不按固定速度或质量排名推荐某个外部模型。
TTS 没有声音
先区分“没有生成语音”和“声音去了其他设备”。
- 确认 TTS 引擎、音色及目标语种可用。
- 检查当前是本机播放还是虚拟麦输出。
- 检查输出设备、系统音量、静音和客户端错误。
- 若向会议软件输出，再检查会议软件中的输入端点。
具体路径见虚拟麦克风。出现回声时，检查输出是否又被输入回采。
知识库没有结果
确认条目启用、分类正确、嵌入配置有效，且向量生成完成。更换嵌入模型后可能需要重建。使用知识库的检索测试入口检查代表性问题。
结果与阈值、问题措辞和条目质量有关，不代表上传过资料就一定能命中。当前使用分类问答与兼容 JSON 导入，详见知识库指南。
激活、设备与续费
- 密钥无效：检查复制内容、订单状态与授权是否已撤销。
- 设备满额：到设备管理释放不再使用的设备。
- 授权到期：到订阅管理查看状态和可用操作。
- 网络校验失败：检查 HTTPS 连接、系统时间和组织防火墙策略。授权服务域名为
license.crossmeet.com。
不要在公开反馈中贴完整许可证密钥。详见激活与设备管理。
性能与模型
检查实际使用的模型、硬件和同时运行的任务。先减少并行工作，使用符合设备能力的配置，再测试同一段内容。首次加载模型可能比后续调用慢。
不要为所有模型套用同一个 GPU 驱动、显存或分段参数。安装器和客户端的对应引擎检查更适合当前配置。
历史与数据迁移
账户页不会自动同步本地历史。使用客户端已有的导出或备份方式迁移需要的内容。覆盖导入、清理模型或卸载前，先核对操作范围并备份。
本地数据默认位于当前 Windows 用户的应用数据目录，通常在 %APPDATA%\CrossMeet\ 下；不要依据旧文档假设所有数据库都在其根目录。
仍需要帮助
发送至 support@crossmeet.com，附：
- CrossMeet 版本与 Windows 版本。
- 出现问题的工作流、所选引擎与模型名称。
- 完整错误提示、发生时间与可复现步骤。
- 已经尝试的排查方法。
日志与截图只在你检查并去除敏感信息后发送。不要发送密码、API Key、许可证密钥、原始客户录音或未经检查的完整诊断包。