推进 INI 面板 restore/load session workflow helper

text11.txt

@@ -302,3 +302,82 @@ wasm-port/tests/host/verify_host_smokes.sh
   更新抽成可调用 workflow helper；
 - 给 UI/API 暴露一个更完整的 machine session state snapshot，用于上层应用直接消费；
 - 只在这些 workflow helper 的验证需要时，继续收敛局部测试胶水。
+
+一、2026-06-14 继续执行记录：INI panel restore/load session workflow helper
+
+本轮按 `text11.txt` 第一原则继续推进实质性 UI/session persistence 能力，把
+`Restore Session Snapshot` 和 `Restore And Load Session` 两条用户流程抽成可复用 workflow
+helper，而不是继续做局部 path/test glue 收敛。
+
+完成内容：
+
+- 扩展 `wasm-port/runtime/ui/ini-panel/session-workflow.js`；
+- 新增导出：
+  - `restoreMachineSessionSnapshotWorkflow(input)`；
+  - `sessionSnapshotRestoreLogLines(summary)`；
+- restore workflow 通过注入函数执行：
+  - `loadMachineSessionSnapshot(...)`；
+  - `loadMachineTextFiles(...)`；
+  - 可选 `loadSession()`；
+- restore-only 返回：
+  - restored snapshot；
+  - editor INI text；
+  - snapshot summary；
+  - OPFS field state；
+  - restore log lines；
+- restore-and-load 返回：
+  - loaded session；
+  - load summary；
+  - WASM field state；
+  - snapshot + OPFS-to-WASM load log lines；
+- `wasm-port/runtime/ui/ini-panel/app.js` 的 `Restore Session Snapshot` 和
+  `Restore And Load Session` 按钮改为调用 workflow helper，按钮处理器只负责写 editor、
+  field 和 log；
+- `wasm-port/tests/ui/node/verify_ini_panel_session_workflow.mjs` 覆盖 save、restore-only
+  和 restore-and-load 三条 workflow；
+- `wasm-port/docs/ui-session-summary-helpers.md` 更新 restore workflow API、返回结构、
+  log helper 和边界说明；
+- 未改变 OPFS bridge、snapshot-store、machine-file-store、LinuxCNC interpreter、tool、
+  parameter、G-code 文本或 LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_ini_panel_session_workflow.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.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/host/verify_host_smokes.sh
+```
+
+关键输出：
+
+```text
+ini_panel_session_workflow_node_smoke=ok
+ini_panel_run_summary_node_smoke=ok
+ini_panel_session_summary_node_smoke=ok
+ini_panel_machine_file_summary_node_smoke=ok
+ini_panel_state_summary_node_smoke=ok
+ui_node_smokes=ok
+browser_ini_opfs_smoke=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
+host_wasm_opfs_browser_smokes=ok
+```
+
+下一步建议：
+
+继续按“实质性能力优先”推进。下一批优先把 `run-gcode` 的用户流程抽成可调用 workflow
+helper，覆盖 snapshot/default program selection、G-code OPFS load、WASM write、LinuxCNC
+interpreter run、run summary、field/log state 和 error state。该 helper 仍只能编排
+host/runtime boundary，不解析或实现 G-code、planner、tool、parameter 或 canonical-event
+语义。