打开章节目录
本页目录

支持 / A 级核验

故障排查

按现象、检查、操作、预期结果整理常见问题,不用盲目重装。

目标:留下足够信息,让下一次排查能从证据开始。更新于 2026-09-20

没有模型或检索失败

  1. 检查端点是否可达,凭据是否仍有效。
  2. 确认协议和模型名称与服务方一致。
  3. 需要时使用手动输入模型,保存后重新测试连接。

项目未绑定

  1. 确认已通过“添加项目”选择目录。
  2. 新建项目会话并检查会话信息。
  3. 计划和目标模式必须绑定项目,切换回项目会话后重试。

工具、终端或 Git 不可用

  • 确认当前是桌面端而非浏览器预览。
  • 检查 Shell、Git 和工程工具链是否安装并可执行。
  • 远程 Git 操作还需要认证和网络。
  • 先保存实际错误,再决定是否修改配置。

截图、语音或浏览器失败

  • 截图:检查 Alt+Q 注册和系统授权。
  • 语音:检查麦克风、本地模型和首次下载。
  • 浏览器:检查自动化开关和 Chromium 依赖。

提交给维护者的信息

保留复现步骤、时间、界面入口、错误文本、桌面或预览环境。日志和截图中请删除 API Key、Cookie、私有端点和项目机密。