SuperAPI AI 工具集

verify-atlas

通用与其它

查看项目

更新于 10-16 08:07

技能介绍

用途:verify-atlas 用于驱动正在运行的 Atlas 桌面构建,通过 CDP 对工作区 UI 做验证,包括检查 DOM、截图、点击、输入、读取无障碍树、执行 JS,以及管理 checkout 隔离的并行实例。资料说明这是示例,仅记录用法,驱动脚本未包含。

主要能力:命令分为检查(info、snapshot、screenshot、components)、导航(home、new-session、select-project、select-runtime、scroll)、交互(send、click、click-xy、aria-click、type、press、eval、upload-image、add-context、feature-flag)、性能(trace、profile、record、perf-metrics、wait-settle)、流式(console、network-log、network-summary)、健康与清理(doctor、cleanup、watch --restart)。

使用方式:先运行 doctor 检查 checkout 上下文、CDP 端口归属、watcher 存活与构建新鲜度。主工作区默认 CDP 端口 9222,直接驱动不加 --checkout;隔离 checkout 每条命令需加 --checkout,端口与 user-data-dir 按树派生。checkout 快速开始:node .cursor/skills/verify-atlas/control-atlas.mjs checkout-setup --watch;可选 clone-userdata --force --overwrite;--checkout restart;--checkout info;doctor;cleanup --remove-checkout。主工作区:info、doctor。桌面构建须已启用远程调试。

验证要求:不要提交“能打开”的截图,需走生产用户路径并展示可观察结果;用 eval 检查用户路径后的状态,而非调用内部处理器作为主要证据;先跑 doctor,陈旧 bundle 上的视频不算证据;阅读 references/features/ 下相关文件,覆盖可达入口、模式、启用的门控变体及成功/取消/错误/空/持久化路径;同一录制中展示触发与稳定终态;验证副作用而非仅像素。

驱动约定:优先 ARIA 标签、data-component、data-action-id、data-message-* 选择器,类选择器为后备;流式不确定,用 wait-settle 等待可观察终态而非固定睡眠;优先用注册快捷键的 press 而非坐标点击;命令服务不在 window 上,不要通过 eval 调用 atlas.*;门控路径用 feature-flag,特性文件要求时重载;真实 OS 文件拖放、原生上下文菜单、系统浏览器认证视为手动,除非驱动有一等支持。

限制:资料未提供驱动脚本、安装方式、收费、平台与效果信息;行为清单位于 references/features/,每个文件使用 Sub-features、How to get to it (user POV)、Driving it with control-atlas、Gotchas 四个 H2。