SuperAPI AI 工具集

qt-form-and-input

通用与其它

查看项目

更新于 10-16 04:55

技能介绍

用途:面向 Qt/PySide 应用的自动化技能,处理多字段表单填写、文件打开/保存对话框(QFileDialog)、剪贴板读写、下拉框选择以及模态对话框的检测与关闭。单一控件交互(单击、输入、读标签)应使用 qt-app-interaction,本技能在其基础上提供多步骤配方。命令在主机与 VM 中一致,无需 SSH 包装,仅任意命令用 vm run。

主要能力与用法: 表单填写:fill 为复合动作,聚焦控件、清空原文本再输入,如 qt-ai-dev-tools fill "value" --role "text" --name "Field",支持 --role、--name、--app、--no-clear、--visible/--no-visible、--exact、--index。多字段流程为先 find --role "text" --json 检查,再逐字段 fill,click 提交,最后 text 与 screenshot 验证;字段无唯一名称时用 --index 按位置或 Tab 键导航。 文件对话框:QFileDialog 为模态并阻塞主窗口,桥接无法响应,须用 AT-SPI 命令:file-dialog detect [--app] [--json]、file-dialog fill <path>、file-dialog accept、file-dialog cancel。典型流程为触发对话框、detect、fill 路径、accept,再 text/tree 验证。 剪贴板:clipboard read 读取,clipboard write "text" 写入,VM 内优先 xsel、回退 xclip。复制配方为在应用内选中文本、ctrl+a、ctrl+c 再 read;粘贴为 write 后点击输入框、ctrl+v。 下拉框:点击 combo box 后菜单项才出现在 AT-SPI 树中,需重新 inspect(tree --role "menu item")再点击;键盘方式(Down/Return)通常更可靠。 对话框:模态对话框在树中显示为 [dialog] 或 [alert],用 find --role "push button" 定位按钮后 click,或按 Escape 快速关闭。

限制:模态对话框打开期间桥接 eval 无法响应,须改用 AT-SPI 命令;下拉项未刷新树时不可见;剪贴板读取为空多因 VM 未装 xsel/xclip;fill 落入错误字段时需加 --name 或 --index;非标准文本控件可能无法自动清空,可用 --no-clear 并先手动全选删除。相关技能包括 qt-app-interaction、qt-runtime-eval、qt-desktop-integration、qt-dev-tools-setup。