AgentFlow
AGENTFLOW DOCUMENTATION

故障排查

先确认状态与来源,再采取恢复操作。

加入团队失败或空间内容不一致

  • 找不到邀请:确认登录的是被邀请的用户名,打开“协作空间”查看。邀请不发送邮件;过期或撤销后需要重新邀请。
  • 邀请提示角色冲突:先在“成员 → 待接受邀请”撤销原邀请,再选择新角色邀请。
  • 看不到团队:接受邀请后从空间列表进入;已停用成员需管理员恢复或重新邀请,旧令牌不会自动恢复。
  • 看不到任务或设备:先核对侧栏当前空间。个人数据不会自动迁移到团队,浏览器切换也不会移动连接器;请在团队内重新生成部署命令。
  • 修改角色提示冲突:刷新成员列表后核对最新角色与状态,再操作;不能停用或降级最后一位启用的所有者。
  • 无法修改密码:切回个人空间,在“设置 → 我的账号”操作。修改后需要重新登录个人和团队会话。

操作步骤见团队协作空间。

设备离线或没有可用 Agent

  1. 确认连接器进程仍在运行,工作台地址从开发机可达。
  2. 检查登录账号与浏览器是否一致;会话过期后重新登录启动。
  3. 确认 Agent 已安装并登录,可执行文件在连接器的 PATH 中。
  4. 确认代理支持 /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。