推进 INI 面板 launch API schema 暴露

This commit is contained in:
2026-06-15 06:58:04 +08:00
parent 30598120e4
commit 6b5999930a
8 changed files with 101 additions and 4 deletions

View File

@@ -1341,3 +1341,72 @@ host_wasm_opfs_browser_smokes=ok
继续推进 browser/UI workflow。下一批建议把 launch manifest 的 schema/version 信息暴露到
`linuxCncIniPanelLaunchApi` 的独立 `getLaunchApiSchema()` 方法,并由 browser launch smoke 与
focused Node gate 双向校验;仍保持只读,不新增控制按钮,不解析 G-code。
十七、2026-06-15 继续执行记录INI panel launch API schema exposure
本轮按“第一原则:加快实质性推进”继续推进 browser/UI workflow把 launch manifest 的
schema/version 信息通过真实 browser launch API 独立暴露,方便外部 shell 在读取完整 manifest
前先做兼容性判断。
完成内容:
- `createIniPanelShellViewModel()` 新增 `launchApiSchema`
- `launch.html` 的 `window.linuxCncIniPanelLaunchApi` 新增 `getLaunchApiSchema()`
- `createIniPanelLaunchApiManifest().methods` 新增 `getLaunchApiSchema`
- `ini_panel_launch_smoke.html` 在真实 launch iframe 中校验:
- `getLaunchApiSchema()` 存在;
- schema `manifestVersion`
- schema fields 包含 `persistenceCapabilities`
- manifest methods 包含 `getLaunchApiSchema`
- `verify_ini_panel_launch_api_manifest.mjs` 覆盖 shell view-model 的 `launchApiSchema`
- `verify_ini_panel_ui_shell.mjs` 覆盖 `launchApiSchema`
- `verify_ini_panel_entry_docs.mjs` 与 `docs/panel-entry.md` 记录并校验
`linuxCncIniPanelLaunchApi.getLaunchApiSchema()`
- 未新增控制按钮;
- 未解析 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_launch_api_manifest.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_launch_api_manifest_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
host_wasm_opfs_browser_smokes=ok
```
下一步建议:
继续推进 SDK/API surface。下一批建议为 `createIniPanelLaunchApiSchema()` 增加 focused schema
compatibility helper例如 `isSupportedIniPanelLaunchApiManifest()` 或等价只读 predicate让外部
shell 可以用 schema/version 判断 manifest 是否可消费,并由 Node/browser gate 校验;仍保持只读,
不新增控制按钮,不解析 G-code。