SuperAPI AI 工具集

qt-runtime-eval

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:通过桥接在正在运行的 Qt/PySide 应用内执行 Python 代码,获取 AT-SPI 无法提供的信息,例如内部控件属性(QComboBox.currentData()、QCheckBox.isChecked()、自定义属性)、直接调用 Qt 方法(触发槽、切换可见性、调整大小、repaint())、运行多步逻辑(遍历模型行、一次收集多个控件数据、对内部状态断言)、读取模型数据(行数、单元格值、选中状态)以及样式表、字体度量、调色板颜色、Q_PROPERTY 等。普通控件点击、输入和树检查应使用 qt-app-interaction。

使用方式:桥接需启用,两种设置方法。应用内安装(任意 Python 版本):在 QApplication 创建后于应用代码中加入 from qt_ai_dev_tools.bridge import start,再调用 start(),并设置环境变量 export QT_AI_DEV_TOOLS_BRIDGE=1 才会生效。自动注入(仅 Python 3.14+):无需改代码,执行 qt-ai-dev-tools bridge inject --pid <PID>,依赖 sys.remote_exec。执行代码使用 qt-ai-dev-tools eval "expression",语句用 print() 输出并被捕获;支持 --json、--file script.py、--file - 从 stdin、--pid 指定应用、--timeout 设置超时(默认 30 秒)。桥接管理可用 bridge status(--json)和 bridge inject。

预置命名空间:app、widgets(按 objectName 索引的字典)、find(type, name)、findall(type)、_(上次表达式结果)以及常用 Qt 控件类与 Qt 常量,无需导入。

限制:模态对话框会阻塞桥接(QFileDialog、QMessageBox 等打开时事件循环被阻塞),此时请用 AT-SPI 和 xdotool 处理;语句返回 None,需用 print() 输出;桥接必须处于活动状态;注入方式要求 Python 3.14+。常见问题包括找不到桥接套接字、连接被拒或管道断开、NameError、AttributeError 等。