71 lines
8.5 KiB
Markdown
71 lines
8.5 KiB
Markdown
# 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。
|