问题排查

​

新 Qoder App 安装失败

1. 升级 Qoder IDE 至最新版本；或卸载 Qoder IDE，前往 Qoder 官网下载最新版本。
2. 重新安装 Qoder App。

​

客户端无法启动

1. 确认操作系统和芯片架构符合要求。
2. 确认安装包来自可信的官方发布入口。
3. 重新启动客户端；仍失败时记录版本、操作系统和错误提示。

​

无法登录或在线能力不可用

1. 检查设备网络和系统时间。
2. 运行网络诊断，确认受影响的在线服务。
3. 确认代理、防火墙或安全软件未阻断 Qoder CN 所需连接。

​

Agent 找不到文件或操作了错误目录

1. 使用编程模式时，检查输入区显示的工作区和运行位置；使用通用模式时，检查所选文件夹。
2. 确认文件位于所选文件夹范围内且当前账号有读取权限。
3. 对相似目录使用绝对路径或在提示词中明确模块位置。
4. 检查代码库索引状态和排除规则。

​

命令或工具执行失败

1. 查看失败命令、退出码和错误输出。
2. 检查当前授权方式是否允许所需操作。
3. 检查系统权限、网络和凭证。
4. 不要通过扩大为完全访问来掩盖不明确的失败原因。

​

自动化没有执行

1. 确认自动化仍启用且时间设置正确。
2. 确认 Qoder CN 在执行时间运行，设备未离线或休眠。
3. 查看 自动化 → 执行记录 中的状态和失败信息。

​

扩展未生效

1. 确认 Skill、Plugin 或 Connector 已安装并启用。
2. 检查作用域、配置文件、凭证和网络连通性。
3. 对 Hooks 查看触发事件、匹配条件和日志。

如果按上述步骤仍无法解决，可通过问题反馈提交复现信息。