# web-rtcp-5axis-sim-plan working1 修复指导目录

生成时间：2026-06-22

本目录用于指导修复测试报告中确认的问题：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/web-rtcp-5axis-site-test-report-2026-06-22.docx
```

本目录只提供修复设计、实施步骤、溯源和验收文档，不直接修改程序代码。后续开发人员可按本目录文件逐步修复本地项目。

## 文档清单

| 文件 | 用途 |
| --- | --- |
| `01-problem-review.md` | 测试问题复盘、证据、影响范围和初步根因 |
| `02-repair-plan.md` | 总体修复方案、优先级、风险和代码落点 |
| `03-implementation-steps.md` | 程序修改的详细步骤，按问题拆分到具体文件和函数 |
| `04-traceability-matrix.md` | 问题、测试证据、源码、LinuxCNC 参考、修复项、验收项的追溯矩阵 |
| `05-acceptance-test-plan.md` | 修复完成后的本地/浏览器/线上回归验收清单 |
| `06-work-log-template.md` | 后续每轮修复过程记录模板 |

## 本轮确认问题

| ID | 问题 | 严重级别 | 修复优先级 |
| --- | --- | --- | --- |
| D1 | 首屏 RTCP/运动学边界未自动挂接 LinuxCNC kinematics | 高 | P0 |
| D2 | 3D 预览画布存在，但未观察到机床/刀路可见对象 | 中 | P0 |
| D3 | HOME 后 JOG 坐标连续性异常 | 中 | P1 |

## 修复目标

1. 页面稳定加载后，RTCP frame 自动进入 `source-derived-kinematics-wasm`，边界显示 `linuxcnc_kinematics_wasm_c_abi`。
2. 3D 预览在 WebGL 和 2D fallback 两条路径下均可见，至少能看到机床基准、刀具/TCP 标记和路径。
3. HOME 后执行 JOG，DRO 坐标必须在当前显示坐标基础上连续变化，不允许跳到另一套坐标原点。
4. 修复后新增或更新自动化测试，防止同类问题回归。

## 推荐执行顺序

1. 先修 D1，确保 LinuxCNC kinematics frame 自动刷新链路稳定。
2. 再修 D2，确保视觉层有可见基础机床对象和路径对象。
3. 最后修 D3，统一 task/HAL runtime 反馈坐标系与 UI DRO 坐标系。
4. 执行 `05-acceptance-test-plan.md` 中的本地和浏览器验收。

