用途：通过 AT-SPI 无障碍接口与 Qt/PySide 桌面应用交互，适合 UI 测试、按钮点击、控件检查、截图和读取控件内容。命令在宿主机或虚拟机中用法一致，无需 SSH 包装。
主要能力：tree 查看控件树；find 按角色和名称定位控件；text 读取文本；state 获取完整控件信息；screenshot 截图；apps 和 wait 管理应用；snapshot save/diff 保存和比较控件树基线。click 点击控件，type 输入文本，key 发送按键，focus 设置焦点，fill 一步完成聚焦、清空并输入，do 可点击后验证。
使用方式：遵循三阶段。先检查，如 tree、find、state；再操作，如 click、fill、key、do；最后验证，读取目标控件、相关控件，必要时截图或对比快照。控件定位支持 --visible、--exact、--index、--app 等参数，角色字符串需精确匹配，例如 push button、text、label。
限制：AT-SPI 的 editable_text.insert_text() 不适用于 Qt，需用 xdotool 的 type。type 前必须先聚焦目标控件，否则文本会进入错误位置。多控件匹配时需用 --exact 或 --index。交互后控件树会变化，不应依赖过期输出。部分命令可能受弹窗、禁用状态或滚动区域影响。
分类：测试与质量。