完善五轴 RTCP 仿真与验证资料

work/working7/02-项目程序开发详细步骤.md

@@ -0,0 +1,60 @@
+# 02 项目程序开发详细步骤
+
+生成日期：2026-06-27
+
+本文件是本轮最终版开发/测试步骤索引；原有详细测试方法见 [02-程序测试开发完善详细步骤.md](02-程序测试开发完善详细步骤.md)。
+
+## 我本轮新增的自动化入口
+
+我在 `qa/web-rtcp-5axis-site-test/package.json` 中增加：
+
+```json
+{
+  "evidence:working7": "node capture-working7-manual-flow-evidence.mjs",
+  "evidence:working7:full": "node capture-working7-full-functional-evidence.mjs"
+}
+```
+
+## 我新增的全量证据脚本
+
+文件：
+
+```text
+/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/capture-working7-full-functional-evidence.mjs
+```
+
+脚本执行流程：
+
+1. 启动本地静态 HTTP server。
+2. 使用 headless Chromium 打开真实 app 页面。
+3. 等待 canvas、store、kinematics、interpreter、Task/HAL 和 machine-file staging 就绪。
+4. 收集所有 `data-action` 控件库存。
+5. 实际点击并验证门禁、上电、回零、右侧控制区、profile、预览、Stage、source、Open、Run Ready、Run、Pause、Resume、Step、Stop、JOG、MDI、倍率、HAL、主轴、冷却、会话、Full、Audit、gmoccapy HAL/native page。
+6. 每个阶段截图，统计 canvas 非空像素。
+7. 输出 JSON、Markdown 图文报告和 PDF 图文报告。
+
+## 我修复程序的步骤
+
+1. 先运行全量 evidence，记录失败动作和状态快照。
+2. 修正安全初始状态：主轴关闭、冷却关闭、当前速度为 0。
+3. 修正 Task/HAL 状态回写：JOG/MDI 通过 `preserveAxisPose` 和 `preserveMachine` 保留 Web 侧执行结果。
+4. 修正 STOP/ABORT：停止后保留 `interpState=idle`。
+5. 修正 reference-only profile 测试口径：`gmoccapy-xyzab` 不等待 RTCP proof，只验证 TCP 禁用和 reference-only 原因。
+6. 修正资源路径噪声：favicon、INI source/dist 路径、gmoccapy reference 资源复制、`linuxcnc/` staging URL、reference-only kinematics 跳过。
+7. 更新旧 working7 手动流程脚本的冷却 flood 断言。
+8. 重新运行 build、Node smoke、browser smoke、full evidence、manual evidence，直到全部 PASS 且 console/network/page error 为 0。
+
+## 最终复跑命令
+
+```bash
+npm --prefix /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app run build
+npm --prefix /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app run smoke:node
+npm --prefix /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app run smoke
+npm --prefix /home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test run evidence:working7:full
+npm --prefix /home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test run evidence:working7
+```
+
+最终验收：
+
+- full evidence：73 个 action PASS，19 张截图，console/network/page error 均为 0。
+- manual evidence：10 个检查项 PASS，9 张截图，console/network/page error 均为 0。