feat: position

api/src/index.ts

@@ -379,6 +379,17 @@ export interface RawRuleProps extends RawCommonProps {
     | 'longClickNode'
     | 'longClickCenter';
 
+  /**
+   * 在使用 clickCenter/longClickCenter 时的自定义点击位置
+   *
+   * 默认坐标为节点中心
+   *
+   * 如果计算出的坐标不在屏幕内部, 当作未匹配
+   *
+   * @version 1.7.0
+   */
+  position?: Position;
+
   /**
    * 一个或者多个合法的 GKD 选择器, 如果每个选择器都能匹配上节点, 那么点击最后一个选择器的目标节点
    */
@@ -519,6 +530,70 @@ export interface RawGlobalRuleProps {
   apps?: RawGlobalApp[];
 }
 
+/**
+ * 位置类型, 用以描述自定义点击位置
+ *
+ * 使用 left/top/right/bottom 实现定位, 此对象只能有两个属性
+ *
+ * 合法的定位组合为: left-top, left-bottom, right-top, right-bottom
+ *
+ * @example
+ * // 点击目标节点的中心
+ * {
+ *  left: 'width/2',
+ *  top: 'height/2',
+ * }
+ *
+ * // 点击目标节点的左上顶点
+ * {
+ *  left: 0,
+ *  top: 0,
+ * }
+ *
+ * // 点击目标节点的右上区域
+ * // https://i.gkd.li/import/14112390
+ * // https://i.gkd.li/import/14319672
+ * // https://github.com/gkd-kit/gkd/assets/38517192/2cac0614-5eba-48a1-9149-4e564cb79945
+ * {
+ *  right: 'width*0.1352',
+ *  top: 'width*0.0852',
+ * }
+ *
+ */
+export type Position = {
+  /**
+   * 距离目标节点左边的距离
+   *
+   * 方向: 边 -> 节点中心, 负数表示反方向(也可点击节点外部区域)
+   *
+   * 支持两种值类型, 字符串和数字, 数字等价于相同内容的字符串, 如 2.5 等价于 '2.5'
+   *
+   * 字符串类型支持来自快照属性面板上的 left/top/right/bottom/width/height 的数学表达式运算
+   *
+   * @example
+   * 2.5 // ✅
+   * '2.5' // ✅
+   * '2.5 + 1 - 2 * 3 / 4 ^ 5 % 6' // ✅
+   * '(right + left) / 2' // ✅
+   */
+  left?: string | number;
+
+  /**
+   * 距离目标节点上边的距离
+   */
+  top?: string | number;
+
+  /**
+   * 距离目标节点右边的距离
+   */
+  right?: string | number;
+
+  /**
+   * 距离目标节点下边的距离
+   */
+  bottom?: string | number;
+};
+
 /**
  * 一个或者多个值类型
  * @example