# 05 验收证据

生成日期：2026-06-27

## 1. 本轮命令证据

执行目录：

```text
/home/meswork/cnc_wams
```

### 1.1 静态构建

命令：

```bash
npm --prefix /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app run build
```

结果：

```text
退出码：0
gmoccapy_static_build=ok
```

产物：

```text
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/dist/index.html
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/dist/src/main.js
```

### 1.2 Node smoke

命令：

```bash
npm --prefix /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app run smoke:node
```

结果：

```text
退出码：0
linuxcnc_kinematics_runtime_smoke=ok
linuxcnc_interpreter_runtime_smoke=ok
linuxcnc_ini_runtime_smoke=ok
run_preconditions_ini_profile_smoke=ok
run_preconditions_kinematics_smoke=ok
run_preconditions_machine_file_smoke=ok
run_feedback_status_loop_smoke=ok
run_ready_sequence_smoke=ok
linuxcnc_task_hal_runtime_smoke=ok
task_hal_machine_file_smoke=ok
switchkins_remap_hal_sync_smoke=ok
browser_task_hal_worker_smoke=ok
native_task_hal_source_artifact_audit=ok
full_linuxcnc_5axis_source_node_smoke=ok
real_linuxcnc_5axis_program_cases_smoke=ok
full_execution_boundary_smoke=ok
machine_file_staging_smoke=ok
five_axis_session_smoke=ok
rtcp_store_smoke=ok
profile_boundary_smoke=ok
gmoccapy_xyzab_profile_smoke=ok
gmoccapy_icon_manifest_smoke=ok
gmoccapy_icon_registry_smoke=ok
gmoccapy_communication_model_smoke=ok
gmoccapy_hal_model_smoke=ok
gmoccapy_xyzab_gates_smoke=ok
linear_unit_conversion_smoke=ok
```

额外输出摘要：

```text
native_task_hal_readiness_artifact=web-rtcp-5axis-sim-plan/build/readiness/native-task-hal-readiness.json
hardware_drive=0
host_realtime_kernel=0
external_user_m_process_ready=0
tool_db_process_ready=0
promotion_scope=web_simulation_only
linuxcnc_source_program_case_count=8
all_cases_program_preview_points=ok
all_cases_executed_path_points=ok_after_run_or_step
all_cases_toolpath_preview_source=linuxcnc_interpreter_canonical_motion
all_cases_tool_execution_trace_source=linuxcnc_tp_samples_or_task_motion_hal_feedback
all_switchkins_cases_rtcp_state_changes_verified=1
fixture_toolpath_fallback_not_promoted=1
```

### 1.3 浏览器 smoke

命令：

```bash
npm --prefix /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app run smoke
```

结果：

```text
退出码：0
gmoccapy_shell_smoke=ok
gmoccapy_dist_smoke=ok
```

覆盖说明：

- `verify_gmoccapy_shell_browser.sh` 使用 headless Chromium 打开测试页。
- `verify_gmoccapy_dist_browser.sh` 先构建 dist，再打开 dist 入口。
- 浏览器断言覆盖主区域、Three.js canvas dataset、profile 切换、RTCP 诊断、LinuxCNC INI 诊断、Task policy 诊断、按钮图标、按钮 active/inactive 视觉状态和 G-code 行高亮。

### 1.4 QA 站点回归测试

命令：

```bash
npm --prefix /home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test test
```

结果：

```text
退出码：0
site_test_status=PASS
site_test_target_url=http://127.0.0.1:35861/web-rtcp-5axis-sim-plan/app/index.html
site_test_report=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/site-test-report.json
```

报告摘要：

```text
status=PASS
generatedAt=2026-06-28T00:31:19.883Z
findings=41
failures=0
warnings=0
consoleErrors=0
pageErrors=0
requestFailures=0
```

修复说明：

- `run-site-test.mjs` 默认从当前仓库启动本地静态服务，避免把本地修复结果和远端旧部署混在一起；如需测远端，仍可通过 `TARGET_URL=...` 覆盖。
- 点击逻辑改为每次在页面上下文即时查询元素，修复 Puppeteer `Node is detached from document`。
- STEP 验收改为 Task/HAL `singleStepping=true` 且保持暂停态。
- Restore Session 前先进入 MANUAL 并确认 JOG 改变坐标，再验证恢复快照。

## 2. working7 全量功能实际执行图文证据

本轮新增全量实测证据，覆盖所有主要按钮、程序执行、刀具预览、刀具实时执行路径、G-code 执行过程、机床轴值和右侧控制区。

命令：

```bash
npm --prefix /home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test run evidence:working7:full
```

结果：

```text
退出码：0
working7_full_functional_status=PASS
working7_full_functional_job_id=w7full-20260628002838-518bf522
working7_full_functional_report_id=report-w7full-20260628002838-518bf522
working7_full_functional_json=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence-report.json
working7_full_functional_pdf=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence-report.pdf
working7_full_functional_md=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence-report.md
working7_full_functional_screenshots=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence
```

报告摘要：

```text
jobId=w7full-20260628002838-518bf522
reportId=report-w7full-20260628002838-518bf522
evidenceScope=working7-full-functional-evidence
generatedAt=2026-06-28T00:28:38.507Z
targetUrl=http://127.0.0.1:41281/web-rtcp-5axis-sim-plan/app/index.html
status=PASS
steps=19
actions=73
failedActions=0
checks=6
failedChecks=0
consoleErrors=0
networkErrors=0
pageErrors=0
```

