本文详解AgentScope Workspace中保存当前运行结果的方法，涵盖MEMORY.md结构化写入与原始产出物存储，帮助开发者实现长任务中断恢复及子智能体结果捕获。
在AgentScope开发中，确保执行结果持久化到磁盘是保证长任务可恢复和上下文连续性的关键。本文将演示如何正确确认Workspace状态，并将结构化记忆与原始文件安全地保存到指定目录。
一、确认Workspace实例状态
在正式执行持久化操作前，验证 Workspace 环境的有效性是避免数据静默丢失的关键前置步骤。许多开发者容易忽略这一步，导致后续写入操作看似成功实则未落盘。因此，建议先调用 workspace.current() 获取当前实例对象。若返回值不为 None，说明 Workspace 上下文已激活，可以安全执行写入操作；若返回 None，则表明实例未初始化或已退出上下文，此时任何 write 操作都会静默失败，必须立即排查。
获取实例后，需进一步检查目录挂载情况。在终端执行 ls -l workspace/ 命令，直观确认文件系统状态。重点验证两个核心要素：一是根目录下是否存在 MEMORY.md 文件，这是结构化记忆的载体；二是是否包含 memory/ 子目录，用于存储历史会话数据。若发现上述任一要素缺失，说明 Workspace 未正确初始化。
注意：当检测到目录结构不完整时，切勿直接尝试写入，而应重新执行 workspace.init() 并传入有效的存储路径。这一步能确保底层文件系统句柄正确绑定，为后续将结构化记忆写入 MEMORY.md 及持久化原始产出物文件奠定坚实基础。只有确认环境就绪，才能保障长任务中断后的恢复逻辑正常运作。
二、保存结构化结果至MEMORY
确认 Workspace 环境就绪后，即可开始持久化结构化结果。MEMORY.md 作为第二层策展记忆，会在每次推理前自动注入上下文，因此其内容必须保持精炼且不可变。对于简单的调试或一次性任务，可以直接手动编辑文件：打开 workspace/MEMORY.md，在文件末尾插入以 ## [时间戳] 任务结果 开头的 Markdown 区块，并补充关键结论、核心参数及状态码。这种“只增不改”的原则至关重要，严禁删除或修改已有内容，以免破坏历史记录的完整性。
但在自动化流程或长任务中，手动编辑不仅效率低下，还容易因格式错误导致解析失败。此时推荐使用 API 安全写入，例如调用 workspace.memory.append("任务完成?", {"status": "success", "output_path": "output/report_v3.pdf"})。API 方式能自动处理 Markdown 格式标准化和元数据索引，确保数据结构的一致性与可读性。在并发场景下，API 内部通常包含锁机制或原子操作，能有效防止多进程同时写入导致的文件冲突或数据截断。若需存储更复杂的原始产出物文件，可参考下一节关于文件持久化的详细说明。
三、持久化原始产出物文件
结构化记忆解决了“状态”的保存，但原始的二进制文件（如生成的图表、PDF报告）体积较大且无法直接存入 Markdown 文本中。此时需要将这类产出物统一归档至 workspace/output/ 目录，并建立索引关联。
操作的第一步是确保目标目录存在，执行命令 mkdir -p workspace/output/ 即可安全创建目录结构，避免路径不存在导致的写入失败。第二步是文件复制与标准化命名。建议采用“语义_时间戳”的命名规范，例如将临时文件复制并重命名为 cp ./temp/chart.png workspace/output/chart_20260903_0822.png。这种命名方式不仅便于人类快速识别文件内容，也能防止多次运行产生的同名文件相互覆盖。
最后，必须完成关键的一步：在 MEMORY.md 中补充引用。在之前记录的任务结果区块下，添加一行如 - 图表见 output/chart_20260903_0822.png 的索引。这样，当智能体在后续会话中加载上下文时，既能读取到任务状态，又能通过相对路径精准定位到具体的二进制资源，实现从元数据到实体文件的完整闭环。
注意：路径引用请使用相对路径，避免硬编码绝对路径，以确保 Workspace 在不同机器或容器环境中迁移时的兼容性。
