36 lines
2.4 KiB
Markdown
36 lines
2.4 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` | 固定关键技术决策和理由，后续变更时不反复争论同一个问题。 |
|
||
|
||
## 后续使用方式
|
||
|
||
1. 每轮开始先读 `04-任务矩阵.md`，选择 `待办`、`进行中` 或 `阻塞待解除` 的任务。
|
||
2. 实施前在对应任务下确认 LinuxCNC 源码目录、上游测试资产、最小验收命令和晋级目标。
|
||
3. 修改 `wasm-port` 后，把本轮过程写入 `03-推进台账.md`。
|
||
4. 把可复现命令、关键输出、报告路径、截图路径写入 `05-验收证据.md`。
|
||
5. 如改变源码复用方式、运行边界、验收口径或安全策略，先更新 `06-决策记录.md`。
|
||
6. 每轮结束必须按仓库 `AGENTS.md` 追加中文过程日志到 `gptlog-process/gpdlog.md`。
|
||
|
||
## 默认推进指针
|
||
|
||
下一优先方向：从 `04-任务矩阵.md` 的 `ACC-001` 到 `ACC-004` 开始，先锁定基线、源码同步、自研语义禁止和现有必跑命令现状。没有这些证据前，不应继续宣称更高层功能完全对标。
|