推进 UI helper docs 索引

text10.txt

@@ -1607,3 +1607,59 @@ host_wasm_opfs_browser_smokes=ok
 继续沿 OPFS/session/UI boundary 推进。优先把 `ui-session-summary-helpers.md` 的验证入口
 同步到 `compatibility-validation.md` 或补充统一 UI helper docs 索引，确保新增 helper 和
 常规 gate 的关系可发现；仍只做 host/runtime boundary 文档和测试 glue，不扩展 CNC 语义。
+
+二十三、2026-06-14 继续执行记录：UI helper docs index
+
+本轮继续沿 OPFS/session/UI boundary 推进，把两个 UI helper 文档的入口同步到兼容性
+验证索引，方便后续查找对应 helper 和验证命令。
+
+完成内容：
+
+- 在 `wasm-port/docs/compatibility-validation.md` 新增 UI helper docs 索引：
+  - `wasm-port/docs/ui-run-summary-helpers.md`
+  - `wasm-port/docs/ui-session-summary-helpers.md`
+- 继续保留 UI helper Node smoke 入口：
+  - `wasm-port/tests/ui/node/verify_ui_node_smokes.sh`
+- 未改变 UI runtime、OPFS bridge、interpreter run API、G-code 文本、canonical-event 输出
+  或 LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/opfs/node/verify_file_service.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
+wasm-port/tests/host/verify_host_smokes.sh
+```
+
+关键输出：
+
+```text
+ini_panel_run_summary_node_smoke=ok
+ini_panel_session_summary_node_smoke=ok
+ui_node_smokes=ok
+vendor sync up to date
+standalone CNC semantics guard complete
+interp_wasm_node_smoke=ok
+sim_configs_wasm_node_inventory_executed=28
+sim_configs_wasm_node_inventory_passed=28
+sim_configs_wasm_node_inventory_skipped=131
+sim_configs_wasm_node_inventory_unexpected_fail=0
+opfs_file_service_node_smoke=ok
+browser_ini_opfs_smoke=ok
+browser_interp_smoke=ok
+host_wasm_opfs_browser_smokes=ok
+```
+
+下一步建议：
+
+继续沿 OPFS/session/UI boundary 推进。优先扫描 INI panel 中是否还有类似
+“日志文本 / DOM 状态 / 机器可读状态”三份并行维护的 host-boundary 数据，如果有，继续
+抽取为纯 helper 并接入 `verify_ui_node_smokes.sh`；保持 helper 只描述 host/runtime 边界，
+不扩展 CNC 语义。

wasm-port/docs/compatibility-validation.md

@@ -66,6 +66,11 @@ The current UI helper Node smoke validation command is:
 wasm-port/tests/ui/node/verify_ui_node_smokes.sh
 ```
 
+UI helper docs:
+
+- `wasm-port/docs/ui-run-summary-helpers.md`
+- `wasm-port/docs/ui-session-summary-helpers.md`
+
 The current browser smoke validation command is:
 
 ```bash