推进 INI 面板快照 metadata 描述

text10.txt

@@ -854,3 +854,61 @@ host_wasm_opfs_browser_smokes=ok
 同一个 `UI_SESSION` descriptor 生成，例如补充 snapshot label、default G-code OPFS path
 和 UI workflow source，方便后续恢复/审计用户会话；并在 browser smoke 中验证 metadata
 可从 saved snapshot round trip 读回。仍不解析或改写任何 CNC 语义。
+
+十一、2026-06-14 继续执行记录：INI panel snapshot metadata descriptor
+
+本轮继续沿 OPFS/session/UI boundary 推进，让 `Save Session Snapshot` 的 metadata
+由 `UI_SESSION` descriptor 统一生成，并补 browser round-trip 覆盖。
+
+完成内容：
+
+- 在 `wasm-port/runtime/ui/ini-panel/app.js` 新增 `sessionSnapshotMetadata()`；
+- metadata 现在包含：
+  - `source: "ini-panel"`；
+  - `workflow: "save-session-snapshot"`；
+  - `snapshotLabel: "ui-machine-session/ui-machine-session.json"`；
+  - `defaultGcodeOpfsPath: "linuxcnc/gcode/ui-session.ngc"`；
+- `saveMachineSessionSnapshot(...)` 调用改为使用 `sessionSnapshotMetadata()`；
+- browser INI panel smoke 在 UI 保存 snapshot 后，调用
+  `loadMachineSessionSnapshot("ui-machine-session", "xyzab-tdr", ...)` 读回 snapshot；
+- browser smoke 验证 source、workflow、snapshot label 和默认 G-code OPFS path metadata
+  均可 round trip；
+- 未改变 snapshot envelope 格式、payload 文件清单、OPFS path model、G-code 文本内容、
+  interpreter run API 或 LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+wasm-port/tests/opfs/node/verify_file_service.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
+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
+browser_ini_opfs_smoke=ok
+opfs_file_service_node_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
+browser_interp_smoke=ok
+host_wasm_opfs_browser_smokes=ok
+```
+
+下一步建议：
+
+继续沿 OPFS/session/UI boundary 推进。优先把 saved/restored snapshot metadata 的关键信息
+显示到 INI panel 日志，例如 `Workflow` 与 `Default G-code`，让用户不用打开 JSON 也能审计
+保存/恢复的会话来源；并在 browser smoke 中验证日志包含这些 metadata。仍不解析或改写
+任何 CNC 语义。