SuperAPI AI 工具集

linux-at-spi2

通用与其它

查看项目

更新于 10-16 00:07

技能介绍

用途:该技能面向 Linux 桌面自动化,基于 AT-SPI2(辅助技术服务提供者接口)通过无障碍对象树与 D-Bus 会话总线操作 GTK/Qt 应用,属于高风险能力(系统级无障碍访问、D-Bus IPC、输入注入)。

主要能力:访问 AtspiAccessible 对象、角色、状态与接口;通过 D-Bus 对象路径与方法调用与 AT-SPI2 Registry 通信;监听 AT-SPI2 事件并注册回调;使用 pyatspi2、gi.repository.Atspi、dbus-python 等库实现自动化。

安全与用法要点:交互前校验目标应用身份,维护被阻止应用列表(如密码管理器、终端、密钥管理、认证对话框);阻止 PASSWORD_TEXT 角色与含 password/secret/token 的字段;采用 read-only、standard、elevated 权限分级;对所有 D-Bus 调用强制超时;记录审计日志与关联 ID;限制事件订阅范围、缓存节点、限定搜索范围以降低 D-Bus 流量。

实现流程:按 TDD 先写失败测试,再实现最小安全校验,随后重构加入缓存、异步与连接池,最后运行 pytest 验证,例如 pytest tests/ -v --cov=automation --cov-report=term-missing。

适用场景:需要无障碍方式自动化 Linux 桌面 GTK/Qt 应用、读取界面元素状态或执行受控操作的场景。

限制:资料未提供具体安装命令、版本要求、收费与平台支持范围;实际使用需自行确认 AT-SPI2 环境与权限模型。