概念/概念定义

从断点恢复开始

一份地图数据跑过识别、处理和发布后，进程意外中断。系统要回答已经完成什么、产物在哪里、下一步从哪里继续。只保留内存对象或终端日志，无法给出稳定答案。

定义

磁盘事实平面使用版本化文件合同保存阶段事实、运行状态和验收证据。进程之间传递路径与引用，不依赖不可恢复的共享内存对象。

玄宿案例包含三类核心文件：

• metadata.json 保存输入、处理结果和阶段产物引用；
• run-state.json 保存阶段状态、时间、退出码和恢复位置；
• verify_report.json 保存外部请求、内容检查和验收结论。

每类事实有唯一写入者，下游只读，不重新计算。控制台是这些事实的投影视图。

工程边界

该实现适合单机或受控共享磁盘环境。进入多机、多租户并发写后，事实合同应迁移到具备事务、锁与隔离能力的存储。概念的稳定部分是外置、版本化和可恢复的事实合同，磁盘只是案例中的载体。

来源与谱系

• 初始案例：玄宿科技 GIS 数据发布 Agent，案例提供熊钰柯（Yuke Xiong）。
• 历史近邻：file-based IPC、single source of truth、append-only state、materialized projection。
• ADPS 整理：区分阶段事实、运行状态和验收证据，并加入单写者约束。
• 定义地位：案例命名。