Pipeline Trace

需要审计采集或应用流程时，可以按需开启 trace，或显式传入 GFSavePipelineContext 在外部读取事件。

var payload_with_trace := save_graph.gather_scope(%SaveScope, {
    "include_pipeline_trace": true,
})

var pipeline_context := save_graph.create_pipeline_context(&"apply", %SaveScope)
save_graph.apply_scope(%SaveScope, payload, {
    "pipeline_context": pipeline_context,
})
print(pipeline_context.to_dict())

GFSavePipelineContext 只是流程事件日志，不是要保存的游戏数据。保存时应写入 gather_scope() 返回的 payload；pipeline_context.to_dict() 只适合写日志、测试断言或编辑器诊断面板。

trace 中的单条记录由 GFSavePipelineEvent 表示，包含阶段、严重级别、Scope key、Source key、节点路径、调试消息和附加载荷。导出 trace 时，shared 和事件 payload 会被转换为 JSON-safe 报告值，Object、Resource、循环集合和非有限数不会直接泄漏到日志。业务字段仍应放在项目自己的 payload 中，或由自定义 GFSaveSource 写入 SaveGraph payload。

需要把多个外部步骤纳入一次应用事务时，可以实现 GFSaveTransactionParticipant 并注册到 GFSavePipelineContext。参与者只暴露 prepare()、commit() 和 rollback() 三段协议，适合让项目侧缓存写入、动态实体恢复或外部存储适配器在 SaveGraph 应用失败时一起回滚；它不定义项目的存档模块、业务字段或冲突解决策略。