坐标记录格式规范

AIWORK运维组

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

二、为什么这一步容易被忽略
逻辑坐标与物理坐标之间要写明换算条件，尤其是缩放、旋转与副屏场景，缺了条件，换算结果就没有可比性。基准点阵的价值在于给后续所有校准提供共同参照，点阵位置固定下来后，任何一次改动都能在同一组点上验证。坐标系先定原点与轴向，再谈具体数值。同一台设备在不同系统或不同显示设置下，原点位置可能不同，直接搬用旧坐标必然出错。这些问题在固定环境里几乎不出现，一旦换分辨率、加显示器、改缩放或调整窗口，偏差就会集中爆发，表现为「昨天还好好的」。把判断依据提前写成清单，比事后逐个试坐标省力得多。

三、执行前的基线
动手之前固定三项：环境快照、样本范围、判定口径。环境快照写清分辨率、缩放、屏幕排列与系统版本；样本范围写明覆盖哪些基准点、多少种窗口状态；判定口径写明以什么误差范围判断通过。三项确定后再开始，中途只改一个变量，改完立即用同一组基准点复测。逻辑坐标与物理坐标之间要写明换算条件，尤其是缩放、旋转与副屏场景，缺了条件，换算结果就没有可比性。这样即使结果不理想，也能明确知道是哪一处引入的变化，而不是把所有改动混在一起猜。



四、实操要点
要点一：坐标取整规则统一，避免四舍五入方式不一致。要点二：基准点阵固定下来，后续校准都用它做参照。要点三：映射表带版本号，坐标系变更时同步通知使用者。三条按顺序落地，每完成一条补一次记录，包含执行时间、执行人、观察结果与是否通过。记录不是留档好看，而是让后续复核能直接找到当时的判断依据。某条无法执行时注明原因并暂停后续步骤，不要带着未确认的前提继续往下走。

五、记录模板与留痕
坐标映射表按版本维护，坐标系一变就升版本并通知使用者，旧表归档不删除，方便回退排查。坐标记录固定为四列：点编号、预期值、实测值、环境快照编号。环境快照指向当天的显示设置，复核时能还原现场。模板建议固定成一张表：日期、环境快照、样本编号、预期、实际、结论、责任人七列。结论只允许写「通过」「未通过」「待观察」三种，避免模糊表述。所有原始数据保留一个完整复核周期，到期归档而不是删除，因为跨周期对比常需要回看更早的基线。

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

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