# 05-验收证据

## 验收范围

本轮验收覆盖：

- Run 条件不具备时可点击并提示原因。
- Run 条件满足后进入 task/HAL 执行。
- Stop、Pause、Resume、Step、Home 按钮驱动 task/HAL runtime。
- 按钮状态来自 LinuxCNC task policy 和 task/HAL status，而不是固定 UI 状态。

## 命令证据

### 1. 构建 task/HAL WASM

命令：

```bash
bash wasm-port/tools/build_task_hal_wasm.sh
```

结果：

```text
linuxcnc_task_hal_wasm_build=ok
```

### 2. WASM task/HAL runtime 测试

命令：

```bash
node wasm-port/tests/wasm/node/verify_task_hal_wasm.mjs
```

结果：

```text
linuxcnc_task_runtime_smoke=ok
task_status_from_linuxcnc_runtime=ok
task_commands_drive_motion_runtime=ok
mdi_jog_task_motion_hal_sync=ok
```

### 3. Web store + task/HAL runtime 测试

命令：

```bash
node web-rtcp-5axis-sim-plan/tests/node/verify_linuxcnc_task_hal_runtime.mjs
```

结果：

```text
linuxcnc_task_hal_runtime_smoke=ok
task_hal_machine_file_smoke=ok
switchkins_remap_hal_sync_smoke=ok
browser_task_hal_worker_smoke=ok
```

覆盖点：

- Run task/HAL feedback。
- MDI `M428` 后 `switchkinsType=1`。
- Home 后 Jog 保持坐标连续。
- Pause 后 `interpState=paused`。
- Resume 后 `interpState=reading`。
- Step 后 `singleStepping=true`。
- Stop 后 `motion.aborted=true`。

### 4. Run preconditions 测试

命令：

```bash
node web-rtcp-5axis-sim-plan/tests/node/verify_run_preconditions.mjs
```

结果：

```text
run_preconditions_ini_profile_smoke=ok
run_preconditions_kinematics_smoke=ok
run_preconditions_machine_file_smoke=ok
```

覆盖点：

- LinuxCNC INI 未加载时阻止 Run。
- task/HAL runtime 未就绪时阻止 Run。
- 未开机、未 AUTO、未 Home 时阻止 Run。
- 未选择 machine-file G-code 时阻止 Run。

### 5. Store 回归测试

命令：

```bash
node web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs
```

结果：

```text
rtcp_store_smoke=ok
```

### 6. 浏览器 smoke 测试

命令：

```bash
bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh
```

结果：

```text
gmoccapy_shell_smoke=ok
```

覆盖点：

- 页面渲染完整。
- task/HAL runtime worker 就绪。
- blocked Run 按钮不 disabled。
- blocked Run 按钮有 `data-command-ready=false` 和 `aria-disabled=true`。
- 点击 blocked Run 后输出 blocked 原因。
- Pause/Resume browser workflow 正常。

### 7. 浏览器按钮流程截图取证

命令：

```bash
node --check qa/web-rtcp-5axis-site-test/capture-button-control-evidence.mjs
node qa/web-rtcp-5axis-site-test/capture-button-control-evidence.mjs
```

结果：

```text
button_control_evidence_status=PASS
button_control_evidence_job_id=btn-20260623091525-b35869f1
button_control_evidence_report_id=report-btn-20260623091525-b35869f1
button_control_evidence_json=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/button-control-evidence-report.json
button_control_evidence_pdf=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/button-control-evidence-report.pdf
button_control_evidence_screenshots=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/button-control-evidence
```

覆盖点：

- Home 后 `allHomed=true`，保持 manual/idle 状态。
- Run 后 `runState=running`，runtime feedback 来源为 `linuxcnc-task-motion-hal-wasm`。
- Pause 后 `runState=paused`，`taskPaused=true`。
- Resume 后恢复 `runState=running` 和 `interpState=reading`。
- Step 后 `singleStepping=true`，并保持 paused。
- Stop 后 `runState=stopped`，`motion.aborted=true`。
- 14 张截图非空，且每一步记录 `RUN/STOP/PAUSE/RESUME/STEP/HOME` 的 readiness 属性。

### 8. 云端部署与按钮流程验收

部署命令摘要：

```bash
bash wasm-port/tools/build_task_hal_wasm.sh
npm --prefix web-rtcp-5axis-sim-plan/app run build
tar -C web-rtcp-5axis-sim-plan/app/dist -czf /tmp/web-rtcp-5axis-sim-8092-working1.tar.gz .
```

云端发布：

```text
host=82.156.24.101
user=ubuntu
nginx root=/var/www/web-rtcp-5axis-sim
remote tar=/home/ubuntu/tmp/web-rtcp-5axis-sim-8092-working1-20260623051405.tar.gz
remote staging=/home/ubuntu/tmp/web-rtcp-5axis-sim-8092-working1-20260623051405
remote backup=/home/ubuntu/tmp/web-rtcp-backups/web-rtcp-5axis-sim-before-working1-20260623051405
```

