update screen coordinates

Signed-off-by: 82Flex <82flex@gmail.com>

Author: Lessica

docs/lua-manual/appendix/img/bezel-ipad-default.svg

@@ -14,8 +14,32 @@ XXTouch Elite always uses physical pixels as units, with the hardware resolutio
 - [iOS Design Cheat Sheet](https://kapeli.com/cheat_sheets/iOS_Design.docset/Contents/Resources/Documents/index)
 - [The Ultimate Guide To iPhone Resolutions](https://www.paintcodeapp.com/news/ultimate-guide-to-iphone-resolutions)
 
-:::tip
-In your script, you can change the screen coordinate system using the [`screen.init`](../screen.md#initialize-rotated-coordinate-system-screeninit) function.
+## Device default orientation and affected modules
+
+This chapter uses the hardware coordinate system (physical pixels). In addition, XXTouch Elite defines device-specific default orientations that affect how coordinates are interpreted by common features.
+
+### Default orientations
+
+For historical reasons, any mention in this manual of “HOME button at the bottom” should be read as the device’s default orientation; likewise, mentions of the HOME button being left/right/top correspond to the respective orientation conventions.
+
+iPhone: Portrait (upright). This is the default orientation for screenshots, simulated taps, record-and-replay, and Script UI.
+
+![Bezel_iPhone](./img/bezel-iphone-default.svg)
+
+iPad: Facing the screen, the default orientation is with the charging port on the right side (Landscape Right).
+
+![Bezel_iPad](./img/bezel-ipad-default.svg)
+
+### What this impacts
+
+- Screen-related operations: capturing screenshots, cropping regions, color sampling, and image recognition all interpret X/Y in the default orientation unless you change it.
+- Touch interactions: coordinates for tapping, swiping, and other gestures; recorded tracks are played back under the default orientation.
+- Record and replay: gesture paths are stored in hardware coordinates and assumed to run under the default orientation unless reconfigured.
+- Script UI and overlays: any absolute screen positions used by UI/overlay components follow the same orientation rules.
+- Image/template reuse: templates/screenshots created under one orientation should be used under the same orientation, or you should rotate/normalize via `screen.init`.
+
+### Changing the coordinate system in scripts
+
+When needed, use [`screen.init`](../screen.md#initialize-rotated-coordinate-system-screeninit) to rotate the working coordinate system for your script, while XXTouch Elite still operates on hardware pixels underneath. It’s good practice to explicitly set your intended orientation at the start of a script.
 
 ![Screen_Coordinates.002](./img/Screen_Coordinates.002.png)
-:::

docs/lua-manual/appendix/img/bezel-iphone-default.svg

@@ -14,8 +14,32 @@ XXTouch Elite 始终以物理像素为单位，使用硬件分辨率坐标系
 - [iOS Design Cheat Sheet](https://kapeli.com/cheat_sheets/iOS_Design.docset/Contents/Resources/Documents/index)
 - [The Ultimate Guide To iPhone Resolutions](https://www.paintcodeapp.com/news/ultimate-guide-to-iphone-resolutions)
 
-:::tip
-在脚本当中，你可以使用 [`screen.init`](../screen.md#初始化旋转坐标系-screeninit) 改变屏幕坐标系。
+## 设备默认方向与受影响的模块
+
+本章所述均基于硬件分辨率坐标系（物理像素）。此外，XXTouch Elite 针对不同设备规定了默认方向，影响常见功能对坐标的解释方式。
+
+### 默认方向
+
+出于历史原因，本文档中出现的 “HOME 键在下” 等说法，均可理解为对应设备的默认方向；同理，“HOME 键在左/右/上” 等描述也分别指代与之对应的方向约定。
+
+iPhone：竖直向上（Portrait）。该默认方向适用于屏幕截取、模拟点击、录制回放和脚本 UI 等操作。
+
+![Bezel_iPhone](./img/bezel-iphone-default.svg)
+
+iPad：正对屏幕，充电接口位于右侧（横屏向右）为默认方向。
+
+![Bezel_iPad](./img/bezel-ipad-default.svg)
+
+### 影响范围
+
+- 屏幕相关操作：截图、区域裁剪、取色与图像识别等，若未显式修改，将按默认方向解析坐标。
+- 触控交互：点击、滑动等手势坐标；录制的轨迹会在默认方向下回放。
+- 录制与回放：手势路径以硬件坐标存储，除非重新配置，否则按默认方向执行。
+- 脚本 UI 与覆盖层：使用绝对屏幕坐标的 UI/Overlay 组件遵循相同的方向规则。
+- 图像/模板复用：在某一方向下制作的模板/截图，应在相同方向下使用；或通过 `screen.init` 进行旋转/归一化。
+
+### 在脚本中切换坐标系
+
+如需调整，请使用 [`screen.init`](../screen.md#初始化旋转坐标系-screeninit) 在脚本中显式设定工作坐标系。底层仍以硬件像素运作。建议在脚本开头明确设置预期方向。
 
 ![Screen_Coordinates.002](./img/Screen_Coordinates.002.png)
-:::