---
title: "规划报告与证据字段"
description: "读取最终路径、路径指标、规划目标和切片结果，并区分公开结果字段与内部诊断字段。"
eyebrow: "Reference"
---

## 优先依赖最终结果字段 {#levels}

| 结果类别 | 代表字段 | 用途 |
| --- | --- | --- |
| 最终路径 | path（编码由 use\_ssa 决定） | 保存、重放或交给执行器 |
| 路径质量 | PathStats 与 planner objective | 按同一 evaluator 比较完整路径 |
| 切片结果 | sliced legs、切片数量与每切片指标 | 验证显式 target\_size |
| 调用设置 | preset、seed、objective 权重与切片模式 | 解释最终结果的公开条件 |

> **字段兼容性**
>
> 内部诊断字段可能随实现变化；长期保存和下游程序应依赖本页列出的结果字段，或使用 `ArcTNExecutionPlan`。

## 报告与执行 artifact 不是同一种对象 {#artifacts}

| 对象 | 主要用途 | 能否直接长期重放 |
| --- | --- | --- |
| 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 为准。

## 保存路径时的选择 {#paths}

| 格式 | 优点 | 注意 |
| --- | --- | --- |
| SSA path | 编号稳定、适合 ArcTN 重放和 compiled execution | 每步产生新的 n+k 节点 |
| recycled linear path | 可直接交给 opt\_einsum | 索引随每步删除和追加变化 |
| ContractionTree | 便于切片、可视化和第三方执行 | 依赖 Cotengra 对象语义 |
| ArcTNExecutionPlan v2 | 同时保存网络、SSA path、切片和 target 声明 | 推荐的跨进程重放格式 |