必须调用create_session(project_id="fscloud-v2", user_id="u_7a9b")初始化Session并绑定项目标识，否则上下文丢失；AGENTS.md自动加载、inject_context动态注入、~/.codex/AGENTS.md全局挂载为三种上下文注入方式；启用longMemoryProvider并调用mark_for_persistence才能持久化状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space云端工作空间中持续运行AI项目时，必须确保多轮对话、工具调用和状态变更不因页面刷新、Session中断或模型重载而丢失原始上下文，否则项目结构、用户约束、代码偏好等关键信息将全部清空。
初始化Session并绑定唯一项目标识
启动Agent前，必须调用create_session()并显式传入project_id与user_id参数，例如：create_session(project_id="fscloud-v2", user_id="u_7a9b")。
这一步不可延后：若先发送用户消息再创建Session，已产生的message将无法自动归属，且多数SDK不提供手动迁移接口。
【project_id必须与代码仓库根目录名或CI/CD流水线ID严格一致】，否则AGENTS.md等上下文文件加载失败，MemoraX Code等记忆模块无法匹配Repo Memory。
注入结构化项目上下文
方法一：自动加载本地上下文文件
确保项目根目录存在AGENTS.md，Agent Space启动时会自动读取并注入system prompt。内容须控制在1200 tokens内，超长将触发静默截断，且不报错。
方法二：运行时动态注入关键约束
调用session.inject_context("constraint", {"db_compatibility": "v3.2+", "lang_preference": "TypeScript"})。该操作写入Session Memory层，参与后续所有LLM调用的上下文组装。注意：此方法注入的内容仅存活于当前Session生命周期，不会持久化到长期记忆。
方法三：挂载Codex-style全局上下文
在~/.codex/AGENTS.md中声明跨项目通用规则，例如“✅ 所有生成代码必须含JSDoc注释”。Agent Space会合并该文件与项目级AGENTS.md，但若两者冲突，以项目级为准。
持久化Session状态到长期记忆
第一步：确认longMemoryProvider已启用
检查Agent配置中openLongMemory是否为true，且longMemoryProvider明确设为MEMOS或Mem0。若为null或未配置，所有Session结束后的状态将直接丢弃。
第二步：定义沉淀触发条件
① 在Session结束前调用session.mark_for_persistence(["user_preference", "arch_decision", "failed_fix"])；
② 确保这些键名已在长期记忆Schema中注册，否则字段将被忽略；
③ 此操作仅标记状态，实际写入由后台异步完成，无需等待返回。
