Guard browser OPFS custom session save options

text8.txt

@@ -1320,3 +1320,56 @@ host_wasm_opfs_browser_smokes=ok
 继续小批量 browser OPFS test glue guard。优先扫描 custom session 的 save
 parameter/tool-table options object 是否还能用 locals/helper 收敛；只改测试胶水，
 不改变 custom filename 输入、OPFS path、WASM path 字符串或保存/读取行为。
+
+二十九、2026-06-14 继续执行记录：browser OPFS custom session save options helper guard
+
+本轮按上一条下一步建议继续收敛 custom session 的 save parameter/tool-table options
+object，范围仍只触及 `wasm-port/tests/browser/interp_smoke.html` 的 browser/OPFS test
+glue。
+
+完成内容：
+
+- 新增 `opfsLoadedFileSaveOptions(...)`，统一从 loaded session file entry 派生
+  `{ opfsPath, wasmPath }` save options；
+- INI-named session 的 parameter save options 复用 `opfsLoadedFileSaveOptions(...)`；
+- INI-named session 的 tool-table save options 复用 `opfsLoadedFileSaveOptions(...)`；
+- explicit override session 的 parameter save options 复用
+  `opfsLoadedFileSaveOptions(...)`；
+- explicit override session 的 tool-table save options 复用
+  `opfsLoadedFileSaveOptions(...)`；
+- custom parameter/tool-table filename 输入、OPFS path、WASM path 字符串与
+  save/read 行为均未改变；
+- 未改变 staging path 模型、OPFS bridge behavior、file-service、SDK planner、
+  interpreter、INI、tool、parameter 或 LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_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
+browser_interp_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
+```
+
+下一步建议：
+
+继续小批量 browser OPFS test glue guard。优先扫描 custom session 中 saved
+parameter value object 是否还能用 helper/locals 收敛；只改测试胶水，不改变参数值、
+custom filename 输入、OPFS path、WASM path 字符串或保存/读取行为。

wasm-port/tests/browser/interp_smoke.html

@@ -4630,6 +4630,13 @@
       };
     }
 
+    function opfsLoadedFileSaveOptions(loadedFile) {
+      return {
+        opfsPath: loadedFile.opfsPath,
+        wasmPath: loadedFile.wasmPath,
+      };
+    }
+
     async function verifyOpfsSavedText(label, loadActualText, expectedLines) {
       verifyExpectedOutput(label, await loadActualText(), expectedLines.join("\n"));
     }
@@ -9591,10 +9598,7 @@
           5221: 5.25,
           5399: 199,
         },
-        {
-          opfsPath: loadedIniFileSession.parameters.opfsPath,
-          wasmPath: loadedIniFileSession.parameters.wasmPath,
-        },
+        opfsLoadedFileSaveOptions(loadedIniFileSession.parameters),
       );
       assertOpfsSavedParameterStaging(
         "opfs_save_ini_named_parameters_staging",
@@ -9630,10 +9634,7 @@
       const savedIniNamedToolTable = await saveMachineToolTableToOpfs(
         interp,
         iniFileMachineId,
-        {
-          opfsPath: loadedIniFileSession.toolTable.opfsPath,
-          wasmPath: loadedIniFileSession.toolTable.wasmPath,
-        },
+        opfsLoadedFileSaveOptions(loadedIniFileSession.toolTable),
       );
       assertOpfsSavedToolTableStaging(
         "opfs_save_ini_named_tool_table_staging",
@@ -9732,10 +9733,7 @@
           5221: 7.5,
           5399: 202,
         },
-        {
-          opfsPath: loadedIniOverrideSession.parameters.opfsPath,
-          wasmPath: loadedIniOverrideSession.parameters.wasmPath,
-        },
+        opfsLoadedFileSaveOptions(loadedIniOverrideSession.parameters),
       );
       assertOpfsSavedParameterStaging(
         "opfs_save_explicit_parameters_staging",
@@ -9762,10 +9760,7 @@
       const savedExplicitToolTable = await saveMachineToolTableToOpfs(
         interp,
         iniOverrideMachineId,
-        {
-          opfsPath: loadedIniOverrideSession.toolTable.opfsPath,
-          wasmPath: loadedIniOverrideSession.toolTable.wasmPath,
-        },
+        opfsLoadedFileSaveOptions(loadedIniOverrideSession.toolTable),
       );
       assertOpfsSavedToolTableStaging(
         "opfs_save_explicit_tool_table_staging",