@bettergi/utils 0.1.4 → 0.1.6

package/README.md

@@ -35,6 +35,11 @@ await setTimeTo(12, 35);
 
 // 调整游戏时间段
 await setTime("evening");
+
+// tab 翻页到指定页面
+await navigateToTab(() => {
+  return findTextWithinBounds("小道具", 0, 0, 220, 96) !== undefined;
+});
 ```
 
 ### 图文识别

package/dist/game.d.ts

@@ -53,4 +53,29 @@ export declare const setTimeTo: (hour: number, minute: number, options?: ClockOp
  * @param options 时钟参数
  */
 export declare const setTime: (period: "night" | "morning" | "noon" | "evening", options?: ClockOptions) => Promise<void>;
+/** tab 翻页配置 */
+type TabNavigationOptions = {
+    /** 标签页图标宽度（默认：96） */
+    tabIconWidth?: number;
+    /** 翻页按钮垂直偏移（默认：540） */
+    verticalOffset?: number;
+    /** 翻页按钮左侧内边距（默认：72） */
+    paddingLeft?: number;
+    /** 翻页按钮右侧内边距（默认：72） */
+    paddingRight?: number;
+    /** 是否向前翻页（默认：false） */
+    backwards?: boolean;
+    /** 最大尝试次数（默认：屏幕宽度 / 标签页图标宽度） */
+    maxAttempts?: number;
+    /** 每次尝试间隔时间（毫秒，默认：1000） */
+    retryInterval?: number;
+};
+/**
+ * 导航到指定标签页
+ * @param condition 导航成功的条件
+ * @param options 翻页配置
+ * @returns - true  条件满足
+ *          - false 达到最大重试次数
+ */
+export declare const navigateToTab: (condition: () => boolean, options?: TabNavigationOptions) => Promise<boolean>;
 export {};

package/dist/game.js

@@ -10,13 +10,13 @@ import { findTextInDirection, findTextWithinBounds, findTextWithinListView } fro
  * @param action 执行动作
  */
 export const withGameMetrics = async (w, h, dpi, action) => {
-    const { width, height, screenDpiScale } = genshin;
+    const [_w, _h, _dpi] = globalThis["getGameMetrics"] ? getGameMetrics() : [];
     try {
         setGameMetrics(w, h, dpi);
         return await action();
     }
     finally {
-        setGameMetrics(width, height, screenDpiScale);
+        globalThis["getGameMetrics"] && setGameMetrics(_w, _h, _dpi);
     }
 };
 /**
@@ -39,13 +39,13 @@ export const openMenu = async (name, stepBackwards = false, options = {}) => {
     await openPaimonMenu();
     // 2.步进搜索菜单按钮
     const { navWidth = 95, steps: step = 30 } = options;
-    const findTooltip = () => findTextWithinBounds(name, navWidth, 0, 20 + name.length * 20, genshin.height);
+    const findTooltip = () => findTextWithinBounds(name, navWidth, 0, 20 + name.length * 20, 1080);
     const tooltip = await withGameMetrics(1920, 1080, 1.5, async () => {
         let result = undefined;
-        const steps = Math.ceil(genshin.height / step);
+        const steps = Math.ceil(1080 / step);
         for (let i = 0; i < steps; i++) {
             const o = i * step;
-            const y = stepBackwards ? genshin.height - o : o;
+            const y = stepBackwards ? 1080 - o : o;
             moveMouseTo(Math.round(navWidth / 2), y);
             await sleep(30); // 等待提示文字出现
             if ((result = findTooltip()) !== undefined)
@@ -92,13 +92,14 @@ export const setTimeTo = async (hour, minute, options) => {
     // 1.打开时间页面
     await openMenu("时间", true);
     // 2.计算调整时钟的路径点
-    const { centerX = 1440, centerY = 502, offsetHours = 6, radius = 154, smooth = 3 } = options || {};
+    const { centerX = 1440, centerY = 502, offsetHours = 6, radius = 150, smooth = 4 } = options || {};
     const radian = ((((hour + offsetHours) * 60 + minute) % 1440) / 1440) * Math.PI * 2;
+    const trackRadius = radius + 150; // 增加拨动半径，提高准确度
     const waypoints = [{ x: centerX, y: centerY }].concat(Array.from({ length: Math.max(smooth, 3) })
         // 计算弧度
         .map((_, i) => radian + (1 + i / (Math.max(smooth, 3) - 1)) * Math.PI)
         // 计算相对圆点坐标
-        .map(rad => ({ x: radius * Math.cos(rad), y: radius * Math.sin(rad) }))
+        .map(rad => ({ x: trackRadius * Math.cos(rad), y: trackRadius * Math.sin(rad) }))
         // 计算绝对坐标
         .map(p => ({ x: Math.round(p.x + centerX), y: Math.round(p.y + centerY) })));
     // 3.调整时间
@@ -130,3 +131,23 @@ export const setTime = async (period, options) => {
             return setTimeTo(18, 5, options);
     }
 };
+/**
+ * 导航到指定标签页
+ * @param condition 导航成功的条件
+ * @param options 翻页配置
+ * @returns - true  条件满足
+ *          - false 达到最大重试次数
+ */
+export const navigateToTab = async (condition, options) => {
+    const { tabIconWidth = 96, verticalOffset = 540, paddingLeft = 72, paddingRight = 72, backwards = false, retryInterval = 1000 } = options || {};
+    const attempts = Math.floor(options?.maxAttempts ?? 1920 / tabIconWidth);
+    for (let i = 0; i < attempts; i++) {
+        if (i === 0 && condition())
+            return true; // fast path
+        click(backwards ? paddingLeft : 1920 - paddingRight, verticalOffset); // prev or next
+        await sleep(retryInterval);
+        if (condition())
+            return true;
+    }
+    return false;
+};

package/dist/ocr.js

@@ -13,7 +13,13 @@ const directionToBounds = (direction) => {
     const y = direction.includes("south") ? genshin.height / 2 : 0;
     const w = direction === "north" || direction === "south" ? genshin.width : genshin.width / 2;
     const h = direction === "west" || direction === "east" ? genshin.height : genshin.height / 2;
-    return { x, y, w, h };
+    const scale = genshin.width / 1920;
+    if (scale <= 1) {
+        return { x, y, w, h };
+    }
+    else {
+        return { x: x / scale, y: y / scale, w: w / scale, h: h / scale };
+    }
 };
 /**
  * 在整个画面内搜索图片
@@ -21,13 +27,16 @@ const directionToBounds = (direction) => {
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
 export const findImage = (path) => {
+    const ir = captureGameRegion();
     try {
-        const ir = captureGameRegion();
         const ro = RecognitionObject.templateMatch(file.readImageMatSync(path));
         return findFirst(ir, ro, region => region.isExist());
     }
     catch (err) {
-        err?.message && log.warn(`${err.message}`);
+        log.warn(`${err.message || err}`);
+    }
+    finally {
+        ir.dispose();
     }
 };
 /**
@@ -40,13 +49,16 @@ export const findImage = (path) => {
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
 export const findImageWithinBounds = (path, x, y, w, h) => {
+    const ir = captureGameRegion();
     try {
-        const ir = captureGameRegion();
         const ro = RecognitionObject.templateMatch(file.readImageMatSync(path), x, y, w, h);
         return findFirst(ir, ro, region => region.isExist());
     }
     catch (err) {
-        err?.message && log.warn(`${err.message}`);
+        log.warn(`${err.message || err}`);
+    }
+    finally {
+        ir.dispose();
     }
 };
 /**
@@ -69,12 +81,20 @@ export const findText = (text, options) => {
     const { ignoreCase = true, contains = false } = options || {};
     const searchText = ignoreCase ? text.toLowerCase() : text;
     const ir = captureGameRegion();
-    const ro = RecognitionObject.ocrThis;
-    return findFirst(ir, ro, region => {
-        const itemText = ignoreCase ? region.text.toLowerCase() : region.text;
-        const isMatch = contains ? itemText.includes(searchText) : itemText === searchText;
-        return isMatch && region.isExist();
-    });
+    try {
+        const ro = RecognitionObject.ocrThis;
+        return findFirst(ir, ro, region => {
+            const itemText = ignoreCase ? region.text.toLowerCase() : region.text;
+            const isMatch = contains ? itemText.includes(searchText) : itemText === searchText;
+            return isMatch && region.isExist();
+        });
+    }
+    catch (err) {
+        log.warn(`${err.message || err}`);
+    }
+    finally {
+        ir.dispose();
+    }
 };
 /**
  * 在指定区域内搜索文本
@@ -90,12 +110,20 @@ export const findTextWithinBounds = (text, x, y, w, h, options) => {
     const { ignoreCase = true, contains = false } = options || {};
     const searchText = ignoreCase ? text.toLowerCase() : text;
     const ir = captureGameRegion();
-    const ro = RecognitionObject.ocr(x, y, w, h);
-    return findFirst(ir, ro, region => {
-        const itemText = ignoreCase ? region.text.toLowerCase() : region.text;
-        const isMatch = contains ? itemText.includes(searchText) : itemText === searchText;
-        return isMatch && region.isExist();
-    });
+    try {
+        const ro = RecognitionObject.ocr(x, y, w, h);
+        return findFirst(ir, ro, region => {
+            const itemText = ignoreCase ? region.text.toLowerCase() : region.text;
+            const isMatch = contains ? itemText.includes(searchText) : itemText === searchText;
+            return isMatch && region.isExist();
+        });
+    }
+    catch (err) {
+        log.warn(`${err.message || err}`);
+    }
+    finally {
+        ir.dispose();
+    }
 };
 /**
  * 在指定方向上搜索文本

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/utils",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "开发 BetterGI 脚本常用工具集",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",
@@ -30,10 +30,11 @@
   ],
   "scripts": {
     "dev": "tsc --watch",
-    "build": "tsc"
+    "build": "rimraf dist && tsc"
   },
   "devDependencies": {
-    "@bettergi/types": "^0.1.1",
+    "@bettergi/types": "^0.1.3",
+    "rimraf": "^6.0.1",
     "typescript": "^5.9.3"
   }
 }