坐标策略与分辨率适配

坐标策略决定了"当运行环境和制作环境不一样时，坐标怎么换算"。MacroAI 提供两种策略：

• 等比缩放（uniform） — 画面整体放大/缩小。坐标按比例缩放，模板图片也按比例缩放。
  适用：游戏、全屏应用。这类程序在不同分辨率下会把整个画面等比拉伸。
• 平移适配（desktop） — 画面不缩放，只是位置偏移了。坐标只做平移，模板不缩放。
  适用：浏览器、Office、文件管理器。这类程序窗口变大时内容不会放大，只是看到更多。

简单判断法：如果你的目标程序在不同分辨率下"画面看起来一样大，只是位置变了"→ 用平移适配；如果"画面整体变大/变小了"→ 用等比缩放。

在项目设置（Ctrl+,）→ 区域设置中切换。

这是最常见的问题，通常是运行区域没有校准导致的。解决步骤：

1. 切换到运行模式（工具栏 → 🏃 运行）
2. 找到区域校准区域，点击"校准"按钮
3. 在弹出的全屏覆盖层中，框选目标程序的实际显示区域
   • 等比缩放模式：自由框选，保持和设计区域相同的宽高比
   • 平移适配模式：只能移动位置，宽高固定不变
4. 确认后重新运行脚本

如果校准后仍然偏移：

• 检查坐标策略是否选对（游戏用等比缩放，桌面程序用平移适配）
• 如果只是个别图像找不到，可能是图像质量问题，尝试重新截取模板图片
• Android 用户检查游戏是否有黑边（有黑边时需要框选黑边内的实际画面区域）

MacroAI 有两个区域概念：

• 设计区域 — 你制作脚本时的屏幕区域（创建项目时设定，一般不改）
• 运行区域 — 脚本实际运行时目标程序所在的屏幕区域

如果你在同一台电脑、同一个窗口位置运行，两者相同，不需要校准。

需要校准的情况：

• 换了一台分辨率不同的电脑/手机
• 目标窗口的位置或大小变了（如从左边移到了右边）
• Windows 的 DPI 缩放比例变了（如从 100% 改为 125%）

校准只需做一次，结果会保存在项目中。下次打开同一项目无需重新校准（除非环境又变了）。

安卓手机宽高比非常碎片化（16:9、19.5:9、20:9...），游戏在不同设备上通常有三种表现：

• 有黑边（内容居中，上下或左右留黑）→ 校准时框选黑边内部的实际画面区域，使用等比缩放模式
• 画面等比放大（内容变大，没有黑边）→ 直接全屏，使用等比缩放模式
• 视口扩大（内容不变大，看到更多背景）→ 使用平移适配模式，通常 UI 按钮位置不变

实操建议：

1. 先确认游戏在你手机上的显示方式（有没有黑边）
2. 有黑边 → 运行设置中校准区域，只框选画面部分
3. 没黑边 → 默认全屏即可，一般不需要校准

MacroAI 已内置 DPI 校正，DPI 已纳入坐标缩放体系，正常情况下不需要你操心。

图像查找找不到通常和 DPI 无关，更可能是图像质量问题。如果个别图像找不到，建议重新截取模板图片。

多显示器注意：如果两个显示器 DPI 缩放不同（如主屏 125%、副屏 100%），建议目标窗口不要跨屏移动。

因为等比缩放的核心假设是：画面在 X 和 Y 方向按相同比例缩放（scale_x = scale_y）。

如果设计区域是 1920×1080（16:9），而你校准时框了一个 1920×1200（16:10）的区域，那 X 方向缩放 1.0 倍、Y 方向缩放 1.11 倍——画面被非等比拉伸了，坐标换算就会出错。

所以 MacroAI 在校准时会锁定宽高比，你只能调整区域大小和位置，不能改变比例。这是为了保护坐标换算的准确性。

如果你的目标程序确实是非等比拉伸的（极少见），建议改用平移适配模式，或者重新以实际比例创建设计区域。

需要切换的信号：

• 用等比缩放模式，但脚本在另一台电脑上"整体偏移"而不是"整体偏大/偏小"→ 应该用平移适配
• 用平移适配模式，但脚本在另一台电脑上"点击位置比例性偏移"→ 应该用等比缩放

切换后的影响：

• 所有已有坐标点的解释方式会改变（同样的数字，缩放和平移算出的实际位置不同）
• 切换时会弹出警告提示
• 可能需要重新校准运行区域
• 已截取的模板图片不受影响（图片本身不变）

建议：创建项目时就选对策略。如果不确定，游戏/全屏选等比缩放，窗口程序选平移适配。切换后最好完整测试一遍流程。

默认情况下，所有节点跟随项目的全局坐标策略。但个别节点可以单独设置不同的策略，这就是"坐标策略覆盖"（transform_policy）。

使用场景举例：

• 项目整体是等比缩放（游戏），但某个节点要点击的是系统任务栏上的按钮（不随游戏缩放）→ 该节点单独设为平移适配
• 项目整体是平移适配（浏览器），但某个图像查找的目标是视频画面（会缩放）→ 该节点单独设为等比缩放

在节点配置对话框中找到"坐标策略"下拉框，选择"等比缩放"或"平移适配"即可覆盖。选"跟随项目"则使用全局设置。

注意：这是 Pro 功能。大多数情况下不需要用到，只有"同一个项目中混合了缩放和不缩放的内容"时才需要。