# 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`；逐项通过需绑定可复验证据 |

## 总体验收链

```text
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 证据。