图文报告：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence-report.md
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence-report.pdf
```

截图：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/01-loaded-inventory.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/02-initial-run-blocked.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/03-powered-homed.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/04-auto-right-panel.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/05-right-sidebar-all-states.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/06-profile-xyzbc.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/07-preview-buttons.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/08-linuxcnc-source-loaded.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/09-open-file-loaded.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/10-run-ready.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/11-run-realtime-path.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/12-pause-resume-step.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/13-stop-idle.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/14-manual-jog-axis-values.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/15-mdi-execution.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/16-overrides-hal.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/17-spindle-coolant.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/18-session-fullscreen.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-full-functional-evidence/19-diagnostics-audit.png
```

覆盖说明：

- 全量报告使用第一人称图文格式。
- 每个阶段都记录截图、store 状态、DRO、axisPose、canvas dataset、G-code 当前行和关键按钮状态。
- `gmoccapy-xyzab` 作为 reference-only profile 验证 TCP 禁用原因，不作为 RTCP proof。
- 最终报告无 console、network 或 page error。

## 3. working7 手册流程专项 QA 证据

本轮新增专项证据，覆盖原任务矩阵中需要截图/PDF 的手册操作流。

命令：

```bash
npm --prefix /home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test run evidence:working7
```

结果：

```text
退出码：0
working7_manual_flow_status=PASS
working7_manual_flow_job_id=w7-20260628002915-30d1c6c8
working7_manual_flow_report_id=report-w7-20260628002915-30d1c6c8
working7_manual_flow_json=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence-report.json
working7_manual_flow_pdf=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence-report.pdf
working7_manual_flow_screenshots=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence
```

报告信息：

```text
jobId=w7-20260628002915-30d1c6c8
reportId=report-w7-20260628002915-30d1c6c8
evidenceScope=working7-manual-flow-evidence
generatedAt=2026-06-28T00:29:15.240Z
targetUrl=http://127.0.0.1:41931/web-rtcp-5axis-sim-plan/app/index.html
status=PASS
consoleErrors=0
networkErrors=0
pageErrors=0
```

截图：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/01-loaded.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/02-powered-homed-manual.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/03-auto-active.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/04-manual-jog-x.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/05-mdi-command.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/06-overrides-hal.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/07-spindle-coolant.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/08-session-restored.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/working7-manual-flow-evidence/09-diagnostics.png
```

检查项摘要：

```text
Main shell regions and canvas are ready=PASS
POWER and HOME leave MANUAL ready=PASS
AUTO activates without losing power/home=PASS
Manual jog changes X=PASS
MDI command is accepted in MDI mode=PASS
Overrides reset and HAL toggles are active=PASS
Spindle and coolant controls update state=PASS
Session restore returns to saved profile=PASS
Diagnostics expose Task/HAL and gmoccapy HAL=PASS
Screenshots are nonblank=PASS
```

专项说明：

- MDI 浏览器证据证明真实页面可进入 MDI 并提交 `G90 X12.5 Y-4 Z1.25 F900`，Task/HAL runtime 接收后进入 MDI/reading 状态。
- `rtcp_store_smoke=ok` 继续作为 MDI 坐标更新、MDI 历史和 profile 限位夹紧的 Node store 逻辑证据。
- Save/Restore 本轮在浏览器中使用 OPFS，路径为 `web-rtcp-5axis-sim-plan/sessions/working7-manual-flow/working7-session.json`。

## 4. 既有 QA 证据

项目已有可引用 QA 证据：

### 3.1 gmoccapy XYZAB 功能报告

JSON：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json
```

PDF：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.pdf
```

报告信息：

```text
jobId=xyzab-20260626214346-f4b4aa36
reportId=report-xyzab-20260626214346-f4b4aa36
evidenceScope=gmoccapy-xyzab-function
generatedAt=2026-06-26T21:43:46.310Z
targetUrl=http://127.0.0.1:36983/web-rtcp-5axis-sim-plan/app/index.html
screenshotsDir=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab
```

截图：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/01-loaded.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/02-profile-selected.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/03-run-blocked-power.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/04-run-blocked-reference-evidence.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/05-controls-active.png
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/06-hal-diagnostics.png
```

### 3.2 按钮控制报告

JSON：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/button-control-evidence-report.json
```

PDF：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/button-control-evidence-report.pdf
```

报告信息：

```text
jobId=btn-20260623091525-b35869f1
reportId=report-btn-20260623091525-b35869f1
evidenceScope=button-control-evidence
generatedAt=2026-06-23T09:15:25.426Z
targetUrl=http://127.0.0.1:41741/web-rtcp-5axis-sim-plan/app/index.html
screenshotsDir=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/button-control-evidence
```

截图目录：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/button-control-evidence
```

### 3.3 Native Task/HAL 对比

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.json
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.md
```

### 3.4 LinuxCNC source run 报告

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/test-linuxcnc-source-run-report-2026-06-23.docx
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/test-linuxcnc-source-run-report.json
```

## 4. 页面和脚本入口

本地 app：

```text
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/index.html
```

dist app：

```text
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/dist/index.html
```

浏览器 smoke 测试页：

```text
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/tests/browser/gmoccapy_shell_smoke.html
```

浏览器验证脚本：

```text
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh
/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_dist_browser.sh
```

专项 QA 脚本：

```text
/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/capture-working7-manual-flow-evidence.mjs
```

## 5. 证据缺口

当前没有缺少构建/自动化 smoke 证据，也已有本轮手册流程专项 JSON/PDF/截图证据。

如后续验收要求“逐条复刻操作手册每一个按钮截图”或“生成新的 Word 汇总报告”，需要补充：

- 新的 job_id/report_id。
- 更细粒度的每个按钮截图路径。
- 人工或 Playwright 执行时的目标 URL。
- MDI 历史按钮专项截图。