推进 INI 面板状态 report JSON 导出 helper

This commit is contained in:
2026-06-14 22:18:26 +08:00
parent 404cb1344c
commit 25268404cb
6 changed files with 186 additions and 0 deletions

View File

@@ -694,3 +694,70 @@ host_wasm_opfs_browser_smokes=ok
补一个更靠近上层消费者的 report export helper 或 SDK-facing wrapper例如把 report
序列化成稳定 JSON 文本/Blob 输入;仍只组合已有 host/runtime boundary facts不解析
G-code、不推导 CNC 语义、不读取 DOM。
六、2026-06-14 继续执行记录INI panel state report JSON export helper
本轮继续推进“导出层”,在不新增复制/下载按钮的前提下,把 machine session state report
包装成上层 UI/API 可直接复用的稳定 JSON export payload。
完成内容:
- `wasm-port/runtime/ui/ini-panel/panel-state-summary.js` 新增
`createMachineSessionStateReportExport(state, options)`
- export helper 返回:
- `filename`
- `mediaType: "application/json"`
- `report`
- 带末尾换行的 pretty JSON `text`
- `wasm-port/runtime/ui/ini-panel/app.js` 暴露
`window.getMachineSessionStateReportExport()`
- `wasm-port/tests/ui/node/verify_ini_panel_state_summary.mjs` 覆盖默认 filename、
media type、report 和 JSON text
- `wasm-port/tests/browser/ini_panel_smoke.html` 在真实 save、restore-load、run 后读取
browser export getter并验证 JSON text 可解析、run count 和 program source 稳定;
- `wasm-port/docs/ui-panel-state-summary.md` 增加 export helper 说明;
- 未新增 UI 按钮,未抓 DOM未直接依赖临时 window state
- 未改变 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
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_state_summary_node_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
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
host_wasm_opfs_browser_smokes=ok
```
下一步建议:
继续按“实质性能力优先”推进。下一批建议把 report/export getter 收敛成一个更明确的
INI panel API namespace例如 `window.linuxCncIniPanelApi.getMachineSessionStateReport()`
和 `getMachineSessionStateReportExport()`,为后续控制网页界面调用 save/restore/load/run
工作流预留统一入口;仍先不做复杂按钮,不解析 CNC 语义,不扩大 LinuxCNC runtime 边界。