cnc_wams/完善wasm/working/README.md

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 接线。

后续使用方式

1. 每轮开始先读 04-任务矩阵.md，选择 待办、进行中 或 阻塞待解除 的任务。
2. 实施前在对应任务下确认 LinuxCNC 源码目录、上游测试资产、最小验收命令和晋级目标。
3. 修改 wasm-port 后，把本轮过程写入 03-推进台账.md。
4. 把可复现命令、关键输出、报告路径、截图路径写入 05-验收证据.md。
5. 如改变源码复用方式、运行边界、验收口径或安全策略，先更新 06-决策记录.md。
6. 每轮结束必须按仓库 AGENTS.md 追加中文过程日志到 gptlog-process/gpdlog.md。

默认推进指针

下一优先方向：当前软件范围内包括 User-M/Python Remap WASM/Web 移植均已收口，详见 32 到 41。后续只有在提供真实硬件/专用实时环境或明确宿主外部进程授权后继续；任意动态 loadrt、realtime/hardware/native process topology 继续 blocked。