cnc_wams/web-rtcp-5axis-sim-plan/working1/README.md

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

生成时间：2026-06-22

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

/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 中的本地和浏览器验收。