规划报告与证据字段
读取最终路径、路径指标、规划目标和切片结果，并区分公开结果字段与内部诊断字段。
本页目录
优先依赖最终结果字段
| 结果类别 | 代表字段 | 用途 |
|---|---|---|
| 最终路径 | path（编码由 use_ssa 决定） | 保存、重放或交给执行器 |
| 路径质量 | PathStats 与 planner objective | 按同一 evaluator 比较完整路径 |
| 切片结果 | sliced legs、切片数量与每切片指标 | 验证显式 target_size |
| 调用设置 | preset、seed、objective 权重与切片模式 | 解释最终结果的公开条件 |
字段兼容性
内部诊断字段可能随实现变化；长期保存和下游程序应依赖本页列出的结果字段，或使用
ArcTNExecutionPlan。
报告与执行 artifact 不是同一种对象
| 对象 | 主要用途 | 能否直接长期重放 |
|---|---|---|
| arctn_schedule report | 检查路径、指标和搜索诊断 | 否；它不是稳定执行格式 |
| ArcTNExecutionPlan version 2 | 保存规范化网络、SSA path、切片集合和 target 声明 | 是；Python、Rust 与 CLI 共用核心执行字段 |
| execution-plan version 1 | 旧 CLI 计划，与外部网络 identity 绑定 | Rust/CLI 兼容读取；需要外部网络 |
| schema-less legacy path | 历史路径文件 | 仅显式允许；不属于默认安全格式 |
- version 2 固定 schema=arctn-execution-plan、schema_version=2、path_format=ssa-v1。
- network 保存 inputs、output 和有序 size_dict；sliced.legs 即执行时使用的 exact slice set。
- target_size 声明的是 max_intermediate_elements_per_slice，并与 memory_target_log2_elements 一致。
- metrics、planning 和 provenance 用于检查与来源追踪；执行安全仍以重新验证网络、路径、切片和 target 为准。
保存路径时的选择
| 格式 | 优点 | 注意 |
|---|---|---|
| SSA path | 编号稳定、适合 ArcTN 重放和 compiled execution | 每步产生新的 n+k 节点 |
| recycled linear path | 可直接交给 opt_einsum | 索引随每步删除和追加变化 |
| ContractionTree | 便于切片、可视化和第三方执行 | 依赖 Cotengra 对象语义 |
| ArcTNExecutionPlan v2 | 同时保存网络、SSA path、切片和 target 声明 | 推荐的跨进程重放格式 |