Agent Space文件恢复需先确认持久化路径，再从Transcript事件流重建文件状态，最后通过Git、云备份或手动提取内容恢复关键文件，并用完整性检查和初始化日志验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space项目文件意外丢失或中断后无法继续，需要从持久化存储中找回原始代码、配置和中间产物，而不是重新生成整个工作区。
确认当前Agent Space的持久化路径
打开终端，执行agenticfs status命令，查看输出中的workspace_root字段值。该路径即为当前Agent Space挂载的根目录，所有项目文件实际写入位置都在此之下。
若命令报错或未安装agenticfs CLI，直接检查~/.agenticfs/workspaces/目录，每个子目录名对应一个session_id，用ls -t按修改时间排序，最新创建的即为当前活跃空间。
【必须确认该路径未被手动清空或格式化】一旦底层存储被覆盖，文件将不可逆丢失。
从Transcript事件流重建文件状态
进入workspace根目录，定位memory/transcripts/子目录。此处存放以transcript-{session_id}.jsonl命名的追加日志文件。
使用tail -n 50 transcript-*.jsonl | jq 'select(.event_type == "tool_lifecycle" and .payload.status == "completed" and .payload.tool_name == "Write")'筛选最近完成的Write操作事件。
每条匹配结果中，.payload.file_path字段即为被写入的文件路径，.payload.content_hash（如有）可用于校验内容完整性。按step字段升序排列，可还原出最后一次完整保存的文件集合。
恢复单个关键文件
方法一：从本地Git仓库拉取
若项目初始化时已关联远程Git仓库，且最近一次git push成功，直接在workspace根目录执行：git fetch && git reset --hard origin/main。这会强制覆盖当前工作区为远程最新提交状态。
方法二：从云备份恢复
登录对应云服务控制台→选择“存储 > 云服务备份 > 文件备份”→找到与当前session_id匹配的资源名称→单击“恢复数据”→选择“当前位置”→确认。注意：【该操作会覆盖同名文件，不可撤销】
方法三：手动提取Transcript中的文件内容
对目标文件路径，在transcript-*.jsonl中搜索"file_path":"path/to/file.py"，定位到最近一条"event_type":"tool_lifecycle"且"status":"completed"的记录，复制其.payload.content字段值，粘贴保存为新文件。注意处理JSON转义字符，建议用jq -r '.payload.content' transcript.jsonl | sed 's/\n/
/g'解码换行。
验证恢复是否成功
第一步：运行agenticfs check-integrity --session <your_session_id></your_session_id>，检查workspace元数据与Transcript事件的一致性。
第二步：启动Agent Space，观察初始化日志中是否出现Loaded from checkpoint at step X字样，X应大于0。
第三步：在Agent界面中执行list_files .指令，确认关键源码、配置文件和memory/子目录存在且大小非零。
