控件相对定位规范

AIWORK运维组

一、控件相对定位规范：先把范围说清楚
HID 设备把键盘、鼠标与触控信号以硬件级真实输入送进目标系统之后，一个动作是否有效，最终取决于它落在屏幕的哪个位置。「控件相对定位规范」属于 区域锚点 这条线索里的具体环节，不讨论设备选购、连接方式或文本内容，只处理屏幕空间与指针几何这一段。很多看似随机的点击失效，排查下来其实是坐标系、缩放比例、屏幕排列或锚点参照物发生了变化。本页只提供可复用的方法与记录模板，如果你还在确定设备形态，请先到 HID 极光中心 看产品资料，再回来按本文整理坐标链路。

二、为什么这一步容易被忽略
动态控件不能只靠一次采点，需要记录识别条件与失效判定，条件不满足时主动停止而不是继续猜位置。相对锚点跟随窗口或控件位置，界面小幅调整时比绝对坐标稳，但要先确认参照物本身是稳定的。锚点命名按「页面 + 控件 + 用途」组合，避免同一页面出现多个含义相近的名称。这些问题在固定环境里几乎不出现，一旦换分辨率、加显示器、改缩放或调整窗口，偏差就会集中爆发，表现为「昨天还好好的」。把判断依据提前写成清单，比事后逐个试坐标省力得多。

三、执行前的基线
动手之前固定三项：环境快照、样本范围、判定口径。环境快照写清分辨率、缩放、屏幕排列与系统版本；样本范围写明覆盖哪些基准点、多少种窗口状态；判定口径写明以什么误差范围判断通过。三项确定后再开始，中途只改一个变量，改完立即用同一组基准点复测。动态控件不能只靠一次采点，需要记录识别条件与失效判定，条件不满足时主动停止而不是继续猜位置。这样即使结果不理想，也能明确知道是哪一处引入的变化，而不是把所有改动混在一起猜。



四、实操要点
要点一：动态控件写明识别条件与失效判定。要点二：锚点命名统一格式，避免同义不同名。要点三：相对偏移与生效版本一起入表。三条按顺序落地，每完成一条补一次记录，包含执行时间、执行人、观察结果与是否通过。记录不是留档好看，而是让后续复核能直接找到当时的判断依据。某条无法执行时注明原因并暂停后续步骤，不要带着未确认的前提继续往下走。

五、记录模板与留痕
锚点库按版本维护，每条记录包含参照物、相对偏移、生效版本与失效条件四项。锚点变更通知写清影响范围与生效日期，使用方按版本号对齐，避免新旧锚点混用。模板建议固定成一张表：日期、环境快照、样本编号、预期、实际、结论、责任人七列。结论只允许写「通过」「未通过」「待观察」三种，避免模糊表述。所有原始数据保留一个完整复核周期，到期归档而不是删除，因为跨周期对比常需要回看更早的基线。

六、与站内其它栏目配合
坐标链路解决「动作落在哪里」，验证与文本链路解决「结果可不可信、内容对不对」。若需要给坐标流程建立验收标准、指标口径与复盘记录，HIDf中心 提供了完整的方法与检查表；涉及界面里的文字、字段与编码，HIDk中心 的整理方式可以直接借用。三条线互补：位置准、内容对、结论可追溯，缺任何一层，长期运行都容易变成靠感觉维护。

七、小结
「控件相对定位规范」的落点是一句很朴素的话：先固定环境与基准点，再用同一组样本证明位置一致。把基线、清单、留痕三件事做成固定动作，改动前后一对比，好坏自然清楚。本文给的是方法与模板，不承诺任何特定平台的效果，读者可按自己的环境裁剪字段。更多资料见 HID 极光中心，场景侧的方法见 HIDf中心。