cdsl-cad/cadfs_to_cdsl/CADFS_CAPABILITY_SNAPSHOT_COMPARISON.md

# CADFS 全量能力快照对比

## 范围

本文档对比第一次归档的 CADFS 全量运行与最新归档的全量运行。两份快照均包含
9,347 个源样本。

| 快照 | 报告生成时间 | 证据目录 |
| --- | --- | --- |
| 第一次全量运行 | 2026-09-02 20:40:56 | `cadfs_to_cdsl/output-history/20260907-185128/` |
| 最新全量运行 | 2026-09-08 21:59:59 | `cadfs_to_cdsl/output-history/20260908-215959/` |

一个 executor 已注册，仅表示运行时能识别该原子操作；它本身不表示全部 CADFS
参数变体、拓扑 selector、body 生命周期或源模型都能正确重建。下文的全量比较与
能力缺口表才是实际覆盖范围的证据。

## 已注册的原子操作

| 原子操作组 | 第一次全量运行 | 最新全量运行 | 变化 |
| --- | --- | --- | --- |
| 基础实体 | `sphere_add` | `box_add`, `cylinder_add`, `sphere_add` | 新增方体与圆柱体 |
| 盲拉伸/加料拉伸 | `extrude_add_blind`, `extrude_add_two_sided` | 保留原有操作，新增 `extrude_add_blind_with_hole` | 新增 selector 绑定的端盖孔拉伸 |
| 切除拉伸 | `extrude_cut_blind` | 保留原有操作，新增 `extrude_cut_through`、`extrude_cut_two_sided` | 新增贯穿与双向切除 |
| 曲面拉伸 | 未注册 | `extrude_surface` | 新增仅生成曲面的拉伸路径 |
| 回转 | `revolve_add`, `revolve_cut` | 保留原有操作，新增 `revolve_surface` | 新增曲面回转路径 |
| 放样 | 未注册 | `loft_add`, `loft_add_with_cap_face` | 新增实体放样与 `CAP_FACE` 驱动放样 |
| 扫掠 | 未注册 | `sweep_add` | 新增实体扫掠路径 |
| 抽壳 | 未注册 | `shell` | 新增抽壳路径 |
| 多 body 布尔 | 未注册 | `boolean_bodies` | 新增 body 的 union/subtract/intersect |
| 孔 | `hole_blind`, `hole_counterbore`, `hole_countersink`, `hole_wizard` | 相同 | 无新原子操作 |
| 修饰特征 | `fillet`, `chamfer` | 相同 | 无新原子操作；覆盖和 selector 处理有改进 |
| 阵列 | `pattern_linear`, `pattern_mirror` | 保留原有操作，新增 `pattern_circular` | 新增环形阵列；replay/body 处理也有改进 |
| 基准几何 | `reference_plane`, `reference_axis` | 相同 | 无新原子操作；CADFS 基准面变体覆盖增加 |
| 螺纹 | 未注册 | `thread_add`, `thread_cut` | 新增加料/切除螺纹 |
| 钣金折弯 | 未注册 | `bend_add` | 已注册；这两份 CADFS 全量快照未单独证明其 CADFS 映射与几何接受率 |

## 全量能力覆盖

计数是被记录为能力缺口的样本数。减少表示更多样本进入支持的转换/运行时路径，
但不表示每个新增可执行模型都已通过几何验收。

