cnc_wams/完善wasm/working/07-双项目LinuxCNC源码对标总览.md

07-双项目 LinuxCNC 源码对标总览

定位

本文件把两个目标目录放入同一个验收视图：

• /home/mes123456/cnc_wams/wasm-port
• /home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan

共同基准为：

• LinuxCNC 源码：/home/mes123456/cnc_wams/linuxcnc
• 基线 commit：60597ee0718873d2449058c824262a275e5e4bad
• 验收标准：/home/mes123456/cnc_wams/完善wasm/03完全对标LinuxCNC的可执行验收标准.txt
• 参考说明：/home/mes123456/cnc_wams/完善wasm/04基于Web的LinuxCNC兼容数控仿真平台.txt

注意：04基于Web的LinuxCNC兼容数控仿真平台.txt 已补齐为功能与体系结构验收文档，包含 10 个模块、125 个功能项和 3 个受限项。该文件中的“通过”“100%”“超越”等表述在 working 中作为目标声明和证据线索处理，不能绕过 LinuxCNC 源码、Native/WASM/Browser gate 和 evidence JSON 直接继承为最终通过结论。04 的逐项任务映射见 13-04验收文档任务对标矩阵.md。

分工

层级	目录	职责	不允许做的事
LinuxCNC 权威源	linuxcnc	提供源码、测试资产、nc_files、configs/sim、真实 native 行为	不在本轮修改上游源码
WASM 移植核心	wasm-port	vendored 源码同步、Native/WASM/Browser/OPFS/SDK/Task-HAL/TP/kinematics 验收	不用 JS/TS 或项目自有 C/C++ 重写 G 代码、刀补、轨迹规划、运动学等 CNC 语义
XYZBC TRT Web 应用	web-rtcp-5axis-xyzbc-trt-sim-plan	作为 xyzbc-trt.ini 的 L4/L5 代表 Web 应用，验证 UI、OPFS、机器文件 staging、AXIS/PyVCP/Vismach 等效和 native/Web JSON 对比	不把 UI 状态作为第二套 CNC 真相；不绕过 wasm-port 的 LinuxCNC-backed SDK
总控 working	完善wasm/working	维护跨项目对标口径、任务、命令、风险和证据入口	不替代底层工程的源码测试；不把未跑命令写成通过

当前状态快照

项目	当前已有证据	总控判断
linuxcnc	git rev-parse HEAD 为 60597ee0718873d2449058c824262a275e5e4bad；工作树存在若干未跟踪本地文件	commit 基线匹配；本地未跟踪文件不能作为上游基线 drift
wasm-port	已有 source-reuse-map.md、compatibility-validation.md、linuxcnc-test-porting-tracker.md、source manifest 和 Native/WASM/Browser/host 验证脚本	作为 LinuxCNC 语义移植核心继续采用 L0-L5/Blocked 模型
web-rtcp-5axis-xyzbc-trt-sim-plan	自身 working 文档声明 T-001 到 T-075 已完成；存在 native/Web/compare evidence JSON 和 Node/browser smoke	作为 xyzbc-trt 代表应用纳入联合验收，但其完成结论必须继续由 evidence JSON 和 smoke 命令复验
04基于Web...txt	10 个模块、125 个功能项、3 个受限项	已纳入 13-04验收文档任务对标矩阵.md；逐项通过需绑定可复验证据

总体验收链

linuxcnc 源码/配置/测试
  -> wasm-port vendor/source manifest/native probes
  -> wasm-port WASM C ABI/SDK/OPFS/browser gates
  -> web-rtcp-5axis-xyzbc-trt-sim-plan 机器文件 staging、UI、3D、按钮和 evidence JSON
  -> native/Web/compare 结构化对比

总控结论口径

1. wasm-port 负责证明 CNC 核心语义来自 LinuxCNC 源码。
2. web-rtcp-5axis-xyzbc-trt-sim-plan 负责证明真实 Web 应用能通过 wasm-port 的 LinuxCNC-backed 边界呈现 xyzbc-trt 机床行为。
3. 任一层出现 unexpected_fail、source drift、未解释的 evidence 缺失、UI 状态与底层快照不一致，都不能宣称完全对标。
4. Python remap、外部 User-M 进程、硬件驱动、实时内核、完整 native process topology 等内容继续采用条件通过或 Blocked 口径，除非补齐 Native/WASM/Browser 证据。