SuperAPI AI 工具集

automation

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:为 Native SDK 应用提供自动化与验证能力,覆盖原生渲染应用和 WebView 外壳应用,用于冒烟测试、带图形会话的 CI 检查以及快速运行时检查。

主要能力:应用需在构建时启用自动化(如 zig build run -Dplatform=macos -Dautomation=true),并在 RuntimeOptions 中传入 native_sdk.automation.Server.init,默认通过 .zig-cache/native-sdk-automation/ 做文件式 IPC。可验证应用就绪、窗口元数据、JS 与 Zig 桥接往返、重载请求,以及对 retained-canvas(gpu_surface)视图做确定性参考渲染截图。命令包括 native automate wait、assert、list、snapshot、reload、screenshot、widget-action、widget-click、widget-hold、widget-context-press、widget-drag、widget-wheel、widget-key、widget-pinch、profile、bridge、menu-command、tray-action 等;assert 支持正则子集与 --absent、--timeout-ms。

使用方式:先以自动化方式启动应用,执行 native automate wait 等待 ready=true,再用 assert 做状态断言或用 snapshot 查看信息,用 bridge 做桥接往返检查,用 widget-* 驱动控件;从应用项目目录运行 CLI。

限制:不能对 WebView 内容截图,不支持任意 DOM 查询与点击及浏览器网络断言;截图只覆盖 gpu_surface 画布视图;跨机器字节一致性受限;桥接调用需允许 zero://inline 来源,否则返回 permission_denied。缺失信息暂未提供。