AGENTFLOW DOCUMENTATION
故障排查
先确认状态与来源,再采取恢复操作。
加入团队失败或空间内容不一致
- 找不到邀请:确认登录的是被邀请的用户名,打开“协作空间”查看。邀请不发送邮件;过期或撤销后需要重新邀请。
- 邀请提示角色冲突:先在“成员 → 待接受邀请”撤销原邀请,再选择新角色邀请。
- 看不到团队:接受邀请后从空间列表进入;已停用成员需管理员恢复或重新邀请,旧令牌不会自动恢复。
- 看不到任务或设备:先核对侧栏当前空间。个人数据不会自动迁移到团队,浏览器切换也不会移动连接器;请在团队内重新生成部署命令。
- 修改角色提示冲突:刷新成员列表后核对最新角色与状态,再操作;不能停用或降级最后一位启用的所有者。
- 无法修改密码:切回个人空间,在“设置 → 我的账号”操作。修改后需要重新登录个人和团队会话。
操作步骤见团队协作空间。
设备离线或没有可用 Agent
- 确认连接器进程仍在运行,工作台地址从开发机可达。
- 检查登录账号与浏览器是否一致;会话过期后重新登录启动。
- 确认 Agent 已安装并登录,可执行文件在连接器的 PATH 中。
- 确认代理支持 /api/realtime 的 WebSocket Upgrade。
云服务器设置 LOCAL_EXECUTION_ENABLED=false 时只提供工作台,需要在开发机运行连接器。
执行显示“结果待核对”
这表示指令可能已提交,但结果尚未确认。先检查来源设备的 Agent、连接器日志和代码变化,再使用原任务的状态核对入口。不要通过重发指令、另建会话或切换执行通道恢复。连接器保留本地持久回执以便核对。
工作目录或 Git 分支操作失败
检查代码仓库是否真实存在于目标设备,是否已公布或通过“选择目录”授权。跨设备交接不会复制代码。符号链接和路径跳转不能越出允许范围。
设备离线时不能提交新的 Git 操作;存在执行中、排队或结果未知的工作时不能切换分支。冲突需要在目标设备处理。常用目录记录不代替目录授权。
历史记录缺失或无法续聊
确认来源设备保持连接、历史目录配置正确,并且未关闭 WORKBENCH_SYNC_EXCERPTS。远端历史受已同步范围限制,旧图片不会自动全量回填。续聊取决于 Agent 能力和来源会话是否仍可恢复。无法恢复时核对原状态,错误不会静默降级。
页面、数据库或 Jira 异常
页面资源缺失时重新运行 pnpm build:client;环境修改后重启服务。数据库连接失败时检查 PGHOST、PGPORT、数据库账号及 vector 扩展,不要通过删除数据卷重试。
Jira 同步失败时检查凭据、项目权限和 JQL。公网证书错误应修复证书域名、有效期和信任链,不要禁用 TLS 校验。
提交问题时提供复现步骤、版本和脱敏错误。不要附上环境文件、令牌、数据库、原始会话记录或敏感附件。前往GitHub Issues。
发现问题或需要补充?在 GitHub 提交反馈 ↗