wangdequan
626bcfe8e3
结论：完成 LinuxCNC kinematics WASM ABI 覆盖，并将 web-rtcp-5axis-sim-plan 的 RTCP frame/boundary adapter 接到 xyzac-trt kinematics SDK；Node、build、browser smoke 验证通过。
387 lines
13 KiB
Plaintext
387 lines
13 KiB
Plaintext
configs/sim 全面测试下一步实施计划
|
||
|
||
生成时间：2026-06-09 15:00 CST
|
||
|
||
本计划接替 `text2.txt`。后续 `configs/sim` 相关工作以本文件为准。
|
||
|
||
目标定义：
|
||
|
||
- 这里的“全部完成全面测试”不等于“让 `linuxcnc/configs/sim` 下所有 `.ngc`
|
||
在 standalone `bin/rs274` 下全部 PASS”。
|
||
- 正确目标是：
|
||
1. 对 `configs/sim` 下所有 `.ngc` 建立完整 inventory；
|
||
2. 每个文件都被归入明确类别；
|
||
3. 每个类别都有正确入口点和验证层；
|
||
4. 能在 standalone native/WASM/browser 中运行的，必须补齐覆盖；
|
||
5. 不能在 standalone 路径中真实复现的，必须记录为 blocked，并写清依赖；
|
||
6. 不通过修改 G-code 语义、JS 解释逻辑、或 project-owned standalone
|
||
interpreter 语义让测试“看起来通过”。
|
||
|
||
项目纪律：
|
||
|
||
- CNC 语义来源只能是 LinuxCNC upstream 或 vendored LinuxCNC source。
|
||
- `configs/sim` 程序必须在完整上下文下判断：INI、tool table、parameter file、
|
||
`SUBROUTINE_PATH`、`USER_M_PATH`、remap-NGC、Python remap、task/runtime
|
||
边界都要按 LinuxCNC 真实归属处理。
|
||
- browser 不能依赖目录枚举；Node/browser staging 继续优先使用
|
||
`tools/source-manifest.txt` + INI 文本生成计划。
|
||
- 不为了“全面测试”而把 full-process / HAL / UI / linuxcncrsh / Python binding
|
||
误降级为 standalone interpreter file execution。
|
||
|
||
当前真实基线：
|
||
|
||
- Layer 2: `wasm-port/tests/native/verify_sim_configs.sh`
|
||
当前基线：`total 159, pass 151, expected_fail 8, unexpected_fail 0`。
|
||
- Layer 3: `wasm-port/tests/native/verify_native_probes.sh`
|
||
当前通过，已经覆盖代表性 runtime edge：
|
||
`axis/foam` U/V、bridge-mill W/remap、`axis/geometry` M110、
|
||
`axis/external_offsets` M111、`opa_demo.ngc -> circles.ngc`。
|
||
- Layer 4:
|
||
`wasm-port/tests/wasm/node/verify_sim_configs_wasm.sh`、
|
||
`wasm-port/tests/browser/verify_interp_browser.sh`、
|
||
`wasm-port/tests/host/verify_host_smokes.sh`
|
||
当前通过，但只覆盖 representative subset，不是全量 `configs/sim`。
|
||
|
||
当前已知剩余 expected failure：
|
||
|
||
- `axis/foam/foam.ngc`
|
||
native upstream standalone `rs274` 缺 U/V axis reader，上层 runtime 已覆盖。
|
||
- `axis/vismach/5axis/bridgemill/5axisgui.ngc`
|
||
native upstream standalone `rs274` 缺 W axis reader，上层 runtime 已覆盖。
|
||
- `axis/geometry/xyzc.ngc`
|
||
native upstream standalone `rs274` 缺 `USER_M_PATH` M110 注册，上层 runtime 已覆盖。
|
||
- `axis/external_offsets/dyn_demo.ngc`
|
||
- `axis/external_offsets/eoffsets.ngc`
|
||
- `axis/external_offsets/jwp_z.ngc`
|
||
- `axis/external_offsets/opa_demo.ngc`
|
||
native upstream standalone `rs274` 缺 `USER_M_PATH` M111 注册，上层 runtime 已覆盖；
|
||
其中 `opa_demo.ngc` 还依赖 `SUBROUTINE_PATH` `circles.ngc`，上层 runtime 已覆盖。
|
||
- `axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc`
|
||
保持 upstream demo expected failure；禁止通过修改 G-code 或 JS 解释逻辑让它 PASS。
|
||
|
||
全面测试还缺哪些工作：
|
||
|
||
1. 完整建立 `configs/sim` 程序级覆盖矩阵
|
||
|
||
当前问题：
|
||
|
||
- 我们有 harness summary，但还没有一份“每个 `.ngc` 的归属矩阵”：
|
||
哪些是 `main`、哪些是 `macro_load`、哪些是 `remap_subroutine`、
|
||
哪些只是 LinuxCNC native baseline、哪些已经进入 Layer 3、哪些已经进入 Layer 4、
|
||
哪些仍 blocked。
|
||
|
||
需要产出：
|
||
|
||
- 一份 tracked matrix，建议新增：
|
||
|
||
```text
|
||
wasm-port/docs/sim-configs-coverage-matrix.md
|
||
```
|
||
|
||
矩阵至少包含列：
|
||
|
||
- `path`
|
||
- `class`
|
||
- `native_rs274_status`
|
||
- `expected_failure_reason`
|
||
- `layer3_runtime_probe`
|
||
- `layer4_node`
|
||
- `layer4_browser`
|
||
- `blocked_dependency`
|
||
- `notes`
|
||
|
||
通过条件：
|
||
|
||
- `wasm-port/build/native/sim-configs/summary.tsv` 中所有 159 条记录都能映射到 matrix。
|
||
- matrix 中不能有“未分类”行。
|
||
|
||
2. 明确“全部”里的 blocked 边界，而不是继续误扩面
|
||
|
||
当前问题：
|
||
|
||
- `configs/sim` 下面并不是所有 `.ngc` 都应该被强行推进到 browser full execution。
|
||
- 还缺一份 `configs/sim` 专属 blocked policy，用来区分：
|
||
- pure interpreter / remap / INI-context 可移植程序；
|
||
- task/user-M/runtime edge 程序；
|
||
- Python remap/full-process/HAL/UI 依赖程序；
|
||
- demo edge / upstream malformed demo。
|
||
|
||
需要明确加入 blocked 的类：
|
||
|
||
- 任何本质依赖 linuxcncrsh、GUI driver、HAL process、实时 motion 状态反馈、
|
||
外部 userspace component、或 Python binding API 的 sim-config path。
|
||
- `mdi-*`、UI action、或只能通过 full task process 触发的配置流。
|
||
- 不能通过 NGC-only subpath 提纯的 Python/full-process config family。
|
||
|
||
执行：
|
||
|
||
- 从 `verify_sim_configs.sh` summary 和 `configs/sim` 路径结构出发，
|
||
逐目录补 blocked classification。
|
||
- 先补 family-level blocked，再细化到 program-level。
|
||
|
||
产出：
|
||
|
||
- 更新 `docs/linuxcnc-test-porting-tracker.md` blocked table；
|
||
- 更新 `docs/compatibility-validation.md` 的 `configs/sim` 边界说明；
|
||
- 在新 matrix 中写出每个 blocked 程序或目录的 dependency。
|
||
|
||
3. 把 representative coverage 扩展成 class coverage，而不是盲目追求全量 browser
|
||
|
||
当前问题：
|
||
|
||
- Layer 4 现在只覆盖 representative subset：
|
||
`foam`、`geometry`、`external_offsets`、bridge-mill。
|
||
- 这还不足以支撑“全面测试完成”的说法，因为 `configs/sim` 还包含多种 machine class：
|
||
- plain INI/tool-table/main program；
|
||
- Python remap main program；
|
||
- remap subroutine only；
|
||
- five-axis switchkins / TWP / TDR / TRT；
|
||
- macro-only config families；
|
||
- on_abort / macro load / tool-change style files。
|
||
|
||
实施原则：
|
||
|
||
- 不是把 159 个程序都复制进 browser smoke。
|
||
- 是每种独立 runtime class 至少补一个 native + Node + browser representative，
|
||
并且 class 到 program 的归因在 matrix 中完整记录。
|
||
|
||
最低还要补齐的 representative class：
|
||
|
||
- TWP `table-rotary_spindle-rotary-nutating`：
|
||
当前 native baseline 已有 14/15 passing inventory，但 Layer 4 还没有代表性 TWP
|
||
runtime smoke。
|
||
- gmoccapy Python remap family：
|
||
native inventory 已通过，但 Layer 4 还没有任何 gmoccapy representative。
|
||
- axis/laser Python remap family：
|
||
native inventory 已通过，但 Layer 4 还没有任何 laser representative。
|
||
- generic `macro_load` family：
|
||
当前 Layer 4 基本聚焦 main programs，缺少“宏文件只验证 load/parse，不伪造 main”
|
||
的 shared assertion。
|
||
- `on_abort` / deterministic user-action macro family：
|
||
当前 native inventory大量 PASS，但 Node/browser 尚未有独立 representative class。
|
||
|
||
通过条件：
|
||
|
||
- 每个 runtime class 在 `docs/sim-configs-coverage-matrix.md` 中都能对应至少一个
|
||
Layer 3/Layer 4 representative。
|
||
- 不要求 159 个程序全部进入 browser smoke；
|
||
但要求每个 class 都有代表 sample，且每个非代表 sample 都有“为什么不需要单独进
|
||
browser”的记录。
|
||
|
||
4. 补 `configs/sim` 专属全量 Node inventory runner
|
||
|
||
当前问题：
|
||
|
||
- Node 侧现在只有 representative smoke，没有一个“只跑能在 standalone/WASM
|
||
路径中合理成立的 `configs/sim` 全量 inventory”。
|
||
|
||
需要新增：
|
||
|
||
```text
|
||
wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
|
||
wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
|
||
```
|
||
|
||
职责：
|
||
|
||
- 读取 native `summary.tsv` 或同等来源；
|
||
- 只挑选：
|
||
- native PASS 条目；
|
||
- 以及 Layer 2 expected_fail 但 Layer 3/4 已知有 runtime adapter coverage 的条目；
|
||
- 跳过已标记 blocked 的 full-process/HAL/UI-only family；
|
||
- 对 Node WASM 做 inventory run；
|
||
- 输出 Node 侧 summary.tsv。
|
||
|
||
重要限制：
|
||
|
||
- 不把 browser 作为 first target；
|
||
- 不新增 JS CNC 语义；
|
||
- 不把 Python/full-process family 强行塞进 Emscripten，除非已存在 LinuxCNC-owned
|
||
runtime path。
|
||
|
||
通过条件：
|
||
|
||
- Node inventory summary 可重跑、可对比、可纳入 CI；
|
||
- unexpected failure 为 0；
|
||
- expected skip / blocked 有明确计数。
|
||
|
||
5. 再决定 browser inventory，而不是直接上全量 browser
|
||
|
||
当前问题：
|
||
|
||
- browser 环境成本高，且不能依赖目录枚举。
|
||
- 如果先做 browser 全量 inventory，会把大量问题混在 host boundary、
|
||
asset staging、Emscripten runtime、Playwright orchestration 里，定位价值低。
|
||
|
||
实施顺序：
|
||
|
||
- 先完成 Node inventory；
|
||
- 从 Node inventory 中挑出最有价值的 browser representative 扩展；
|
||
- browser 保持 focused class smoke，不追求一次性全量 159。
|
||
|
||
可以进入 browser 扩展候选的 class：
|
||
|
||
- TWP representative；
|
||
- gmoccapy Python remap representative；
|
||
- axis/laser representative；
|
||
- one deterministic macro-only family；
|
||
- one toolchange / on_abort family。
|
||
|
||
通过条件：
|
||
|
||
- browser 侧 class coverage 明确，不再只是 `foam/geometry/external_offsets/bridgemill`；
|
||
- 仍然保持稳定、可复现、非目录枚举。
|
||
|
||
6. 把 `verify_sim_configs.sh` 从 inventory 提升为 coverage source-of-truth
|
||
|
||
当前问题：
|
||
|
||
- native `summary.tsv` 已经是事实来源，但还缺少稳定的 machine-readable 统计，
|
||
用来支撑 docs、Node inventory 和后续 CI 对账。
|
||
|
||
需要增强：
|
||
|
||
- 保持 `summary.tsv` 不变；
|
||
- 增加稳定派生 artifact，建议：
|
||
|
||
```text
|
||
wasm-port/build/native/sim-configs/class-summary.tsv
|
||
wasm-port/build/native/sim-configs/path-matrix.tsv
|
||
```
|
||
|
||
最少字段：
|
||
|
||
- `path`
|
||
- `class`
|
||
- `status`
|
||
- `expected_failure`
|
||
- `ini`
|
||
- `tbl`
|
||
- `runtime_family`
|
||
- `blocked`
|
||
|
||
注意：
|
||
|
||
- 如果不想提交 generated artifact，就由脚本生成并由 docs 读取规则描述；
|
||
- 但字段模型要先定下来。
|
||
|
||
7. 清理 `configs/sim` 文档的“完成”定义
|
||
|
||
当前问题：
|
||
|
||
- 现有 `docs/sim-configs-completion-plan.md` 更多描述了“把当前大块 runtime edge
|
||
打通”的完成，不是“全面测试完成”的完成。
|
||
|
||
需要文档调整：
|
||
|
||
- 新增一节：`Definition of Done for Full configs/sim coverage`
|
||
- 明确：
|
||
- inventory complete
|
||
- blocked table complete
|
||
- native source-of-truth complete
|
||
- Node inventory complete
|
||
- browser class coverage complete
|
||
- every expected failure justified
|
||
- no accidental standalone semantic ownership
|
||
|
||
8. 最后再谈“还能不能把 Layer 2 的 8 个 expected_fail 变少”
|
||
|
||
原则：
|
||
|
||
- `foam` / `bridgemill` / `M110` / `M111` 这些 expected_fail 不是当前首要问题；
|
||
它们已经由 Layer 3/4 runtime path 证明。
|
||
- 只有当能够通过 vendored LinuxCNC source path 合法地把 native strict baseline
|
||
改造成更贴近 runtime 的入口点时，才讨论减少 expected_fail。
|
||
- 在那之前，不改 `verify_sim_configs.sh` 的语义口径，不把 expected_fail 硬改成 PASS。
|
||
|
||
优先级排序：
|
||
|
||
1. coverage matrix
|
||
2. blocked table
|
||
3. Node inventory
|
||
4. browser class expansion
|
||
5. docs done-definition
|
||
6. 再评估 Layer 2 baseline 是否需要新入口点
|
||
|
||
推荐执行顺序：
|
||
|
||
1. 先建立 coverage matrix
|
||
|
||
执行：
|
||
|
||
```bash
|
||
wasm-port/tests/native/verify_sim_configs.sh
|
||
cat wasm-port/build/native/sim-configs/summary.tsv
|
||
```
|
||
|
||
产出：
|
||
|
||
- 新增 `wasm-port/docs/sim-configs-coverage-matrix.md`
|
||
- 159 条记录全部分类
|
||
|
||
2. 再补 blocked table 和 class taxonomy
|
||
|
||
执行：
|
||
|
||
- 逐目录梳理 `linuxcnc/configs/sim`
|
||
- 对照 `verify_sim_configs.sh` summary
|
||
- 把 full-process/HAL/UI-only family 写进 tracker blocked table
|
||
|
||
产出：
|
||
|
||
- 更新 `docs/linuxcnc-test-porting-tracker.md`
|
||
- 更新 `docs/compatibility-validation.md`
|
||
|
||
3. 实施 Node inventory runner
|
||
|
||
执行：
|
||
|
||
```text
|
||
wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
|
||
wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
|
||
```
|
||
|
||
通过条件：
|
||
|
||
- Node inventory 只跑可移植条目
|
||
- unexpected failure = 0
|
||
|
||
4. 扩 browser class coverage
|
||
|
||
执行：
|
||
|
||
- 先补 TWP representative
|
||
- 再补 gmoccapy representative
|
||
- 再补 axis/laser representative
|
||
- 最后补 macro-only / on_abort representative
|
||
|
||
通过条件：
|
||
|
||
- `verify_interp_browser.sh` 和 `verify_host_smokes.sh` 仍稳定通过
|
||
- browser 不引入目录枚举
|
||
|
||
5. 更新完成定义和漂移控制
|
||
|
||
执行：
|
||
|
||
- 更新 `docs/sim-configs-completion-plan.md`
|
||
- 更新 `docs/compatibility-validation.md`
|
||
- 更新 `docs/source-reuse-map.md`
|
||
|
||
完成判定：
|
||
|
||
- `configs/sim` 每个 `.ngc` 都有明确分类；
|
||
- 每个类别都有合适层级的验证入口；
|
||
- blocked dependency 清单完整；
|
||
- Node inventory 可重跑；
|
||
- browser class coverage 覆盖所有重要 runtime family；
|
||
- Layer 2 的 8 个 expected_fail 都有稳定归因；
|
||
- 没有通过 project-owned CNC 语义让测试看起来通过。
|
||
|
||
不做事项：
|
||
|
||
- 不把 159 个程序全部塞进 browser smoke；
|
||
- 不把 full-process/HAL/UI/linuxcncrsh 依赖程序误降级为 standalone file execution；
|
||
- 不修改 `linuxcnc/configs/sim` upstream 文件；
|
||
- 不通过 JS 解释逻辑、临时字符串匹配、或 standalone `Interp::...` 新语义实现来换取 PASS。
|