wangdequan/linuxcncWebWASM
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Complete 3axis tutorial native and Web/WASM parity tools

Browse Source
This commit is contained in:
wangdequan
2026-08-24 14:01:30 +08:00
parent 938654b19d
commit 7e90142b63
147 changed files with 17639 additions and 557 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/task-history.md
View File

@@ -104,11 +104,11 @@
| `S8-03` | verified：真实执行 `xz.ini`、`xz_both.ini`、`xz_both_auto.ini` 取得 `xz.var` 和三份生成 HAL fixture；同案例 `xz.tbl` 精确复用；三案 Worker startup 均 `TASK_READY`、HAL blocked_count=0，identity/BOTH/AUTO state hash 分别保留 | `coverage/sim-case-batch-s8-03.report.json`, `web/worker/test_sim_case_batch_s8_03.mjs`, `scripts/generate_sim_case_batch_s8_03.py`, `scripts/test_sim_case_batch_s8_03.py` |
| `S8-04` | verified：minimal_xyz 真实 fixture 达到 TASK_READY；固定 tick 覆盖 Home/Jog/override、G-code Run/Pause/Resume/Abort/Restart、MDI、estop/recover 和 checkpoint recovery endpoint parity；前端 AppShell/state panel/machine view 继续消费 Worker 权威状态 | `coverage/minimal-xyz-vertical-s8-04.report.json`, `web/worker/test_minimal_xyz_vertical_s8_04.mjs`, `scripts/generate_minimal_xyz_vertical_s8_04.py`, `scripts/test_minimal_xyz_vertical_s8_04.py` |
| `S8-05` | verified：`corexy_by_kins.ini` 与 `corexy_by_hal.ini` 均使用真实 fixtures 达到 TASK_READY；同一 pose `[4,2,3]` 映射 joints `[6,2,3]`，HAL records 72/100，1x/fast/recovery parity 均通过；kins path 与 HAL-trivkins transform path 保持明确区分，未知 HAL 命令仍 fail-closed | `coverage/corexy-dual-path-s8-05.report.json`, `web/worker/test_corexy_dual_path_s8_05.mjs`, `scripts/generate_corexy_dual_path_s8_05.py`, `scripts/test_corexy_dual_path_s8_05.py`, `web/workspace/hal-configuration.mjs` |
| `S8-06` | verified：235 个真实 `configs/sim` 案例全部执行 exact-path loader/startup 两次；分类为 TASK_READY=7、BLOCKED_RESOURCE=221、BLOCKED_HAL=4、BLOCKED_INI=3；每案保留 fixture、missing、first diagnostic、resource/HAL counts 和 deterministic state hash，不把 blocked 提升为 ready | `coverage/sim-case-matrix-s8-06.report.json`, `web/worker/test_sim_case_matrix_s8_06.mjs`, `scripts/generate_sim_case_matrix_s8_06.py`, `scripts/test_sim_case_matrix_s8_06.py` |
| `S8-06` | verified：235 个真实 `configs/sim` 案例全部执行 exact-path loader/startup 两次；按 LinuxCNC source 语义处理 optional `DISPLAY/OPEN_FILE`、缺失 HALFILE 分类和真实路径；分类为 TASK_READY=96、BLOCKED_RESOURCE=11、BLOCKED_HAL=106、BLOCKED_INI=19、BLOCKED_STARTUP=3；每案保留 fixture、missing、first diagnostic、resource/HAL counts 和 deterministic state hash | `coverage/sim-case-matrix-s8-06.report.json`, `web/worker/test_sim_case_matrix_s8_06.mjs`, `scripts/generate_sim_case_matrix_s8_06.py`, `scripts/test_sim_case_matrix_s8_06.py`, `web/workspace/sim-case-loader.mjs` |
| `S8-07` | verified：从真实 INI/include declarations 生成 235-case display family catalog；Axis 85、QtVCP 61、Gscreen 14、VisMach 21、GladeVCP 6、Touchy 6、PyVCP 5、other 37；AppShell 按案例显示 family capabilities/host plugin boundaries，未改变 Worker 权威状态或 blocked 语义 | `coverage/sim-display-families-s8-07.report.json`, `web/app/sim-display-families.mjs`, `web/app/display-family.mjs`, `web/app/test_display_family_s8_07.mjs`, `scripts/generate_sim_display_families_s8_07.py`, `scripts/test_sim_display_families_s8_07.py` |
| `S8-08` | verified：ldelta/rdelta 真实案例通过 HALLIB exact resolution、sim.var/sim.tbl fixtures、lineardelta/rotarydelta virtual adapters；nominal joints `[300,300,300]`/`[10,10,10]`、1x/fast/recovery parity 和 TASK_READY 通过，official oracle 与其它机床族边界保留 | `coverage/machine-families-s8-08.report.json`, `web/worker/test_machine_families_s8_08.mjs`, `scripts/generate_machine_families_s8_08.py`, `scripts/test_machine_families_s8_08.py` |
| `S8-09` | verified：10 个真实 Worker runtime extension runners 全部通过，覆盖 remap/O-word/filter、Python callbacks、tool/probe/IO ack、virtual devices 和 PLC；固定 tick、能力拒绝和 recovery/ack 边界保留，host Python/dynamic loader 不被误报为浏览器 parity | `coverage/runtime-extensions-s8-09.report.json`, `scripts/generate_runtime_extensions_s8_09.py`, `scripts/test_runtime_extensions_s8_09.py` |
| `S8-10` | blocked（正式停止条件）：资源运行时语义修复后重新聚合 235-case acceptance；95 个案例 TASK_READY、140 个案例保留 HAL/INI/资源/STARTUP blockers，WASM/native/Worker/App 技术回归通过；official full LinuxCNC oracle 仍 source-gated，Chromium/Firefox/Safari minimums 仍 TBD/Safari unavailable，OPFS recovery 仍 blocked；implementation coverage=verified、acceptance=blocked、`STOP_RELEASE`，不宣称 LinuxCNC 全功能 release | `coverage/full-case-acceptance-s8-10.report.json`, `scripts/generate_full_case_acceptance_s8_10.py`, `scripts/test_full_case_acceptance_s8_10.py`, `nextTask1.md` |
| `S8-10` | blocked（正式停止条件）：按修复后的 source-backed 235-case matrix 重新聚合；96 个案例 TASK_READY、139 个案例保留 HAL/INI/资源/STARTUP blockers，WASM/native/Worker/App 技术回归通过；official full LinuxCNC oracle 仍 source-gated，Chromium/Firefox/Safari minimums 仍 TBD/Safari unavailable，OPFS recovery 仍 blocked；implementation coverage=verified、acceptance=blocked、`STOP_RELEASE`，不宣称 LinuxCNC 全功能 release | `coverage/full-case-acceptance-s8-10.report.json`（`b2230390241a9fb8fb723af3847baeec251e8b49526d264c8bd5ccef4e5d3133`）, `scripts/generate_full_case_acceptance_s8_10.py`, `scripts/test_full_case_acceptance_s8_10.py`, `nextTask1.md` |
| `TUTORIAL-00` | verified：固定唯一案例 `linuxcnc/configs/sim/axis/vismach/3axis-tutorial`；隔离目录先运行官方 `update_ini -f`，再以真实 DISPLAY 启动 LinuxCNC；AXIS `axis/Axis` 窗口 1300x1293 可见；Web exact bundle/Worker `TASK_READY` 和功能操作序列通过，Vismach executable 作为唯一 `WEB-EQUIV` model adapter 资源加载 | `coverage/axis3-tutorial-native-run.report.json`, `scripts/run_axis3_tutorial_native.py`, `web/worker/test_axis3_selected_case.mjs`, `docs/linuxcnc-web-wasm-3axis-tutorial-parity.md` |
| `TUTORIAL-01` | in_progress：锁定 4 个案例源文件、运行时 `.var/.bak/position_mm.txt` 生成规则、共享 intro graphic、HAL source lines 和 Vismach Python imports；下一步生成 exact resource/source graph 自哈希报告 | `docs/linuxcnc-web-wasm-3axis-tutorial-parity.md`, `linuxcnc/configs/sim/axis/vismach/3axis-tutorial`, `linuxcnc/lib/python/vismach.py`, `linuxcnc/lib/python/hal.py` |
| `TUTORIAL-01..03` | verified：3axis tutorial exact resource graph、Vismach `loadusr ./3axis-tutorial` 唯一 `WEB-EQUIV` HAL adapter、startup phase `NEW→TASK_READY` 和 deterministic loader/startup hash 通过；运行时 `3axis-tutorial_mm.var` 在 workspace exact path 生成 | `coverage/axis3-tutorial-resource-graph.report.json`, `web/worker/test_axis3_tutorial_hal_adapter.mjs`, `web/worker/test_axis3_tutorial_startup.mjs`, `scripts/test_axis3_tutorial_resource_graph.py`, `scripts/test_axis3_tutorial_hal_adapter.py`, `scripts/test_axis3_tutorial_startup.py` |
@@ -119,6 +119,13 @@
| `TUTORIAL-12` | verified：参考 AXIS/QtVCP 源码遵循案例未定义 `HOME_SEQUENCE` 时的 individual home 语义，真实 native 按 `Z -> X -> Y` home；参考 `hal_manualtoolchange.py` 的 `change_button` pin，通过真实 HAL ACK 完成 T1 M6；native/Worker 同序列无首差，保留 source-defined semantics | `coverage/axis3-tutorial-sequence.report.json`, `coverage/axis3-tutorial-native-sequence.report.json`, `web/worker/test_axis3_tutorial_sequence.mjs`, `scripts/run_axis3_tutorial_native_sequence.py` |
| `TUTORIAL-13` | verified：修复 program recovery replay 顺序，selected case checkpoint 后连续/recovered endpoint hash 相等；坏 checkpoint fail-closed，runtime `.var/tool.tbl/position` policy 和无重复副作用均有证据 | `coverage/axis3-tutorial-persistence.report.json`（`a2d125b06fe81ad8442c3b2b1f766e2a01e8a3160b4738ebc1cba59f565800f2`）, `web/worker/test_axis3_tutorial_persistence.mjs`, `web/worker/sim-session.mjs` |
| `TUTORIAL-14` | verified（selected-case closure index）：所有 native/Worker/Chromium/tool-IO/persistence/sequence 证据冻结；native individual home 和 `change_button` tool ACK 已按源程序语义闭合；release action 仍为 `STOP_RELEASE`，外部浏览器/OPFS/硬件边界独立保留 | `coverage/axis3-tutorial-closure-index.report.json`, `scripts/generate_axis3_tutorial_closure_index.py`, `scripts/test_axis3_tutorial_closure_index.py` |
| `T3-COMPLETE-01` | verified（selected-case scope）：`3axis-tutorial` trivkins 运行期间 pose/velocity/queue depth 由 WASM `sim_motion_queue` 驱动；JS `AuthoritativeRuntime` authority 调用为 0；pause/resume/PROGRAM_STEP/abort、queue drain completion、checkpoint/trace import/recovery endpoint parity 和 damaged queue fail-closed 通过。非 selected-case compatibility mirror、T4 task/motion/HAL/IO canonical state、全量矩阵和 release blockers 保持 blocked；LinuxCNC source matrix 的旧 fixture drift 已由 loader 源语义修复 | `coverage/wasm-motion-authority-t3.report.json`（`8424f3bae26ff0b16868ddc1dde4f40e14fc64288aea3d9aba983cc46d62c967`）, `web/worker/test_wasm_motion_authority.mjs`, `web/worker/test_wasm_motion_checkpoint.mjs`, `scripts/generate_wasm_motion_authority_t3.py`, `coverage/wasm-only-source-audit.report.json` |
| `T4-CANONICAL-STATE-01` | verified（selected-case scope）：`SimTask` 通过 `sim_task_canonical` 成为 Worker task authority；`WasmHomeLimit` 通过锁定 `sim_kinematics_home_limit_*` ABI 成为 trivkins home/limit authority；snapshot、HOME/JOG/LIMIT、checkpoint、trace/import/recovery 的 task/motion/home-limit state hash 稳定，JS task tamper 被 WASM canonical 覆盖，损坏 home-limit state fail-closed。HAL/IO/tool/probe、外部设备输入、非 selected-case compatibility 和全量 release 仍 blocked | `coverage/wasm-canonical-state-t4.report.json`（`5f51ea1f766d7e3bf336c3dd11575a97fbdc1f340db58762ba4526c80b0de336`）, `web/worker/wasm-home-limit.mjs`, `web/worker/test_wasm_canonical_state.mjs`, `web/worker/test_wasm_canonical_state_checkpoint.mjs`, `scripts/generate_wasm_canonical_state_t4.py` |
| `T5-FULL-MATRIX-01` | blocked：生成九领域 native/WASM/Worker 功能矩阵；按 LinuxCNC AXIS 源语义修复空/缺失 `OPEN_FILE` 处理和 HALFILE 分类，235-case matrix 恢复 verified，分类为 `BLOCKED_HAL=106/BLOCKED_RESOURCE=11/TASK_READY=96`；T5 28 个矩阵命令全部通过，source semantics contract 已纳入输入闭合，完整 parity 与官方 oracle/配置资源/浏览器/OPFS 边界继续 blocked | `coverage/wasm-feature-matrix-t5.report.json`（`08c1229072214407d0efbcb1f939834b470b160b31bbf7211123dc43306434fa`）, `coverage/linuxcnc-source-semantics-contract.json`, `web/workspace/linuxcnc-source-semantics.mjs`, `scripts/generate_wasm_feature_matrix_t5.py` |
| `T6-FUNCTION-CLOSURE-01` | blocked：对 T5 八个 blocked rows 完成 source-backed closure audit；每行保留 source reference、WASM/Worker capability、已验证 slice、差异、停止原因和下一步。23 个专项命令全部通过，4 个 failure samples 保留 official oracle、资源、宿主能力和浏览器输入缺口；T5 fixture drift 已由源语义修复，不使用 JS fallback 或 selected-case promotion，`STOP_RELEASE` 保持 | `coverage/wasm-function-closure-t6.report.json`（`46230d88ac0f7687b81c148657dd4af51da2c60a99c3f8e0777e4e8ec57a82d3`）, `scripts/generate_wasm_function_closure_t6.py`, `scripts/test_wasm_function_closure_t6.py`, `web/worker/test_wasm_function_closure_t6.mjs`, `nextTask1.md` |
| `T7-RELEASE-GATE-01` | blocked：完成 simulation-track 只读 release-gate audit；T6 dependency、context consistency、candidate eligibility、`STOP_RELEASE`、六项 blocker identity、owner refresh 和 remediation self-hash 全部核对通过；8 个 blocker 与 3 个 failure samples 保留。未刷新 K8 owner gate，未修改 context lock、manifest、许可证或 owner decision | `coverage/wasm-simulation-release-gate-t7.report.json`（`3375aa400ed4b21c5ae020c22f39f5d212db26373aee6c245b7bc87d09312bba`）, `scripts/generate_wasm_simulation_release_gate_t7.py`, `scripts/test_wasm_simulation_release_gate_t7.py`, `nextTask1.md` |
| `SOURCE-SEMANTICS-CONTRACT-01` | verified：将 LinuxCNC AXIS `OPEN_FILE` optional、`INTRO_GRAPHIC` optional、HALFILE/resource 缺失分类、exact-path/no-basename-substitution、runtime fixture 和 Web 控制面板 projection-only 规则固化为共享模块与机器契约；源文件哈希、契约 self-hash、loader/matrix regression 通过，不修改 ABI/protocol/schema/context lock | `coverage/linuxcnc-source-semantics-contract.json`（`ff1ce5e1c3251b82e4298a084146e1eb64fb608ef5f7922c69cec10faba77d83`）, `web/workspace/linuxcnc-source-semantics.mjs`, `web/workspace/test_source_semantics.mjs`, `scripts/generate_source_semantics_contract.py`, `scripts/test_source_semantics_contract.py`, `docs/linuxcnc-web-wasm-source-semantics.md` |
| `PANEL-PLAN-01` | queued：建立固定 `3axis-tutorial` Web 控制面板源程序对标实施合同；固化“WASM 是唯一数据来源、状态机严格对标源程序、按钮 gate 完全一致、preview 与 native canonical motion 一致”四项硬约束；登记 12 项功能矩阵（P0: 1-9/12，P1: 10-11）、分层 envelope、状态真值表、preview segment 比较算法、统一报告模板、15 个详细实施任务、依赖、验收和 STOP_RELEASE 边界；不改变 ABI/protocol/schema/context lock | `docs/linuxcnc-web-wasm-3axis-tutorial-control-panel-implementation.md`, `nextTask1.md`, `coverage/linuxcnc-source-semantics-contract.json` |
| `AXIS-STATE-CONTRACT` | verified：新增 additive `axis_state` 视图，严格记录 LinuxCNC `STATE_*`/`MODE_*`/`INTERP_*` 数值、ESTOP_RESET/上电/关机/individual HOME/IDLE/RUNNING/PAUSED 迁移和 AXIS button gate；不修改 `sim_task.v1` | `docs/linuxcnc-web-wasm-3axis-tutorial-state-machine.md`, `web/worker/axis-state.mjs`, `web/worker/test_axis_state.mjs`, `web/react/src/store.ts`, `web/react/src/App.tsx` |
| `FE-M1-REACT` | verified：按技术路线新增 React 19/TypeScript/Vite/Tailwind/Radix/Three.js 前端入口；Dedicated Worker/WASM bundle、protocol.v1 reducer、exact-path `configs/sim` loader、LinuxCNC AXIS source icons 和 Three.js r185 三轴 viewer 通过 typecheck/build/preview；OPFS 仍 Worker-owned | `coverage/react-frontend-m1.report.json`, `web/react`, `scripts/generate_react_frontend_m1.py`, `scripts/test_react_frontend_m1.py` |
| `FE-M4-GUI-01` | verified：扫描 LinuxCNC AXIS/Gmoccapy/Touchy/Gscreen/QtVCP/PyVCP/GladeVCP/Vismach/NGCGUI/QtPlasmaC 等 GUI 源码、Python 库、sim descriptors/assets，1837 条文件记录、12 个 family、source hash/path 通过；341 条 manifest 反向归属缺口保留审计，许可证不阻塞技术移植 | `coverage/gui-source-inventory-fe-m4.report.json`, `scripts/generate_gui_source_inventory.py`, `scripts/test_gui_source_inventory.py`, `nextTask1.md` |