项目与任务

项目定义 Kairo Code 可以在哪里工作；任务则在项目内保存一条由意图、操作、审批、结果和恢复 状态组成的持久历史。

创建项目

单仓库使用 Open Folder。一个目标需要多个相关目录时，选择 New Project 并逐个添加获授权 根目录。完整且有顺序的根目录集合构成工作区身份；打开一个同名目录不会静默加入另一个项目或 任务。

新建或恢复任务

每个独立目标创建新任务；新请求依赖既有决策、上下文或工作区改动时恢复原任务。任务历史能跨越 客户端断开与 Host 重启。置顶只改变导航，归档会从活动列表移走但保留历史；停止仅取消当前执行， 不会删除任务。

归档、停止与永久删除

操作	结果
停止	取消活动执行，任务、历史、工作区、附件和恢复状态仍可继续。
归档	从活动列表移除任务，可以再次恢复。
永久删除	不可逆删除持久任务聚合，释放浏览器绑定，再清理任务拥有的本地资源。

永久删除不会删除原始项目根目录中的普通文件，也不会删除已贡献到独立记忆集合的条目。确认前应 导出只存在于托管工作树中的差异和交付物。删除过程中，Kairo Code 先停止新活动和后台执行， 再提交权威任务聚合删除，然后释放浏览器绑定，最后清理发现元数据、工作树、交付物和本地文件。 任何权威证据无法读取或聚合删除失败都会显式报错，不会把不完整清理伪装成成功。

在执行中继续引导

轮次运行时仍可发送普通消息，它会持久记录并在下一个安全的模型或工具边界生效。当前方向必须 立即改变时使用 interrupt；不应继续执行时使用 stop。审批与用户输入请求会显示在同一任务中， 回复会绑定到发起请求的准确操作。

计划与审查

当实现依赖尚未确定的选择，或希望先批准方法再修改工作区时使用计划模式。计划是显式任务状态， 并非智能体回复中的任意步骤列表。实现结束后检查差异、行内评论、验证证据和未决审批，反馈仍回到 同一任务。

工作树与多个根目录

隔离工作树会作为任务执行环境被记录。多根项目为每个仓库保留稳定根键，使文件链接、差异、审查 意见和验证证据不会归属到错误仓库。