收敛 INI 面板状态 API namespace

This commit is contained in:
2026-06-14 22:23:02 +08:00
parent 25268404cb
commit a1c34e454e
5 changed files with 105 additions and 6 deletions

View File

@@ -761,3 +761,70 @@ host_wasm_opfs_browser_smokes=ok
INI panel API namespace例如 `window.linuxCncIniPanelApi.getMachineSessionStateReport()`
和 `getMachineSessionStateReportExport()`,为后续控制网页界面调用 save/restore/load/run
工作流预留统一入口;仍先不做复杂按钮,不解析 CNC 语义,不扩大 LinuxCNC runtime 边界。
七、2026-06-14 继续执行记录INI panel API namespace
本轮继续推进“控制网页界面/API surface”方向把上轮的 report/export getter 收敛到
明确的 INI panel API namespace为后续统一暴露 save、restore、load、run 工作流入口做准备。
完成内容:
- `wasm-port/runtime/ui/ini-panel/app.js` 新增
`window.linuxCncIniPanelApi`
- namespace 当前暴露:
- `getMachineSessionStateReport()`
- `getMachineSessionStateReportExport()`
- 保留旧的 `window.getMachineSessionStateReport()` 与
`window.getMachineSessionStateReportExport()` 作为兼容 shim
- `wasm-port/tests/browser/ini_panel_smoke.html` 改为优先通过
`window.linuxCncIniPanelApi` 读取 report/export
- browser smoke 继续验证旧 global getter 与 namespace getter 输出一致;
- `wasm-port/docs/ui-panel-state-summary.md` 明确上层 UI/API 应读取
`window.linuxCncIniPanelApi.getMachineSessionStateReport()`,不要抓 DOM 或直接依赖
`window.linuxCncIniPanelMachineSessionState`
- 未新增复杂 UI 按钮;
- 未改变 OPFS/session persistence、LinuxCNC interpreter、G-code 文本、canonical-event
语义、tool、parameter、planner 或 LinuxCNC-owned runtime semantics。
验证已通过:
```bash
git diff --check
wasm-port/tests/ui/node/verify_ini_panel_state_summary.sh
SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
wasm-port/tests/ui/node/verify_ui_node_smokes.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_state_summary_node_smoke=ok
browser_ini_opfs_smoke=ok
ini_panel_run_summary_node_smoke=ok
ini_panel_run_workflow_node_smoke=ok
ini_panel_session_summary_node_smoke=ok
ini_panel_session_workflow_node_smoke=ok
ini_panel_machine_file_summary_node_smoke=ok
ui_node_smokes=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
```
下一步建议:
继续按“实质性能力优先”推进。下一批建议在 `window.linuxCncIniPanelApi` 下暴露第一个
只读/低风险 workflow-facing helper例如 `getMachineSessionState()` 或
`getMachineSessionWorkflowStatus()`,把当前 last action、error、readiness、session/run
摘要合并为控制网页界面可直接轮询的状态对象;仍不新增按钮、不解析 G-code、不把 CNC
语义搬进 JS。