@bettergi/utils 0.1.1 → 0.1.3

package/README.md

@@ -149,3 +149,33 @@ const body2 = await postForBody("https://example.com/", undefined, { "User-Agent
 log.info(`GET 请求响应体内容${body1}`);
 log.info(`POST 请求响应体内容${body2}`);
 ```
+
+### 文件操作
+
+```ts
+// 列出指定文件夹内所有文件路径
+const files = listFiles("assets");
+
+// 读取文件文本行（非空白、去除首尾空白、去重）
+const lines = readLinesSync("assets/data.txt", { notBlank: true, trim: true, distinct: true });
+```
+
+### 日期时间
+
+```ts
+// 获取下一个（含当日）凌晨4点的时间
+const d1 = getNextDay4AM();
+// 获取下一个（含当日）周一凌晨4点的时间
+const d2 = getNextMonday4AM();
+```
+
+### 杂项
+
+```ts
+// 生成UUID（不带连字符）
+const uuid = generateUUID(false);
+
+// 数组洗牌
+const arr = [1, 2, 3, 4, 5];
+const shuffled = shuffleArray(arr);
+```

package/dist/file.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 读取指定文件夹内所有文件的路径
+ * @param folderPath 文件夹路径（相对于脚本根目录）
+ * @param recursive 是否递归子文件夹（默认：false）
+ * @returns 文件路径数组
+ */
+export declare const listFiles: (folderPath: string, recursive?: boolean) => string[];
+export type ReadLinesOptions = {
+    /** 是否过滤仅含空白的行 */
+    notBlank?: boolean;
+    /** 是否过滤空行 */
+    notEmpty?: boolean;
+    /** 是否去除每行首尾空白 */
+    trim?: boolean;
+    /** 是否去重 */
+    distinct?: boolean;
+};
+/**
+ * 同步读取文件文本行
+ * @param path 文件路径（相对于脚本根目录）
+ * @param options 读取选项
+ */
+export declare const readLinesSync: (path: string, options: ReadLinesOptions) => string[];
+/**
+ * 读取文件文本行
+ * @param path 文件路径（相对于脚本根目录）
+ * @param options 读取选项
+ */
+export declare const readLines: (path: string, options: ReadLinesOptions) => Promise<string[]>;

package/dist/file.js

@@ -0,0 +1,43 @@
+/**
+ * 读取指定文件夹内所有文件的路径
+ * @param folderPath 文件夹路径（相对于脚本根目录）
+ * @param recursive 是否递归子文件夹（默认：false）
+ * @returns 文件路径数组
+ */
+export const listFiles = (folderPath, recursive) => {
+    return [...file.readPathSync(folderPath)].flatMap(path => recursive && file.isFolder(path) ? listFiles(path, recursive) : file.isFolder(path) ? [] : path);
+};
+/**
+ * 同步读取文件文本行
+ * @param path 文件路径（相对于脚本根目录）
+ * @param options 读取选项
+ */
+export const readLinesSync = (path, options) => {
+    const { notBlank = false, notEmpty = false, trim = false, distinct = false } = options || {};
+    return file
+        .readTextSync(path)
+        .replaceAll("\r\n", "\n")
+        .split("\n")
+        .filter(line => (!notBlank || line.trim().length > 0) && (!notEmpty || line.length > 0))
+        .map(line => (trim ? line.trim() : line))
+        .reduce((acc, line) => {
+        return distinct ? (acc.includes(line) ? acc : [...acc, line]) : [...acc, line];
+    }, []);
+};
+/**
+ * 读取文件文本行
+ * @param path 文件路径（相对于脚本根目录）
+ * @param options 读取选项
+ */
+export const readLines = async (path, options) => {
+    const { notBlank = false, notEmpty = false, trim = false, distinct = false } = options || {};
+    const text = await file.readText(path);
+    return text
+        .replaceAll("\r\n", "\n")
+        .split("\n")
+        .filter(line => (!notBlank || line.trim().length > 0) && (!notEmpty || line.length > 0))
+        .map(line => (trim ? line.trim() : line))
+        .reduce((acc, line) => {
+        return distinct ? (acc.includes(line) ? acc : [...acc, line]) : [...acc, line];
+    }, []);
+};

package/dist/game.js

@@ -101,10 +101,11 @@ export const setTimeTo = async (hour, minute, options) => {
         .map(rad => ({ x: radius * Math.cos(rad), y: radius * Math.sin(rad) }))
         // 计算绝对坐标
         .map(p => ({ x: Math.round(p.x + centerX), y: Math.round(p.y + centerY) })));
-    // 3.拨动指针
+    // 3.调整时间
     await withGameMetrics(1920, 1080, 1.5, async () => {
+        // 拨动指针
         await mouseMoveAlongWaypoints(waypoints, { shouldDrag: true });
-        // 3.点击确认按钮，等待调整结束
+        // 点击确认按钮，等待调整结束
         await assertRegionAppearing(() => findTextInDirection("时间少于", "south-east", { contains: true }), "调整时间超时", () => {
             findTextInDirection("确认", "south-east")?.click();
         }, { maxAttempts: 20, retryInterval: 1000 });
@@ -120,12 +121,12 @@ export const setTimeTo = async (hour, minute, options) => {
 export const setTime = async (period, options) => {
     switch (period) {
         case "night":
-            return setTimeTo(0, 0, options);
+            return setTimeTo(0, 5, options);
         case "morning":
-            return setTimeTo(6, 0, options);
+            return setTimeTo(6, 5, options);
         case "noon":
-            return setTimeTo(12, 0, options);
+            return setTimeTo(12, 5, options);
         case "evening":
-            return setTimeTo(18, 0, options);
+            return setTimeTo(18, 5, options);
     }
 };

package/dist/index.d.ts

@@ -1,7 +1,20 @@
+/** 断言 */
 export * from "./asserts";
-export * from "./workflow";
+/** 文件操作 */
+export * from "./file";
+/** 游戏操作 */
 export * from "./game";
+/** HTTP 请求 */
 export * from "./http";
+/** 杂项 */
+export * from "./misc";
+/** 鼠标操作 */
 export * from "./mouse";
+/** 图像识别 */
 export * from "./ocr";
+/** 数据存储 */
 export * from "./store";
+/** 日期时间 */
+export * from "./time";
+/** 流程控制 */
+export * from "./workflow";

package/dist/index.js

@@ -1,7 +1,20 @@
+/** 断言 */
 export * from "./asserts";
-export * from "./workflow";
+/** 文件操作 */
+export * from "./file";
+/** 游戏操作 */
 export * from "./game";
+/** HTTP 请求 */
 export * from "./http";
+/** 杂项 */
+export * from "./misc";
+/** 鼠标操作 */
 export * from "./mouse";
+/** 图像识别 */
 export * from "./ocr";
+/** 数据存储 */
 export * from "./store";
+/** 日期时间 */
+export * from "./time";
+/** 流程控制 */
+export * from "./workflow";

package/dist/misc.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 生成UUID
+ * @param withDashes 是否包含连字符
+ */
+export declare const generateUUID: (withDashes?: boolean) => string;
+/**
+ * Fisher-Yates 洗牌算法
+ * @param array 待洗牌数组
+ * @returns 洗牌后的新数组
+ */
+export declare const shuffleArray: <T>(array: T[]) => T[];

package/dist/misc.js

@@ -0,0 +1,26 @@
+/**
+ * 生成UUID
+ * @param withDashes 是否包含连字符
+ */
+export const generateUUID = (withDashes = true) => {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx"
+        .replace(/[xy]/g, c => {
+        const r = (Math.random() * 16) | 0;
+        return (c === "x" ? r : (r & 0x3) | 0x8).toString(16);
+    })
+        .replace(/-/g, withDashes ? "-" : "");
+};
+/**
+ * Fisher-Yates 洗牌算法
+ * @param array 待洗牌数组
+ * @returns 洗牌后的新数组
+ */
+export const shuffleArray = (array) => {
+    const shuffled = [...array];
+    let i = shuffled.length;
+    while (i) {
+        const j = Math.floor(Math.random() * i--);
+        [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+    }
+    return shuffled;
+};

package/dist/time.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取下一个（含当日）凌晨4点的时间
+ */
+export declare const getNextDay4AM: () => Date;
+/**
+ * 获取下一个（含当日）周一凌晨4点的时间
+ */
+export declare const getNextMonday4AM: () => Date;

package/dist/time.js

@@ -0,0 +1,25 @@
+/**
+ * 获取下一个（含当日）凌晨4点的时间
+ */
+export const getNextDay4AM = () => {
+    const now = new Date();
+    const result = new Date(now);
+    result.setHours(4, 0, 0, 0);
+    // 如果当前时间在4点前，则返回今天4点，否则返回明天4点
+    const daysUntilNextDay = now.getHours() < 4 ? 0 : 1;
+    result.setDate(now.getDate() + daysUntilNextDay);
+    return result;
+};
+/**
+ * 获取下一个（含当日）周一凌晨4点的时间
+ */
+export const getNextMonday4AM = () => {
+    const now = new Date();
+    const result = new Date(now);
+    result.setHours(4, 0, 0, 0);
+    // 如果当前为周一且时间在4点前，则返回今天4点，否则返回下一个周一的4点
+    const currentDay = now.getDay();
+    const daysUntilNextMonday = currentDay === 1 && now.getHours() < 4 ? 0 : (8 - currentDay) % 7;
+    result.setDate(now.getDate() + daysUntilNextMonday);
+    return result;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/utils",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "开发 BetterGI 脚本常用工具集",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",