LinuxCNC 完全对标推进文档索引
本目录用于指导 /home/mes123456/cnc_wams/wasm-port 按 /home/mes123456/cnc_wams/完善wasm/03完全对标LinuxCNC的可执行验收标准.txt 持续完善。本文档集的作用是把验收标准转成可执行的开发、验证、记录和决策闭环。
基准口径
- 唯一数控语义基准：
/home/mes123456/cnc_wams/linuxcnc - 对标对象：
/home/mes123456/cnc_wams/wasm-port - 上游基线：LinuxCNC
60597ee0718873d2449058c824262a275e5e4bad - 证据优先级：P0 上游源码/测试资产 > P1 vendored 同步 > P2 Native > P3 WASM Node > P4 真实浏览器 > P5 截图/录屏
- 完成定义：每个 claimed feature 必须有 LinuxCNC 源码归属、Native/WASM/Browser 分层证据、文档同步和稳定的 expected_fail/blocked 说明。
文档索引
| 文件 | 用途 |
|---|---|
01-项目功能内容.md |
定义 wasm-port 必须覆盖的 LinuxCNC 功能树、边界和最终能力范围。 |
02-项目程序开发详细步骤.md |
给出每轮开发的固定流程、分层验收步骤和不同功能族的落地顺序。 |
03-推进台账.md |
记录每轮做了什么、改了哪些文件、验证了什么、下一步是什么。 |
04-任务矩阵.md |
维护所有任务编号、状态、验收标准和证据入口，防止重复做或跳级宣称完成。 |
05-验收证据.md |
汇总命令、页面、job_id、report_id、PDF、截图、日志等可复验证据。 |
06-决策记录.md |
固定关键技术决策和理由，后续变更时不反复争论同一个问题。 |
07-双项目LinuxCNC源码对标总览.md |
把 wasm-port 和 web-rtcp-5axis-xyzbc-trt-sim-plan 放入统一 LinuxCNC 源码对标视图。 |
08-源码资产映射与证据索引.md |
记录 LinuxCNC 源码、配置、测试资产到 WASM 核心和 XYZBC TRT Web 应用的证据映射。 |
09-联合任务矩阵.md |
维护跨项目任务、状态、最低复验命令和推进指针。 |
10-联合验证命令清单.md |
汇总基线、wasm-port、xyzbc-trt Web 应用和完整联合 gate。 |
11-缺口风险与边界锁定.md |
固定一票否决项、条件边界、文档漂移和解除条件。 |
12-交付文件索引.md |
说明本轮新增交付物和后续使用顺序。 |
13-04验收文档任务对标矩阵.md |
将 04基于Web...txt 的 10 个模块、125 个功能项和 3 个受限项映射到 LinuxCNC 源码与可执行证据。 |
14-04-125项逐项源码证据绑定表.md |
逐行绑定 04 的 125 个功能项到 LinuxCNC 源码/资产、最小 gate、Web evidence 和严格状态。 |
15-04语法口径源码复核.md |
对 04 中 G68/G69、G51.1/G50.1、M18/M19、G43.1/G43.4/G49 等高风险语法口径做源码级复核。 |
16-04多通道源码边界复核.md |
对 04 中 5.1-5.5 多通道项做源码级边界复核，区分 LinuxCNC 单 task、多实例和 Web multi-session gate。 |
17-04-HAL-Scope-Meter结构化证据复核.md |
对 04 中 4.13、4.14、10.7 的 HAL Scope/Meter 做源码边界复核，定义 Web 等效 JSON evidence 要求。 |
18-04五轴范围差异与代表应用复核.md |
对 04 中 8.1、8.2、8.3、8.6-8.10 的五轴范围做源码边界复核，区分 XYZBC、XYZAC、XYZAB 和泛五轴 demo。 |
19-04动态加载与预编译Manifest复核.md |
对 04 中 4.7-4.11、4.16、6.5、6.6 做源码边界复核，区分 HAL 组件预编译缺口、loadrt 动态加载阻塞和 kinematics 已预编译 gate。 |
20-04-HAL-Scope-Meter-JSON-Gate实现缺口复核.md |
对 04 中 4.13、4.14、10.6、10.7 的 HAL Meter/Scope JSON gate 做实现缺口复核，区分已有 HAL 模型和缺失 waveform/meter evidence gate。 |
21-04-HAL-Component-Precompile-Manifest实现缺口复核.md |
对 04 中 4.7-4.11、4.16 的 HAL 组件预编译 manifest/truth-table gate 做实现缺口复核，区分 .comp 源码/native HAL 文本和真实 WASM 组件执行证据。 |
22-04-Full-Process-Realtime-Runtime-Proof实现缺口复核.md |
对 04 中 Task/Motion/HAL/full-process/realtime 项做实现缺口复核，区分 Web/WASM 仿真运行时晋级和宿主实时/硬件/完整 native process topology 边界。 |
23-04-HAL-Meter-Scope-JSON-Evidence-Gate落地蓝图.md |
对 04 中 HAL Meter/Scope JSON evidence 做落地蓝图，固定 hal_meter_evidence、hal_scope_waveform_evidence 的 schema、生成路径、gate 和晋级条件。 |
24-04-HAL-Component-Precompile-Manifest-Truth-Table-Gate落地蓝图.md |
对 04 中 HAL 基础组件预编译做落地蓝图，固定 .comp 同步、源码哈希、LinuxCNC 派生生成物、manifest、loadrt/addf/servo-step 执行链和 truth-table/formula gate。 |
25-04-Host-Runtime-Opt-In-Promotion-Evidence-Gate落地蓝图.md |
对宿主 User-M、Tool DB、Python remap、实时内核、硬件和 native process topology 做 opt-in/promotion 落地蓝图，区分 release ready、host ready、probe pass、evidence accepted、manual unlock 和 promotion。 |
26-04-HAL-Component-P1源码同步与哈希Gate实施记录.md |
记录五个基础 HAL .comp 的双清单登记、P1 抽取、固定哈希专项 gate、generated overlay 分层和后续执行缺口。 |
27-04-HAL-Component-Precompile-Runtime-Gate实施记录.md |
记录五个基础 HAL component 的 halcompile 派生、manifest、WASM factory/thread/net/truth-table 和 Web 代表配置消费 gate。 |
28-04-HAL-Meter-Scope-JSON-Evidence-Gate实施记录.md |
记录 HAL Meter 当前值、Scope waveform 采样、Web evidence 和 compare gate。 |
29-04-Host-Runtime-Opt-In-Evidence-Gate实施记录.md |
记录 host runtime artifact/hash、promotion 状态机和 release/promotion separation gate。 |
30-04-Remaining-Runtime-Cases-Session-Gantry-Multispindle-Drilling实施记录.md |
记录软限位、session 倍率、龙门、多主轴和斜面钻孔专项 gate。 |
31-04-Motion-FERROR-Virtual-MPG-Gate实施记录.md |
记录跟随误差阈值与虚拟手轮 count-delta gate。 |
32-后续全部工作收口审计.md |
审计全部剩余项，区分已完成、需修订、人工锁和硬件/实时 Blocked。 |
33-Native全量回归最终收口.md |
串行复验完整 native probe 包，解除历史 xyzac.var/Bus error unexpected failure 并锁定最终 unexpected_fail=0 口径。 |
34-04验收口径修订与三Session-Gate实施记录.md |
修订 04 中不符合锁定 LinuxCNC 源码的语法、五轴 fixture 和范围声明，并补三 Web session 隔离 gate。 |
35-三解释器同步-Wrapped-Rotary-角轴限速Gate实施记录.md |
记录三解释器 G5x/sync 隔离、wrapped rotary 结构化 INI 证据和 G93 角轴限速修复。 |
36-Web-Software-Parity-Release-Gate与Host分离实施记录.md |
将新增软件证据接入 14 项 release gate，并统一 Web release ready 与 host promotion blocked 合同。 |
37-Wrapped-Rotary静态发布资产Gate实施记录.md |
将 wrapped rotary 配置复制到两条静态部署路径，并以字节一致 gate 防止发布漂移。 |
38-Web-Software-Parity自包含构建Gate实施记录.md |
让 parity gate 先重建 dist 再验证发布资产，并锁定独立执行顺序。 |
39-静态发布Python缓存清理Gate实施记录.md |
过滤 Python cache/bytecode，并以递归 hygiene gate 保护静态发布包。 |
40-静态发布双构建可复现性Gate实施记录.md |
对连续两次 static build 计算规范化树摘要并要求完全一致。 |
41-User-M-Python-Remap-WASM-Web完整移植实施记录.md |
M128/M129 WASM handler、真实 Pyodide CPython/WASM、53 行源码覆盖和目标 Web/release 接线。 |
后续使用方式
- 每轮开始先读
04-任务矩阵.md，选择待办、进行中或阻塞待解除的任务。 - 实施前在对应任务下确认 LinuxCNC 源码目录、上游测试资产、最小验收命令和晋级目标。
- 修改
wasm-port后，把本轮过程写入03-推进台账.md。 - 把可复现命令、关键输出、报告路径、截图路径写入
05-验收证据.md。 - 如改变源码复用方式、运行边界、验收口径或安全策略，先更新
06-决策记录.md。 - 每轮结束必须按仓库
AGENTS.md追加中文过程日志到gptlog-process/gpdlog.md。
默认推进指针
下一优先方向：当前软件范围内包括 User-M/Python Remap WASM/Web 移植均已收口，详见 32 到 41。后续只有在提供真实硬件/专用实时环境或明确宿主外部进程授权后继续；任意动态 loadrt、realtime/hardware/native process topology 继续 blocked。