docs: record pause wasm implementation plan

work/working8/05-验收证据.md

@@ -0,0 +1,169 @@
+# 05-验收证据
+
+## 证据要求
+
+每条证据必须记录：
+
+- 执行时间；
+- 命令或页面；
+- 关键输出；
+- 生成文件路径；
+- 对应任务编号。
+
+## 当前已有参考证据
+
+### Web 前端暂停冻结历史证据
+
+来源文件：
+
+`/home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan/working/17-20260706-暂停按钮严格测试报告.md`
+
+历史结论：
+
+- `npm --prefix app run build` 通过。
+- `npm --prefix app run smoke:node` 通过。
+- `npm --prefix app run smoke:browser` 通过。
+- `trace-pause-position-json.mjs` 输出 `pause_position_status=passed-position-frozen`。
+- `verify-estop-power-home-run-pause-50ms.mjs` 输出 `verification_status=passed`。
+
+注意：
+
+该证据证明 Web 表层暂停冻结通过，但不能单独证明 `wasm-port` 底层已完整对标 LinuxCNC task/motion/TP 暂停链。
+
+## 本轮文档建档证据
+
+时间：2026-07-07
+
+操作：
+
+```bash
+sed -n '1,240p' web-rtcp-5axis-xyzbc-trt-sim-plan/doc/AXIS暂停按钮LinuxCNC调用链分析.md
+rg -n "pause|paused|AUTO_PAUSE|AUTO_RESUME|task_paused|interpState|EMCMOT_PAUSE|PLAN_PAUSE|runState|tbtn_pause" wasm-port web-rtcp-5axis-xyzbc-trt-sim-plan/app web-rtcp-5axis-xyzbc-trt-sim-plan/tests web-rtcp-5axis-xyzbc-trt-sim-plan/tools -S
+sed -n '600,755p' wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_task_hal_wasm.cpp
+sed -n '1,460p' wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_motion_runtime.c
+sed -n '1,260p' wasm-port/tests/wasm/node/verify_task_hal_wasm.mjs
+```
+
+结论：
+
+- 已确认 AXIS 暂停调用链和当前 WASM wrapper 差距。
+- 已确认 `work/working8` 文档体系建立。
+
+对应任务：
+
+- `W8-014` 部分完成：文档框架已建立，后续仍需随代码实现补证据。
+
+## 待执行验收命令
+
+### WASM task/motion 验收
+
+对应任务：`W8-001` 至 `W8-006`
+
+```bash
+cd /home/mes123456/cnc_wams/wasm-port
+./tools/build_task_hal_wasm.sh
+node 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
+```
+
+新增断言期望：
+
+```text
+pause_freezes_motion_queue=ok
+resume_restores_interp_resume_state=ok
+step_returns_to_paused=ok
+```
+
+### WASM TP 验收
+
+对应任务：`W8-007`
+
+```bash
+cd /home/mes123456/cnc_wams/wasm-port
+./tools/build_tp_wasm.sh
+node tests/wasm/node/verify_tp_wasm.mjs
+```
+
+期望输出：
+
+```text
+tp_wasm_node_smoke=ok
+tp_pause_resume_smoke=ok
+```
+
+### Web Node 集成验收
+
+对应任务：`W8-008` 至 `W8-011`
+
+```bash
+cd /home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan
+npm --prefix app run build
+node tests/node/verify_run_feedback_loop.mjs
+```
+
+期望输出：
+
+```text
+run_feedback_status_loop_smoke=ok
+run_ready_sequence_smoke=ok
+```
+
+新增断言期望：
+
+```text
+pause_uses_motion_paused_gate=ok
+pause_freezes_task_hal_status_loop=ok
+```
+
+### 浏览器 trace 验收
+
+对应任务：`W8-012`
+
+```bash
+cd /home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan
+APP_URL_PATH=/web-rtcp-5axis-xyzbc-trt-sim-plan/app/dist/index.html node tools/trace-pause-position-json.mjs
+```
+
+期望输出：
+
+```text
+pause_position_status=passed-position-frozen
+position_changed=false
+changed_fields=
+```
+
+需要记录：
+
+- `trace=.../trace.json`
+
+### 50ms 长流程截图验收
+
+对应任务：`W8-013`
+
+```bash
+cd /home/mes123456/cnc_wams/web-rtcp-5axis-xyzbc-trt-sim-plan
+RUN_STABLE_BEFORE_FIRST_PAUSE_MS=3000 node tools/verify-estop-power-home-run-pause-50ms.mjs
+```
+
+期望输出：
+
+```text
+verification_status=passed
+captured_frames=...
+manifest=...
+```
+
+需要记录：
+
+- screenshots 目录；
+- manifest 文件；
+- 两次暂停保持阶段的 `sampleIndex`、`interpState`、`taskPaused`、`motionPaused`、`currentVelocity`。
+