Kairo Code 桌面端故障排查
先阅读桌面应用显示的准确错误。在确认一次操作是否已修改文件、发送消息、提交表单或更新 外部系统前，不要反复重试。
应用无法打开
- 确认 Kairo Code.app 已放入“应用程序”，而不是仍从 DMG 窗口运行。
- 在 Finder 中按住 Control 点击 Kairo Code，macOS 要求确认受控预览版时选择“打开”。
- 本地服务反复退出时，在启动页选择“打开日志”，并记录版本行之后的第一条错误。
- 核对运行版本、源码修订与安装包附带的发布记录；不一致时停止使用并重装获批构建。
不要关闭 Gatekeeper、移除隔离属性或添加系统级安全例外。
任务无法开始或恢复
- 重新打开创建任务时使用的同一项目根目录，或同一组有序根目录。
- 检查任务是否等待审批或回答；“已阻塞”表示在等待你决定，不是后台运行。
- 如果应用报告本地服务失败，打开日志并只重启一次。持久历史仍保留，但执行中调用可能需要重新开始。
- 检查原任务文件和终态前，不要新建任务重复写入。
模型连接测试失败
打开 设置 → 个人 → 模型与提供商，选中连接并执行“测试连接”。
| 提示 | 检查项 |
|---|---|
| 认证失败 | 更换 provider 凭据，不要粘贴到任务或支持消息。 |
| 模型不可用 | 确认准确模型 ID 与账户权限。 |
| 触发限流 | 按 provider 给出的等待时间后再测试。 |
| 超时或端点不可用 | 检查 Base URL、VPN、代理与 provider 状态。 |
命令或工具被拒绝
重试前先阅读拒绝原因与当前权限配置。审批只能在项目根目录和管理员上限内授权屏幕上 显示的该次操作。
- 核对工具、参数、目标与请求时长。
- 操作非必要时，引导智能体使用范围更小的方案。
- 组织政策或必需沙箱阻止时，保留可见错误码并请管理员复核。
工作区写入 · 本地命令
执行前先看清将要发生什么
运行受影响测试等待决定
- 01检查动作
- 02单次或规则授权
- 03查看回执
Browser 停止或结果未知
即使 Kairo Code 没有收到结果，网站也可能已接受操作。再次点击、提交、付款、发布或发消息前， 必须检查可见页面与网站真实状态。
- 重定向或 origin 变化后，选中目标标签并复核新 origin 审批。
- 停止或重连已配对 Chrome 后，先检查页面再重试。
- 配对被撤销后，重新配对 Chrome，或为新任务明确选择内置 Browser；Kairo Code 不会静默切换 provider。
- Browser 容量已满时，只在审查文件与历史后永久删除无需任务。隐藏面板或归档不会释放未知效果回执。
记忆或子智能体状态不完整
记忆问题请打开 设置 → 高级 → 记忆与学习。同意设置只影响新任务，不会重写已有任务捕获的 政策。未解决的删除回执不是删除成功；保留回执，无法重试时联系支持。
子智能体问题请先打开协作视图，不要立即重复委派同一写入。重启应用会保留持久子任务历史， 但不会恢复内存中的调用。容量拒绝不会创建子任务；等待或停止现有子任务后再试。
插件无法激活
打开 设置 → 扩展 → 插件，重新打开失败插件，审查显示的能力变化与失败原因。激活只影响新任务， 已在运行的任务保留旧能力快照。
准备安全的支持报告
请提供准确的可见动作与错误、应用显示的版本与源码修订、项目根数与当前权限配置，以及通过 “打开日志”查看的最小相关片段。删除凭据、提示、源码、私密路径、内部端点与个人数据；不要附上完整 日志或未审查任务记录。
仍无法解决
停止受影响任务，联系组织批准的 Kairo Code 支持渠道。在支持完成审查前保留原项目与任务；删除它们可能移除 恢复所需的唯一持久证据。