linuxcncWebWASM/README.md

LinuxCNC Web/WASM

本仓库的目标是将 LinuxCNC 2.10.0~pre0 的仿真行为移植到浏览器。当前提交完成的是实施前 M0/M1 骨架，不是 LinuxCNC 功能完成声明。

恢复或开始工作时，首先读取 nextTask.md。它是当前任务节点、下一任务节点、验证证据和切换规则的唯一接续入口。

当前状态

• LinuxCNC 来源基线：linuxcnc/VERSION 与 context-lock.json。
• 来源索引：coverage/source-index.jsonl，由 scripts/generate_source_inventory.py 生成。
• 覆盖种子：coverage/manifest.jsonl。所有条目初始为 planned/needs_owner，没有来源会被静默忽略。
• WASM ABI 骨架：wasm-core/include/sim_api.h；当前实现只验证生命周期、固定 tick、快照和状态导入导出。
• 前端、Worker、HAL、解释器、TP、Python、OPFS 和 UI 功能仍须按文档里程碑实现。

重建 M0

python3 scripts/generate_source_inventory.py
python3 scripts/validate_baseline.py
python3 -m unittest discover -s scripts -p 'test_*.py' -v

编译 ABI 骨架

需要 Emscripten。该命令同时运行原生 ABI 单测并生成 build-wasm/linuxcnc-sim-core.js/.wasm：

scripts/build-wasm.sh

完整路线、功能完整性和退出门禁见 docs/linuxcnc-web-wasm-implementation-readiness.md。专项设计仍分别位于 docs/ 下的 roadmap、source map、coverage、communication、execution 和 playbook 文档。

依赖下载允许使用中国大陆镜像；请先阅读 context-lock.json 的 downloads 策略。镜像只改变传输位置，不能改变版本、文件字节或校验记录。