Heicode Docs

团队常见问题和故障处理

团队常见问题和故障处理

本页面向团队管理员和任务负责人。

成员看不到任务

可能原因:

  • 没有加入组织。
  • 没有项目权限。
  • 任务属于其他团队。
  • 账号登录错了。

处理:

  • 检查组织成员列表。
  • 检查成员角色。
  • 检查任务可见范围。
  • 让成员重新登录。

成员无法审批

可能原因:

  • 不是审批人。
  • 审批权限已撤销。
  • 审批已过期。
  • 操作需要更高级别审批。

处理:

  • 检查审批规则。
  • 增加备用审批人。
  • 重新发起审批。
  • 由 Owner 或 Admin 调整权限。

Agent 无法访问仓库

可能原因:

  • Git 授权过期。
  • 仓库权限不足。
  • 分支不存在。
  • 路径范围过窄。

处理:

  • 重新授权 Git。
  • 检查仓库权限。
  • 调整路径范围。
  • 重新启动任务。

任务失败太多

可能原因:

  • 任务过大。
  • 目标不清楚。
  • 资源不足。
  • 权限不足。
  • 测试环境不稳定。

处理:

  • 拆分任务。
  • 补充验收标准。
  • 补充资源。
  • 调整权限。
  • 先让 Agent 生成计划再执行。

审批无人处理

处理:

  • 检查审批人是否在线。
  • 检查审批人是否仍在组织。
  • 设置备用审批人。
  • 对过期审批重新发起。
  • 对紧急事项升级给 Owner。

预算消耗异常

处理:

  • 暂停任务。
  • 查看子 Agent 消耗。
  • 检查循环失败。
  • 降低模型成本。
  • 拆分任务。
  • 设置更低预算阈值。

生产部署失败

处理:

  1. 查看部署日志。
  2. 查看环境变量。
  3. 查看密钥引用。
  4. 查看云资源状态。
  5. 查看审批记录。
  6. 执行回滚。
  7. 创建修复任务。

疑似密钥泄漏

立即处理:

  1. 停止相关任务。
  2. 撤销凭证。
  3. 轮换密钥。
  4. 检查 Git、日志、Markdown 和截图。
  5. 通知 Security。
  6. 查看审计。
  7. 修复暴露位置。

团队不知道下一步做什么

建议看三个位置:

  • 任务状态。
  • 准备清单。
  • 待审批列表。

如果仍不清楚,让 Agent 先生成下一步计划,不要直接执行高危动作。

On this page