AI Agent中断后精准接续任务需创建可定位、可验证、可恢复的执行快照，而非重读聊天记录；必须先调用create_session(project_id="fscloud-v2", user_id="u_7a9b")初始化Session，再发送消息；project_id须与代码仓库根目录名或CI/CD流水线ID严格一致；通过AGENTS.md自动加载、inject_context动态注入或~/.codex/AGENTS.md挂载全局上下文；启用longMemoryProvider并调用mark_for_persistence和save_checkpoint实现状态持久化；恢复时支持按Checkpoint名称或语义意图resume_from_checkpoint/resume_by_intent，并自动校验文件哈希一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space中让AI Agent中断后能准确接续任务，不是靠重读聊天记录，而是要主动创建可定位、可验证、可恢复的执行快照。否则每次重启都会从头分析项目结构、重复修改已生效的文件、再次运行已通过的测试。
初始化Session并绑定唯一项目标识
启动Agent前，必须调用create_session()并传入project_id与user_id参数，例如：create_session(project_id="fscloud-v2", user_id="u_7a9b")。
这一步必须在首次消息发送前完成。如果先发了用户提问再补建Session，已产生的message将无法自动归属到该Session，且多数SDK不提供手动迁移接口。
【project_id必须与代码仓库根目录名或CI/CD流水线ID严格一致】，否则AGENTS.md等上下文文件加载失败，Repo Memory模块无法匹配对应记忆。
注入结构化项目上下文
方法一：自动加载本地AGENTS.md文件
确保项目根目录存在AGENTS.md，内容控制在1200 tokens内——超长将触发静默截断，且不报错。
方法二：运行时动态注入关键约束
调用session.inject_context("constraint", {"db_compatibility": "v3.2+", "lang_preference": "TypeScript"})。该内容仅存活于当前Session生命周期，不会写入长期记忆。
方法三：挂载全局Codex-style上下文
在~/.codex/AGENTS.md中声明跨项目通用规则，如“✅ 所有生成代码必须含JSDoc注释”。若与项目级AGENTS.md冲突，以项目级为准。
持久化任务执行状态到长期记忆
第一步：确认longMemoryProvider已启用
检查Agent配置中openLongMemory是否为true，且longMemoryProvider明确设为MEMOS或Mem0。若为null或未配置，Session结束后所有状态将直接丢弃。
第二步：定义沉淀触发条件
在Session结束前调用session.mark_for_persistence(["user_preference", "arch_decision", "failed_fix"])。
第三步：显式保存Checkpoint快照
对长任务，在关键节点（如完成模块A修改、通过集成测试）调用session.save_checkpoint("stage_module_a_done", {step: 3, modified_files: ["src/user/service.ts"], test_passed: true})。该快照将被写入长期记忆，并附带时间戳与校验哈希。
恢复中断任务时精准定位断点
方法1：按Checkpoint名称恢复
调用session.resume_from_checkpoint("stage_module_a_done")，Agent将加载对应快照中的modified_files列表、test_passed状态及下一步动作建议。
方法2：按语义意图恢复
传入自然语言描述，如session.resume_by_intent("已改完用户服务层，正准备测权限模块")，系统会检索最近匹配的Checkpoint并校验环境一致性（如文件哈希、依赖版本）。
注意：恢复前会自动比对当前工作区文件哈希与Checkpoint中记录的哈希值，若不一致则拒绝恢复并提示“检测到手动修改，请确认是否覆盖”。
