cnc_wams/完善wasm/working/04-任务矩阵.md

# 04-任务矩阵

## 状态说明

| 状态 | 含义 |
| --- | --- |
| 待办 | 尚未开始。 |
| 进行中 | 已有修改或验证，但未闭合。 |
| 完成 | 代码/文档/测试/证据均已闭合。 |
| 条件通过 | LinuxCNC 行为有证据，但 Web/硬件/实时/外部进程边界限制已明确。 |
| 阻塞 | 当前不能执行，已记录依赖、源码归属和解除条件。 |
| 不通过 | 出现不一致、自研语义、未知失败或缺证据。 |

## 晋级说明

任务验收不能只写“完成”，还应标明功能晋级状态：`L0 已盘点`、`L1 已同步`、`L2 Native 通过`、`L3 WASM 通过`、`L4 Browser 通过`、`L5 UI 发布` 或 `Blocked`。

## 任务列表

| 编号 | 任务 | 当前状态 | 晋级目标 | 验收标准 | 证据入口 |
| --- | --- | --- | --- | --- | --- |
| ACC-001 | 锁定 LinuxCNC 上游基线 | 完成 | L0/L1 | `verify_upstream_baseline.sh` 通过；commit 与验收标准、`upstream-baseline.txt`、`scope-and-baseline.md` 一致 | `05-验收证据.md` |
| ACC-002 | 校验 vendored 源码同步 | 完成 | L1 | `verify_vendor_sync.sh` 通过；source manifest 可追溯到上游 | `source-manifest.txt`、证据文档 |
| ACC-003 | 禁止自研 CNC 语义 | 完成 | L1 | `verify_no_standalone_cnc_semantics.sh` 通过；疑似实现均保持 thin wrapper/source-derived 边界 | 命令日志 |
| ACC-004 | 盘点现有必跑命令状态 | 完成 | L0 | 验收标准 2.3 所列命令均有最近一次结果；聚合 gate 通过 | 汇总表 |
| ACC-005 | 建立 nc_files 基础示例验收 | 完成 | L3 WASM | native `107 total / 101 pass / 6 expected_fail / 0 unexpected_fail`；WASM `nc_files_wasm_node_smoke=ok` | `verify_nc_files.sh`、`verify_nc_files_wasm.sh` |
| ACC-006 | 建立 configs/sim 机床配置验收 | 条件通过 | L4/Blocked | native `159 total / 151 pass / 8 expected_fail / 0 unexpected_fail`；WASM inventory `29/29/130/0`；Python remap/User M/asset-only 明确锁定 | sim configs summary |
| ACC-007 | 扩展解释器基础运动和错误覆盖 | 完成 | L4 | Native/WASM/Browser interp smoke 通过；错误与 expected_fail 口径稳定 | interp fixtures |
| ACC-008 | 扩展参数、O-word、M98/M99 覆盖 | 完成 | L3/L4 | native probes 覆盖参数、O-word、M98/M99、INI 参数；WASM/browser interp gate 通过 | canonical events |
| ACC-009 | 扩展刀补、固定循环、车削循环覆盖 | 完成 | L3/L4 | native probes 覆盖 ccomp、固定循环、G70/G71/G72/G76 等；WASM interp gate 不回退 | tests/ccomp、tests/interp |
| ACC-010 | remap 分层接入 | 条件通过 | L3/L4/Blocked | NGC/remap 相关现有证据通过；Python remap SDK/WASM/browser row proof 通过但保持 manual promotion lock | remap tracker |
| ACC-011 | Task/NML 程序运行控制验收 | 完成 | L3/L5 | task/status、UI、host 聚合通过；open/run/pause/resume/step/abort 等由结构化快照和 UI smoke 验证 | task/status gate |
| ACC-012 | TP 轨迹规划数值验收 | 完成 | L3 | `verify_tp_wasm.sh` 通过，含 `tp_pause_resume_smoke=ok` | `verify_tp_wasm.sh` |
| ACC-013 | Motion full-process 边界验收 | 条件通过 | L3/Blocked | native runtime probe/source proof 与 host boundary docs 通过；实时/硬件/full-process 保持 opt-in/blocked 边界 | motion probes |
| ACC-014 | 运动学和五轴 RTCP 验收 | 条件通过 | L4 | configs/sim、5axis、switchkins 相关 evidence gate 通过；缺失 runtime/Python 边界继续锁定 | kinematics evidence |
| ACC-015 | HAL/RTAPI 虚拟边界验收 | 条件通过 | L3/条件通过 | HAL/source-derived、task HAL、host runtime boundary 和 no-standalone guard 通过；实时线程/硬件驱动不静默模拟 | HAL summary |
| ACC-016 | 刀具、刀库、主轴、IO 验收 | 条件通过 | L4/Blocked | tool DB SDK/WASM/browser/proof 通过；tool/coolant/native IO 边界保持 unsupported/blocked 标记 | tool/io probes |
| ACC-017 | INI、文件系统、OPFS 验收 | 完成 | L4 | INI WASM、INI browser、OPFS file service、OPFS session workflow、host 聚合通过 | OPFS/browser logs |
| ACC-018 | 浏览器 UI 状态一致性验收 | 完成 | L5 | UI node smokes、INI panel browser、real simulation browser、axis screenshot、interp browser 全部通过 | UI/browser logs |
| ACC-019 | 多实例、Worker、并发隔离验收 | 完成 | L4/L5 | OPFS/session/browser workflow 与 release artifact URL/workflow gate 通过；Worker 类 Python remap browser proof 通过 | session tests |
| ACC-020 | 性能、稳定性、确定性验收 | 条件通过 | L4/L5 | 重复 gate 稳定通过，expected_fail/skip 计数固定；未引入独立性能基准，作为发布条件通过项记录 | perf reports |
| ACC-021 | 安全和平台边界验收 | 条件通过 | 条件通过/Blocked | USER_M_PATH、Python remap、Tool DB、硬件/实时边界均有 blocked/manual lock/proof 记录；不静默执行宿主命令 | boundary docs |
| ACC-022 | 文档和 tracker 同步门禁 | 完成 | L5 | docs gates、SDK/release readiness、host 聚合通过；tracker 路径已兼容 `textbak` | docs gate |
| ACC-023 | 发布前完整验收汇总 | 条件通过 | L5/条件通过 | 必跑命令和专项补充命令全部通过；`unexpected_fail=0`；Python remap/User M/硬件实时等保留显式条件边界 | release report |
| ACC-024 | 双项目统一 LinuxCNC 源码对标 working 文件 | 完成 | L0/L5 总控 | 在 `完善wasm/working` 创建双项目总览、源码映射、联合任务矩阵、联合验证命令、风险边界和交付索引；当时 `04基于Web...txt` 为空，后续由 ACC-025 复核补齐内容 | `07` 到 `12`、`09-联合任务矩阵.md` |
| ACC-025 | 04 验收文档任务纳入 LinuxCNC 源码对标矩阵 | 完成 | L0/L1 总控 | 将 `04基于Web...txt` 的 10 个模块、125 个功能项、3 个受限项转为 W04 任务包；不直接继承 04 的“通过/100%”结论 | `13-04验收文档任务对标矩阵.md`、`09-联合任务矩阵.md` |
| ACC-026 | 04 文档 125 项逐项源码证据绑定表 | 完成 | L1 总控 | 为 04 的 125 个功能项逐行记录 LinuxCNC 源码/资产归属、最小 gate、Web evidence 和严格状态；缺口项集中列出 | `14-04-125项逐项源码证据绑定表.md` |
| ACC-027 | 04 语法口径源码复核 | 完成 | L1 总控 | 对 04 中 G68/G69、G51.1/G50.1、M18/M19、G43.1/G43.4/G49 进行本地 LinuxCNC 源码复核，明确需修订和部分成立项 | `15-04语法口径源码复核.md` |
| ACC-028 | 04 多通道源码边界复核 | 完成 | L1 总控 | 对 04 中 5.1-5.5 多通道项进行本地 LinuxCNC 源码复核，明确单 task 与 multi-session 的边界和后续 gate 要求 | `16-04多通道源码边界复核.md` |
| ACC-029 | 04 HAL Scope/Meter 结构化证据复核 | 完成 | L1 总控 | 对 04 中 4.13、4.14、10.7 进行本地 LinuxCNC 源码复核，明确原生 `halscope`/`halmeter` 与 Web 等效 JSON evidence 的边界 | `17-04-HAL-Scope-Meter结构化证据复核.md` |
| ACC-030 | 04 五轴范围差异与代表应用复核 | 完成 | L1 总控 | 对 04 中 8.1、8.2、8.3、8.6-8.10 进行本地 LinuxCNC 源码和代表 Web profile 复核，明确 XYZBC、XYZAC、XYZAB 和泛五轴 demo 不能互相继承通过结论 | `18-04五轴范围差异与代表应用复核.md` |
| ACC-031 | 04 动态加载与预编译 Manifest 复核 | 完成 | L1 总控 | 对 04 中 4.7-4.11、4.16、6.5、6.6 完成源码与边界复核；当时识别的 HAL `.comp` 预编译缺口已由 ACC-038/039 闭合，任意动态 `loadrt` 仍阻塞 | `19-04动态加载与预编译Manifest复核.md`、`27` |
| ACC-032 | 04 HAL Scope/Meter JSON Gate 实现缺口复核 | 完成 | L1 总控 | 对 04 中 4.13、4.14、10.6、10.7 进行实现层复核，明确现有 HAL runtime/halGraph/gmoccapy HAL model 不能替代 `hal_meter_evidence` 与 `hal_scope_waveform_evidence` | `20-04-HAL-Scope-Meter-JSON-Gate实现缺口复核.md` |
| ACC-033 | 04 HAL Component Precompile Manifest 实现缺口复核 | 完成 | L1 总控 | 对 04 中 4.7-4.11、4.16 进行实现层复核，明确 `.comp` 源码、native HAL 文本和 `loadrt` 事件不能替代预编译 manifest、truth-table/formula 和 thread/net gate | `21-04-HAL-Component-Precompile-Manifest实现缺口复核.md` |
| ACC-034 | 04 Full-Process Realtime Runtime Proof 实现缺口复核 | 完成 | L1/L3 总控 | 对 04 中 Task/Motion/HAL/full-process/realtime 项进行实现层复核，明确 Web/WASM task-motion-HAL 仿真运行时可晋级到 `linuxcnc_task_motion_hal_wasm_simulation_runtime`，但宿主实时内核、硬件驱动、完整 native process topology 和任意宿主外部进程仍不得无条件晋级 | `22-04-Full-Process-Realtime-Runtime-Proof实现缺口复核.md` |
| ACC-035 | 04 HAL Meter/Scope JSON Evidence Gate 落地蓝图 | 完成 | L1 总控 | 对 04 中 4.13、4.14、10.6、10.7 固定 `hal_meter_evidence` 与 `hal_scope_waveform_evidence` 的 schema、生成路径、gate、通过输出和晋级条件；明确 halGraph/halNets/截图仍不能替代 evidence gate | `23-04-HAL-Meter-Scope-JSON-Evidence-Gate落地蓝图.md` |
| ACC-036 | 04 HAL Component Precompile Manifest / Truth-Table Gate 落地蓝图 | 完成 | L1 总控 | 对 04 中 4.7-4.11、4.16 固定 `.comp` vendor/source manifest、源码哈希、LinuxCNC 派生生成物、预编译 manifest、`loadrt/addf/servo-step` 执行链、truth-table/formula evidence 和未知组件 blocked 规则 | `24-04-HAL-Component-Precompile-Manifest-Truth-Table-Gate落地蓝图.md` |
| ACC-037 | 04 Host Runtime Opt-In Promotion Evidence Gate 落地蓝图 | 完成 | L1/L2 总控 | 固定 User-M、Tool DB、Python remap、realtime、hardware 和 native process topology 的 host-ready/dispatch/probe/evidence/manual-review/promotion 状态机；明确 release ready 与 host promotion 分离 | `25-04-Host-Runtime-Opt-In-Promotion-Evidence-Gate落地蓝图.md` |
| ACC-038 | 04 HAL Component P1 源码同步与哈希 Gate | 完成 | L1 | 五个 `.comp` 已进入双清单和 vendor，专项 gate 绑定 commit、字节和固定哈希并通过；既有非上游 fallback 已由独立 overlay manifest 锁定，全量 vendor gate 恢复通过；组件编译和执行未晋级 | `26-04-HAL-Component-P1源码同步与哈希Gate实施记录.md` |
| ACC-039 | 04 HAL Component Precompile Runtime Gate | 完成 | L3 条件通过 | 五个 `.comp` 由锁定 `halcompile` 派生并预编译进 task-HAL WASM；manifest、truth-table/formula、thread/net、未知 loadrt blocked、session reset 和 Web XYZAC 代表配置 gate 通过 | `27-04-HAL-Component-Precompile-Runtime-Gate实施记录.md` |
| ACC-040 | 04 HAL Meter/Scope JSON Evidence Gate | 完成 | L3 条件通过 | pin/signal/parameter meter JSON、servo waveform、schema/sample/trigger、Web evidence 和 compare gate 通过；不宣称原生 RT/GTK process | `28-04-HAL-Meter-Scope-JSON-Evidence-Gate实施记录.md` |
| ACC-041 | 04 Host Runtime Opt-In Evidence Gate | 完成 | L2/L4 状态门禁 | 三 family artifact/hash、状态机、disabled-not-pass、single-fixture-not-family、release/host separation 和 Web gate 通过；promotion 仍锁定 | `29-04-Host-Runtime-Opt-In-Evidence-Gate实施记录.md` |
| ACC-042 | 04 Remaining Runtime Cases | 完成 | L1-L4 条件通过 | 软限位、session override 隔离、gantry source、`$` multi-spindle、G95 和 XYZAC G81 program-case gate 通过 | `30-04-Remaining-Runtime-Cases-Session-Gantry-Multispindle-Drilling实施记录.md` |
| ACC-043 | 04 Motion FERROR / Virtual MPG Gate | 完成 | L3 条件通过 | LinuxCNC ferror 动态阈值成对负例、joint jog HAL pins、正反 count delta 和 Motion/Task 回归通过 | `31-04-Motion-FERROR-Virtual-MPG-Gate实施记录.md` |
| ACC-044 | 后续全部工作收口审计 | 完成 | 总控 | 125 项表无未分类待实现/待补；剩余版本修订、人工锁、硬件/实时 Blocked 均有解除条件 | `32-后续全部工作收口审计.md` |
| ACC-045 | Native 全量回归最终收口 | 完成 | L2 Native | 串行完整 native probe 包通过；sim-config `159/151/8/0`、nc_files `107/101/6/0`，历史 `xyzac.var` Bus error 已解除 | `33-Native全量回归最终收口.md` |
| ACC-046 | 04 验收口径修订与三 Session Gate | 完成 | L1/L4 | G10/G5x rotation、M19、TRT/TLO、XYZAC A 轴范围和现有五轴 demo 已替换错误口径；三个独立 Web session override 隔离 gate 通过 | `34-04验收口径修订与三Session-Gate实施记录.md` |
| ACC-047 | 三解释器同步、Wrapped Rotary 与角轴限速 Gate | 完成 | L1/L3/L4 | 三 WASM interpreter 的 G5x/rotation/M62 隔离、wrapped rotary INI 语义和 G93 角轴限速数值 gate 通过 | `35-三解释器同步-Wrapped-Rotary-角轴限速Gate实施记录.md` |
| ACC-048 | Web Software Parity Release Gate 与 Host 分离 | 完成 | L5/状态门禁 | 新软件 parity gate 进入 14 项 release manifest；artifact/UI 分离 release 与 host promotion；普通 gate 禁止隐式 opt-in | `36-Web-Software-Parity-Release-Gate与Host分离实施记录.md` |
| ACC-049 | Wrapped Rotary 静态发布资产 Gate | 完成 | L5 | wrapped rotary 配置进入 dist 普通/vendor 两路径，字节一致检查进入 parity gate | `37-Wrapped-Rotary静态发布资产Gate实施记录.md` |
| ACC-050 | Web Software Parity 自包含构建 Gate | 完成 | L5 | parity command 先重建 dist 再消费静态资产，manifest 测试锁定顺序和双 cwd | `38-Web-Software-Parity自包含构建Gate实施记录.md` |
| ACC-051 | 静态发布 Python 缓存清理 Gate | 完成 | L5 | static copy 过滤 `__pycache__`/bytecode，完整 dist hygiene 扫描进入 parity gate | `39-静态发布Python缓存清理Gate实施记录.md` |
| ACC-052 | 静态发布双构建可复现性 Gate | 完成 | L5 | 连续两次 build 的路径/类型/权限/链接目标/内容摘要完全一致 | `40-静态发布双构建可复现性Gate实施记录.md` |
| ACC-053 | User-M 与 Python Remap WASM/Web 完整移植 | 完成 | L2/L3/L4/L5 | M128/M129 预编译 WASM handler；Pyodide CPython/WASM Worker；53 行/27 源全量编译；目标 Web 与 required parity/release 接线 | `41-User-M-Python-Remap-WASM-Web完整移植实施记录.md` |

## 当前推进指针

下一优先任务：User-M/Python Remap Web/WASM 已由 ACC-053 解除软件阻塞。当前剩余仅为任意动态 loadrt、任意未预编译宿主外部程序、宿主 realtime、硬件和完整 native topology，按 `32` 等待专用环境或授权；最终软件证据见 `33` 到 `41`。