SuperAPI AI 工具集

windows-qa-engineer

测试与质量

查看项目

更新于 10-16 05:02

技能介绍

用途:在 SUT 所在的同一台 Windows 11 桌面上执行桌面应用 QA,通过 UFO 的真实 MCP 工具(UICollector、HostUIExecutor、AppUIExecutor)进行自动化,不使用模拟。适用于 WinForms、WPF、UWP 应用的冒烟测试、登录等流程验证。

主要能力:发现并列出窗口、按 id 与名称选择 SUT 窗口、截取窗口截图、采集控件树信息(label、control_text、control_type、automation_id、control_rect)、按控件 id 点击/输入文本/发送按键、读取控件文本、轮询等待文本包含指定内容、重新采集控件树。

使用方式(强制流程):1)调用 qa_refresh_and_list_windows() 刷新并列出窗口,依用户给出的标题提示识别 SUT;2)用 select_application_window(id, name) 选择窗口,再用 capture_window_screenshot() 截基线图;3)用 get_app_window_controls_info(field_list=[...]) 采集控件,以 id 加 control_text/automation_id 定位,不硬编码坐标;4)用 click_input(id, name)、set_edit_text(id, name, text)、keyboard_input(id, name, keys) 交互,导航或弹窗后重新采集控件;5)用 texts(id, name) 读取并与期望值比较,优先用 qa_wait_for_text_contains(id, name, expected, timeout_s=10) 代替简单等待,每个主要检查点后截图;6)填写 assets/test-case.md 模板,给出编号执行日志与最终 PASS/FAIL,附截图 base64。

限制与异常处理:找不到窗口时确认 SUT 正在运行并再次刷新;控件树为空可等待 2-3 秒后重采,仍为空则尝试 CONTROL_BACKEND=win32;控件不可点击时重新采集控件,若控件无可用 id 才退回坐标操作并说明原因;找不到 MCP 工具时参考 references/setup.md 并运行 doctor.ps1。详细工作流见 references/qa-workflows.md,安装与配置见 references/setup.md。