| 类别 | 能力 | 第一次缺口 | 最新缺口 | 变化 | 当前解释 |
| --- | --- | ---: | ---: | ---: | --- |
| 新覆盖路径 | `revolve_surface` | 367 | 0 | -367 | 已观察到的样本均进入支持的运行时路径 |
| 新覆盖路径 | `extrude_cut_through_all` | 301 | 0 | -301 | 不再因贯穿切除产生此能力缺口 |
| 新覆盖路径 | `extrude_cut_two_sided` | 260 | 0 | -260 | 不再因双向切除产生此能力缺口 |
| 新覆盖路径 | `extrude_add_through_all` | 3 | 0 | -3 | 不再因贯穿加料产生此能力缺口 |
| 新覆盖路径 | `extrude_extent:up_to_next` | 48 | 0 | -48 | 不再因 up-to-next 产生此能力缺口 |
| 新覆盖路径 | `reference_plane:line_angle` | 121 | 0 | -121 | 不再因该基准面变体产生此能力缺口 |
| 新覆盖路径 | `reference_plane:plane_point` | 46 | 0 | -46 | 不再因该基准面变体产生此能力缺口 |
| 新覆盖路径 | `reference_plane:three_point` | 34 | 0 | -34 | 不再因该基准面变体产生此能力缺口 |
| 新覆盖路径 | `reference_plane:mid_plane` | 24 | 0 | -24 | 不再因该基准面变体产生此能力缺口 |
| 新覆盖路径 | `reference_plane:line_point` | 22 | 0 | -22 | 不再因该基准面变体产生此能力缺口 |
| 新覆盖路径 | `reference_plane:curve_point` | 12 | 0 | -12 | 不再因该基准面变体产生此能力缺口 |
| 主要覆盖提升 | `extrude` | 3,861 | 1,197 | -2,664 | 最大降幅；派生 profile 与 selector 变体仍待完成 |
| 主要覆盖提升 | `shell` | 696 | 57 | -639 | 主路径已存在；面选择器变体仍待完成 |
| 主要覆盖提升 | `fillet` | 1,914 | 1,417 | -497 | 覆盖增加；OCC 可行性和后继选择仍阻塞大量模型 |
| 主要覆盖提升 | `revolve` | 741 | 344 | -397 | 实体回转覆盖增加 |
| 主要覆盖提升 | `loft` | 308 | 68 | -240 | 主放样路径和部分 cap-face 形式已覆盖 |
| 主要覆盖提升 | `chamfer` | 589 | 381 | -208 | 覆盖增加；selector 与内核失败仍存在 |
| 主要覆盖提升 | `hole` | 623 | 386 | -237 | 更多孔变体进入运行时 |
| 主要覆盖提升 | `sweep` | 326 | 133 | -193 | 实体扫掠覆盖增加；路径变体仍待完成 |
| 主要覆盖提升 | `booleanBodies` | 187 | 92 | -95 | 多 body 路径覆盖增加 |
| 主要覆盖提升 | `cPlane` | 147 | 84 | -63 | 更多基准面路径成功 lower |
| 主要覆盖提升 | `mirror` | 262 | 158 | -104 | 阵列/body replay 覆盖增加 |
| 主要覆盖提升 | `circularPattern` | 228 | 74 | -154 | 阵列/body replay 覆盖增加 |
| 主要覆盖提升 | `transform` | 1 | 230 | +229 | 更多 transform 语义被识别并诊断；不代表完整支持 |
| 派生拓扑 | `extrude_profile_topology:cap_edge` | 133 | 91 | -42 | 部分 `CAP_EDGE` 覆盖 |
| 派生拓扑 | `extrude_profile_topology:cap_face` | 200 | 183 | -17 | 部分 `CAP_FACE` 覆盖 |
| 派生拓扑 | `extrude_profile_topology:intersect` | 382 | 362 | -20 | 部分 `INTERSECT` 覆盖 |
| 派生拓扑 | `extrude_profile_topology:offset_face` | 18 | 9 | -9 | 部分 `OFFSET_FACE` 覆盖 |
| 派生拓扑 | `extrude_profile_topology:swept_face` | 99 | 94 | -5 | 部分 `SWEPT_FACE` 覆盖 |

## 最新快照中新分类的未完成边界

这些条目在最新全量报告中被新分类或单独拆出。它们表示已知未完成语义，不能视为
已完成能力。

