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

Advance simulation parity and 3-axis tutorial coverage

Browse Source
This commit is contained in:
wangdequan
2026-08-23 18:00:56 +08:00
parent 4a11d9692b
commit 938654b19d
107 changed files with 13537 additions and 3565 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/task-history.md
View File

@@ -108,7 +108,18 @@
| `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 聚合；WASM/native/Worker/App 构建与回归 72/72 通过，10 个案例 TASK_READY、225 个案例保留 resource/HAL/INI/STARTUP blockers，display/machine family 与 runtime extension 证据已汇总；official full LinuxCNC oracle 仍 source-gated，Chromium/Firefox/Safari minimums 仍 TBD/Safari unavailable；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（正式停止条件）：资源运行时语义修复后重新聚合 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` |
| `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` |
| `TUTORIAL-04` | verified：3axis tutorial `trivkins` X/Y/Z home、独立三轴 jog、limit 注入/清除、following error fault 和固定 tick snapshot 通过；X/Y/Z 位置变化、错误码和 snapshot hash 保留 | `web/worker/test_axis3_tutorial_motion.mjs`, `scripts/test_axis3_tutorial_motion.py` |
| `TUTORIAL-05` | verified：固定 `3axis-tutorial` 案例的 RS-274/G-code `G21/G90/G91/G0/G1/F/M2`、程序 Run/Pause/Resume/Step/Abort/Restart 和 MDI 通过；暂停/运行态 MDI 保留 `mdi_while_program_active` 拒绝边界，abort/recover 后 MDI 成功；非法 G-code 在执行阶段保留解释器错误和最终 state hash | `coverage/axis3-tutorial-program.report.json`, `web/worker/test_axis3_tutorial_program.mjs`, `scripts/generate_axis3_tutorial_program_report.py`, `scripts/test_axis3_tutorial_program.py` |
| `TUTORIAL-10` | verified（selected-case scope）：固定源程序目录执行 `linuxcnc <case_dir>/3axis-tutorial.ini` 前清理旧 LinuxCNC 服务和 lock；native AXIS 窗口图片、Chromium desktop/mobile 图片、exact Worker startup/HAL/motion/program/tool/IO/checkpoint/recovery 和 self-hash 总报告均已生成；Firefox/Safari、OPFS 物理崩溃和全量 release 保持独立 blocked | `coverage/axis3-tutorial-complete.report.json`, `coverage/axis3-tutorial-native-run.report.json`, `coverage/axis3-tutorial-visual/`, `web/worker/test_axis3_selected_case.mjs`, `scripts/run_axis3_tutorial_native.py` |
| `TUTORIAL-11` | verified：固定案例 Worker 真实 WASM 通过 T1 prepare/change、主轴 600 RPM/at-speed/stop、mist/flood 冷却与 fault、probe arm/update/trip/disarm、ESTOP/recover；保留 tool state、probe position、错误码和最终 hash | `coverage/axis3-tutorial-tool-io.report.json`（`529b35a6fb84f561772b941a57d8bea3cf355969a622c01287afd5e642e0e246`）, `web/worker/test_axis3_tutorial_tool_io.mjs`, `scripts/generate_axis3_tutorial_tool_io_report.py`, `scripts/test_axis3_tutorial_tool_io.py` |
| `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` |
| `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` |
| `FE-M4-GUI-02` | verified：集中 React GUI domain model，定义 12 family、23 个 protocol.v1 Worker command、panel/capability/boundary 映射；PY-WASM、SIM-DEVICE、WEB-EQUIV、REAL-EXCLUDED 和 Worker/OPFS ownership 均有 contract evidence | `coverage/react-gui-domain-fe-m4.report.json`, `web/react/src/gui-domain.ts`, `scripts/generate_react_gui_domain_report.py`, `scripts/test_react_gui_domain_report.py` |