SuperAPI AI 工具集

script-kit-ui-testing

测试与质量

查看项目

更新于 10-15 23:34

技能介绍

用途:为 Script Kit GPUI 提供 UI 测试协议,适用于测试界面改动、运行脚本、截图和调试布局。

主要能力:所有 UI 测试通过 stdin JSON 协议进行,禁止把脚本作为 CLI 参数传入。支持的命令包括 run(运行指定绝对路径脚本)、show、hide、setFilter、showGrid、hideGrid、openNotes、openAi。测试时应始终设置 SCRIPT_KIT_AI_LOG=1,可节省约 70% token。

使用方式:构建测试循环为 cargo build,然后通过 echo 管道传入 JSON,例如 echo '{"type":"run","path":"'"$(pwd)"'/tests/smoke/test-editor-height.ts"}' | SCRIPT_KIT_AI_LOG=1 ./target/debug/script-kit-gpui 2>&1。日志可用 grep 过滤,或查看 ~/.scriptkit/logs/script-kit-gpui.jsonl。视觉测试使用 SDK 的 captureScreenshot() 仅捕获应用窗口,保存 PNG 到 .test-screenshots/ 并读取验证;禁止使用 screencapture、scrot、gnome-screenshot、flameshot、maim、ImageMagick import。网格叠加通过 showGrid 命令,可配置 gridSize(默认 8)、showBounds、showBoxModel、showAlignmentGuides、showDimensions、depth 等选项。SDK 的 getLayoutInfo() 返回窗口尺寸、promptType、组件信息等布局数据。

限制与反模式:不要用 CLI 参数运行脚本;不要认为必须手动交互才能测试;不要忘记 SCRIPT_KIT_AI_LOG=1;截图后必须读取验证 PNG;不要猜测布局,应使用截图、布局信息或网格叠加。