推进 OPFS 会话快照清单能力

text10.txt

@@ -230,6 +230,60 @@ groups，重点检查 `saveMachineTextFiles(...)` 相关输入是否已有可复
 - 把 save API 输入对象提成无用常量；
 - 触碰 runtime、SDK、OPFS bridge 或 LinuxCNC-owned semantics。
 
+二、2026-06-14 继续执行记录：browser OPFS session snapshot manifest helper
+
+本轮按“暂停性能测试，进行实质性功能推进”的要求，补充了一个新的 OPFS/runtime
+能力：生成可恢复的机器会话快照清单，范围仍局限在 `runtime/opfs` 与对应 smoke。
+
+完成内容：
+
+- 在 `wasm-port/runtime/opfs/snapshot-store.js` 新增
+  `createMachineSessionSnapshotPayload(machineId, options)`；
+- 该 helper 基于现有 `path-model` 生成机器级 session snapshot payload，默认包含
+  `ini`、`parameters`、`toolTable`，可选包含 `gcode`；
+- 支持自定义 `iniOpfsPath`、`parameterOpfsPath`、`toolTableOpfsPath`、`gcodeOpfsPath`；
+- 支持自定义 `iniFilename`、`parameterFilename`、`toolTableFilename`、`gcodeFilename`；
+- 在 Node OPFS smoke 与 browser INI panel smoke 中补了覆盖，验证默认路径、自定义
+  文件名和 G-code 路径均能按预期生成；
+- 未改变 session snapshot 的格式、版本、存储位置或既有 save/load 行为；
+- 未改变 OPFS bridge behavior、file-service、SDK planner、interpreter、INI、tool、
+  parameter 或 LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+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
+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
+opfs_file_service_node_smoke=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
+browser_interp_smoke=ok
+host_wasm_opfs_browser_smokes=ok
+```
+
+下一步建议：
+
+继续把这个 helper 扩到更明确的实际入口，优先扫描 browser/Node 里已有的 session
+snapshot 调用是否能复用它，或者把 machine session 生成入口整理到更显式的 API；
+只做 OPFS/filesystem/browser boundary 相关功能推进，不碰 CNC 语义。
+
 一、2026-06-14 继续执行记录：browser explicit readback path groups guard
 
 本轮按 `text10.txt` 第一候选批次继续收敛 explicit session saved readback path groups，