Agent Space文件不会自动保存，必须显式调用保存接口或启用自动同步策略，否则Session结束或刷新后所有编辑内容立即丢失。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space中的文件不会无条件自动保存，必须满足特定配置和操作路径才能触发持久化，否则所有编辑内容在Session结束或页面刷新后立即丢失。
Workspace默认行为：只缓存不落盘
Agent Space启动时会将项目文件加载到内存工作区（Workspace），所有编辑操作默认仅写入该内存副本。这一步无需手动干预，但【未显式调用保存接口或未启用自动同步策略时，文件系统磁盘上的原始文件完全不会更新】。
关闭浏览器标签页、强制刷新、或切换到其他项目卡片，都会导致当前Workspace中未提交的变更永久丢失——因为根本没有触发过任何磁盘写入动作。
启用自动保存的两种方式
方法一：开启Codex Cloud Sync绑定项目时勾选自动同步
在“Projects”面板→点击项目右上角“⋯”→选择“Settings”→打开“Auto-sync to Cloud Workspace”开关。启用后，每次在编辑器中按下Ctrl+S（或Cmd+S）即同步至云端沙箱，并在3秒内回写到本地项目根目录对应文件。
方法二：通过Agent指令触发强制落盘
在任意对话中输入指令：“请把当前workspace中所有已修改的.md和.ts文件保存到磁盘”，Agent会扫描workspace/dirty/标记列表，调用fs.writeFileSync批量写入。注意：【该指令仅对已被Agent识别为“dirty”的文件生效，手动在外部编辑器修改但未通知Agent的文件不会被纳入】。
Session级文件持久化的关键步骤
第一步：确认Session已绑定project_id
调用create_session(project_id="your-project-name")，project_id必须与本地项目根目录名完全一致，否则后续所有文件操作都找不到挂载点。
第二步：在Session结束前调用persist_async()
执行session.persist_async(["workspace/files/**/*.{md,ts,json}"])，该操作会将指定glob路径下的文件快照上传至MemOS长期记忆，下次用相同project_id重建Session时自动恢复。
第三步：检查workspace/.sync/last_commit文件时间戳
若该文件存在且mtime距今不超过60秒，说明最近一次自动同步成功；若不存在或超时，代表同步链路中断，需检查网络或重新触发sync命令。
