Initial LinuxCNC WebAssembly workspace snapshot

README.md

@@ -0,0 +1,33 @@
+# LinuxCNC Web/WASM
+
+本仓库的目标是将 LinuxCNC `2.10.0~pre0` 的仿真行为移植到浏览器。当前提交完成的是实施前 M0/M1 骨架，不是 LinuxCNC 功能完成声明。
+
+恢复或开始工作时，首先读取 [`nextTask.md`](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
+
+```bash
+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`：
+
+```bash
+scripts/build-wasm.sh
+```
+
+完整路线、功能完整性和退出门禁见 [`docs/linuxcnc-web-wasm-implementation-readiness.md`](docs/linuxcnc-web-wasm-implementation-readiness.md)。专项设计仍分别位于 `docs/` 下的 roadmap、source map、coverage、communication、execution 和 playbook 文档。
+
+依赖下载允许使用中国大陆镜像；请先阅读 `context-lock.json` 的 `downloads` 策略。镜像只改变传输位置，不能改变版本、文件字节或校验记录。