云端验证：

```text
sudo nginx -t -> nginx: configuration file /etc/nginx/nginx.conf test is successful
curl -k -I https://127.0.0.1:8092/ -> HTTP/2 200
```

公网按钮流程取证命令：

```bash
TARGET_URL='https://82.156.24.101:8092/' \
EVIDENCE_SCOPE='cloud-button-control-evidence' \
node qa/web-rtcp-5axis-site-test/capture-button-control-evidence.mjs
```

结果：

```text
button_control_evidence_status=PASS
button_control_evidence_job_id=btn-20260623091811-c291e49b
button_control_evidence_report_id=report-btn-20260623091811-c291e49b
button_control_evidence_json=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/cloud-button-control-evidence-report.json
button_control_evidence_pdf=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/cloud-button-control-evidence-report.pdf
button_control_evidence_screenshots=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/cloud-button-control-evidence
```

### 9. LinuxCNC native task/HAL 对照报告

命令：

```bash
bash wasm-port/tests/native/verify_task_hal_phase0.sh
node web-rtcp-5axis-sim-plan/tests/node/verify_native_task_hal_audit.mjs
node --check qa/web-rtcp-5axis-site-test/capture-native-task-hal-comparison.mjs
node qa/web-rtcp-5axis-site-test/capture-native-task-hal-comparison.mjs
```

结果：

```text
task_hal_phase0_native_probe_gate=ok
native_task_hal_source_artifact_audit=ok
native_task_hal_comparison_status=PASS_WITH_HOST_NATIVE_RUNTIME_BLOCKER
native_task_hal_comparison_json=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.json
native_task_hal_comparison_markdown=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.md
native_task_hal_transition_log_available=0
native_task_hal_host_blocker_count=15
```

阻塞证据摘要：

- `linuxcnc/scripts/linuxcnc` 和 `linuxcnc/scripts/rip-environment` 硬编码旧路径 `/home/cnc/桌面/cnc_wams/linuxcnc`。
- `linuxcnc/bin/halcmd` 要求当前主机没有的 `GLIBC_2.38`。
- `linuxcnc/bin/rs274` 要求当前主机没有的 `GLIBC_2.38`、`GLIBCXX_3.4.31` 和 `libpython3.13.so.1.0`。
- 当前主机 glibc 为 `Ubuntu GLIBC 2.35`，`libstdc++` 只到 `GLIBCXX_3.4.30`。

结论：BTN-013 已形成可复核 native/source 对照和 host-native blocker 证据；不声明 native task 状态转换日志已生成。

## 页面证据

本轮执行的是本地和云端 browser 验收：

- 页面入口：`web-rtcp-5axis-sim-plan/app/index.html`
- 云端入口：`https://82.156.24.101:8092/`
- 浏览器验证脚本：`web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh`
- 按钮流程取证脚本：`qa/web-rtcp-5axis-site-test/capture-button-control-evidence.mjs`
- 按钮流程 JSON：`qa/web-rtcp-5axis-site-test/output/button-control-evidence-report.json`
- 按钮流程 PDF：`qa/web-rtcp-5axis-site-test/output/button-control-evidence-report.pdf`
- 按钮流程截图目录：`qa/web-rtcp-5axis-site-test/screenshots/button-control-evidence/`
- 云端按钮流程 JSON：`qa/web-rtcp-5axis-site-test/output/cloud-button-control-evidence-report.json`
- 云端按钮流程 PDF：`qa/web-rtcp-5axis-site-test/output/cloud-button-control-evidence-report.pdf`
- 云端按钮流程截图目录：`qa/web-rtcp-5axis-site-test/screenshots/cloud-button-control-evidence/`
- Native 对照 JSON：`qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.json`
- Native 对照 Markdown：`qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.md`

## 文件证据

实现文件：

- `wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_motion_runtime.c`
- `wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_task_hal_wasm.cpp`
- `web-rtcp-5axis-sim-plan/app/src/state/store.js`
- `web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`

测试文件：

- `web-rtcp-5axis-sim-plan/tests/browser/gmoccapy_shell_smoke.html`
- `web-rtcp-5axis-sim-plan/tests/node/verify_linuxcnc_task_hal_runtime.mjs`
- `qa/web-rtcp-5axis-site-test/capture-button-control-evidence.mjs`
- `qa/web-rtcp-5axis-site-test/capture-native-task-hal-comparison.mjs`

过程日志：

- `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`

## 验收结论

本轮功能已通过 WASM、Node、browser 三层验证。按钮行为已从单纯 UI 操作提升为 LinuxCNC task/HAL 状态驱动的控制流程。