| 能力缺口 | 最新受影响样本 | 含义 |
| --- | ---: | --- |
| `shell_face_selector` | 221 | 这些 source history 的 shell remove-face selector 尚不能解析 |
| `delete_bodies` | 121 | body 生命周期中的删除语义不完整 |
| `sweep_path` | 68 | 扫掠路径变体尚不能表达或执行 |
| `shell_outward` | 19 | 向外抽壳方向尚未完成 |
| `extrude_draft_extent` | 15 | 带拔模拉伸的终止语义尚未完成 |
| `sweep_remove` | 6 | 扫掠切除语义尚未完成 |
| `circular_pattern_remove_source` | 1 | 环形阵列移除源 body 的生命周期尚未完成 |
| `extrude_cap_edge_profile` | 1 | `CAP_EDGE` 派生拉伸 profile 尚未完成 |

## 端到端结果

结果表区分可执行工件和几何验收。`RP` 是工程验收口径；`strict` 是更严格的诊断，
不能隐藏已 RP 通过的工件。

| 指标 | 第一次全量运行 | 最新全量运行 | 变化 |
| --- | ---: | ---: | ---: |
| 候选 CDSL 文件 | 8,108 | 8,633 | +525 |
| 完整转换 | 2,427 | 5,367 | +2,940 |
| 无可执行特征的 deferred | 2,602 | 693 | -1,909 |
| 重建 STEP 文件 | 1,812 | 6,134 | +4,322 |
| 比较报告 | 1,719 | 6,090 | +4,371 |
| RP 通过模型 | 1,159 (12.40%) | 2,031 (21.73%) | +872 |
| Strict 通过模型 | 578 (6.18%) | 905 (9.68%) | +327 |
| 比较超时或 worker 失败 | 56 | 44 | -12 |
| 已重建但几何拒绝 | 568 | 4,059 | +3,491 |
| 重建失败 | 617 | 2,144 | +1,527 |
| 解析/lowering 失败 | 3 | 21 | +18 |

当更多 partial 或原先不支持的 history 能进入 engine 后，被拒绝的 STEP 明显增加。
这些 STEP 工件和诊断必须保留；它们是 converter/runtime 的证据，不是验收通过的重建。

## 当前失败优先级

最新全量运行记录了以下主要重建失败类别。

| 失败类别 | 受影响重建 | 优先工作 |
| --- | ---: | --- |
| Selector 找不到 | 982 | 保留拓扑 provenance，实现精确的后继/output-role 绑定 |
| Fillet 内核失败 | 347 | 改善通用可行性处理，并保留有界 OCC 诊断 |
| Chamfer 内核失败 | 174 | 改善通用可行性处理，并保留有界 OCC 诊断 |
| BRep API 失败 | 139 | 调查操作特定的内核前置条件与拓扑输入 |
| Compound 拉伸不支持 | 83 | 完成显式多 body/Compound 的拉伸语义 |
| Selector 歧义 | 82 | 改善 selector provenance，确定性拒绝不唯一候选 |
| 终止目标不可达或空 | 71 | 完成以目标为基础的 extent/trim 语义 |
| Boolean 操作失败 | 98 | 完成通用多 body boolean 输入和结果生命周期 |
| Shell 操作失败 | 46 | 完成 remove-face 及向内/向外抽壳语义 |

## 状态

最新快照显示转换和可执行 STEP 覆盖已有明显扩展，但尚未完成全量重建。只有当一项
能力同时具备 FeatureScript lowering、CDSL contract、runtime/adapter 行为、selector/body
生命周期、单元覆盖、多个真实语料回归与 RP 比较证据时，才能标记为完成。

## 证据

- `cadfs_to_cdsl/output-history/20260907-185128/summary.json`
- `cadfs_to_cdsl/output-history/20260907-185128/full_run_report.md`
- `cadfs_to_cdsl/output-history/20260908-215959/summary.json`
- `cadfs_to_cdsl/output-history/20260908-215959/full_run_report.md`