排查智能体连接故障
智能体一直离线
Section titled “智能体一直离线”先停止后台服务，再在终端前台运行：
chorus daemon --verbose --chorus-only检查启动信息中的 Chorus 网址、智能体身份和运行后端。常见状态码：
401：API 密钥错误、过期或已撤销。重新运行chorus login。403：登录成功，但智能体没有执行当前操作所需的权限。请让管理员检查权限，不要直接改用管理员预设。
随后打开设置（Settings），查看在线智能体（Online Agents）的心跳是否更新。如果终端显示已连接而页面仍离线，请确认终端与浏览器访问的是同一个 Chorus 实例。
后台服务无法启动
Section titled “后台服务无法启动”chorus daemon statuschorus daemon logs重点检查：
- Claude Code、Codex 或 Kiro 命令是否已安装；
- 服务使用的
PATH是否能找到对应命令； ~/.chorus/daemon.json是否存在且当前用户可读；- 工作目录是否存在且当前用户有权访问。
修复后运行：
chorus daemon restart若仍然失败，请卸载服务，先在前台确认可以正常连接，再重新执行 chorus daemon install。
找不到正确的工作目录
Section titled “找不到正确的工作目录”展开在线智能体，确认目标目录已经列出。如果没有：
- 使用正确的
--cwd重新启动后台服务； - 若修改的是持久服务配置，请重启服务；
- 检查项目或任务是否固定到了另一台主机或另一个目录。
严格指定的连接离线时，Chorus 不会自动换用其他目录。请恢复原连接，或明确修改执行目标。
会话没有开始
Section titled “会话没有开始”确认智能体和工作目录均在线，并检查运行后端是否处于空闲状态。如果服务日志显示找不到平台命令，请修复安装或 PATH。如果日志显示权限不足，请检查智能体是否具有读取项目和更新任务所需的权限。
无法中断或恢复
Section titled “无法中断或恢复”中断和恢复操作必须发送给持有该会话的原连接。请确认：
- 原主机上的后台服务仍在线；
- 会话当前处于可中断或可恢复的状态；
- 原工作目录仍然存在；
- 没有在另一个目录中重复启动同一项工作。
重新执行前，请检查已经产生的文件修改，避免覆盖部分完成的结果。
问题解决后，请停止临时的前台进程，再按照管理后台服务恢复正常运行方式。