技能介绍

解决麒麟系统 GUI 自动化的协议与缩放痛点

在银河麒麟系统上实现图形界面自动化时，开发者常面临底层显示协议分裂与 HiDPI 缩放带来的坐标偏移问题。V11 默认采用 Wayland 协议，而 V10SP1 仍停留在 X11，两者在窗口控制和输入注入上存在根本差异。此外，高分屏缩放和多显示器环境进一步加剧了坐标计算的复杂性，导致传统的绝对坐标点击经常失效。

核心机制与执行流程

该技能通过一套标准化的流程屏蔽底层差异。首先执行 OS 探测，自动将任务路由至 wlcctrl（V11/Wayland）或 xdotool（V10SP1/X11）后端。在坐标处理上，技能严格区分逻辑坐标与物理像素：

V11 (wlcctrl)：鼠标移动需乘以输出缩放因子 S，但窗口移动 --windowmove 则直接使用逻辑坐标。
V10SP1 (xdotool)：所有坐标均为纯屏幕像素，不涉及缩放因子。

在交互策略上，技能遵循一系列工程化准则：优先使用键盘快捷键而非鼠标点击；在窗口当前位置截图并基于图像识别目标点；控制滑块时使用小幅度拖拽代替滚轮以防止数值跳跃；缓存窗口几何信息以避免重复探测带来的性能损耗。

适用边界与避坑指南

使用该技能时需特别注意 wlcctrl 的文档陷阱：其 man page 错误地将 --mousemove 和 --windowmove 描述为相对位移，实际两者均为绝对坐标。在多显示器场景下，若窗口几何信息是相对于某个输出设备的，必须先将该输出的位置偏移量加到目标坐标上。

此外，V11 环境下的 CapsLock 等锁定键状态切换不可靠，需改用 ydotool。V10SP1 环境不支持分数缩放，且截图功能依赖 ImageMagick 的 import 命令。如需了解更多快捷键别名、多步测试模式及 X11 特定注意事项，建议深入阅读 references/details.md。