46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
# web-rtcp-5axis-sim-plan working1 修复指导目录
|
||
|
||
生成时间：2026-06-22
|
||
|
||
本目录用于指导修复测试报告中确认的问题：
|
||
|
||
```text
|
||
/home/mes123456/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` 中的本地和浏览器验收。
|
||
|