推进 INI 面板 control-page refresh workflow helper

text11.txt

@@ -1822,3 +1822,78 @@ host_wasm_opfs_browser_smokes=ok
 继续推进 OPFS/session persistence 或 browser/UI workflow 的实质链路。下一批建议在
 `app.js` 外抽出一个 control-page snapshot refresh workflow helper，让 read-only 页面能复用
 明确的 refresh 状态模型；仍保持只读，不新增控制按钮，不解析 G-code。
+
+二十四、2026-06-15 继续执行记录：INI panel control-page refresh workflow helper
+
+本轮按“第一原则：加快实质性推进”推进 browser/UI workflow，在 `app.js` 外新增
+read-only control-page refresh workflow helper，让外层页面可复用明确的 refresh 状态模型。
+
+完成内容：
+
+- 新增 `wasm-port/runtime/ui/ini-panel/control-page-refresh-workflow.js`；
+- 新增 `controlPageStatusText(status)`，格式化已观察到的 control view status 字段；
+- 新增 `createControlPageRefreshState(input)`，固定 refresh 状态结构；
+- 新增 `refreshMachineSessionControlPage(input)`，统一处理：
+  - `waiting`：panel API 尚不可用；
+  - `rendered`：读取 control view 并调用 renderer；
+  - `error`：control view getter 或 renderer 抛错；
+- `createMachineSessionControlPageController()` 改为通过 refresh workflow 执行 render；
+- control-page controller 新增 `refresh()`，保留原 `render()` 返回值兼容；
+- `control-page.js` 对浏览器页面暴露 `refreshControlPage`；
+- `ui-shell.js` re-export refresh workflow helper，并在 `createIniPanelShellViewModel()` 中暴露
+  `controlPage.refresh`；
+- 新增 `wasm-port/tests/ui/node/verify_ini_panel_control_page_refresh_workflow.mjs` 和 `.sh`；
+- `verify_ui_node_smokes.sh` 纳入 refresh workflow smoke；
+- browser control-page smoke 验证 `refreshControlPage().phase === "rendered"`；
+- `panel-entry.md` 和 entry docs gate 同步记录 refresh workflow API；
+- 未新增控制按钮；
+- 未解析 G-code；
+- 未解释 canonical events；
+- 未改变 OPFS/session persistence、LinuxCNC interpreter、tool、parameter、planner 或
+  LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_ini_panel_control_page_refresh_workflow.sh
+wasm-port/tests/ui/node/verify_ini_panel_control_page_controller.sh
+wasm-port/tests/ui/node/verify_ini_panel_ui_shell.sh
+wasm-port/tests/ui/node/verify_ini_panel_entry_docs.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_control_page_refresh_workflow_node_smoke=ok
+ini_panel_control_page_controller_node_smoke=ok
+ini_panel_ui_shell_node_smoke=ok
+ini_panel_entry_docs_node_smoke=ok
+ui_node_smokes=ok
+browser_ini_opfs_smoke=ok
+browser_ini_control_page_smoke=ok
+browser_ini_launch_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 persistence 的实质链路。下一批建议抽出
+`loadMachineSessionForControlPageWorkflow()` 或等价 helper，让 read-only control page 能以明确
+状态模型描述 embedded panel API readiness 和首帧 session state；仍保持只读，不新增控制按钮，
+不解析 G-code。