v.1.3版本 参量质变仪 20250629 (#1235)

* Delete repo/js/参量质变仪 directory

重新命名升级

* v.1.3版本 参量质变仪  20250629

### v.1.3 20250629
- 更改下来滚动条方式，防止鼠标超出边界。
- 规范化脚本名称，添加README.md文件。

repo/js/ParametricTrans/README.md

@@ -0,0 +1,46 @@
+# 参量质变仪使用说明
+
+## 一、使用前准备
+
+- **设置队伍**：使用前请在配置中设置要切换的队伍（必填），否则脚本会自动结束任务。
+
+## 二、脚本使用
+
+- **芭芭拉充能**：脚本使用芭芭拉的攻击动作充能参量质变仪，请确保切换的队伍4号位为芭芭拉。
+
+## 三、自定义放入材料
+
+1. **截图保存**：自行截图所需图片，保存在“`\assets`”目录下。（建议在1080P下进行截图，推荐PNG或BMP格式）。
+
+2. **默认材料**：默认参量质变仪选取物料为“薄荷”。
+
+3. **自定义材料选择**：在“材料”选项中，如自定义材料，请在配置“选填，质变的材料在哪一类物品中（默认材料）”中选择所在类目。
+
+4. **常用材料**：“`\assets`”目录下已截图了一些常用的材料，将对应图地址配置到设置中即可。
+
+5. **新材料地址**：在配置中填入新的材料图片地址，例如：`assets/niujiao.png`。
+
+## 四、调度与执行
+
+- **建议**：建议直接加入每日执行的调度器，如果参量质变仪在冷却中（CD），脚本会自动结束任务。
+
+## 五、后言
+
+1. **测试阶段反馈**：目前处于测试阶段，如有错误，请通过QQ：119996800联系反馈。
+
+2. **API封装**：官方刚释放了图片和文字识别的API，一些用法还在学习中，已在此基础上进行了封装，方便后续复用。
+
+## 六、更新说明
+
+### v.1.1 20250426
+
+- 修改下拉菜单次数，适配4K分辨率。
+
+### v.1.2 20250512
+
+- 更改UID识别方法，适配原神UI改变。
+
+### v.1.3 20250629
+
+- 更改下来滚动条方式，防止鼠标超出边界。
+- 规范化脚本名称，添加README.md文件。

repo/js/ParametricTrans/main.js

@@ -0,0 +1,252 @@
+(async function () {
+
+    //初始化配置======================================================================================
+    var BH = typeof settings.BH === 'string' && settings.BH.trim() !== '' ? settings.BH : "assets/bh.bmp";
+    var ZHIBIANYI = typeof settings.ZHIBIANY === 'string' && settings.ZHIBIANYI.trim() !== '' ? settings.ZHIBIANYI : "assets/zhibian.bmp";
+    var actiontime = settings.actiontime != undefined && ~~settings.actiontime > 0 ? ~~settings.actiontime : 50;
+    var TEAM
+    const ITEM = settings.ITEM !== undefined ? (
+        settings.ITEM === "1养成道具" ? 1 :
+        settings.ITEM === "2食物" ? 2 :
+        settings.ITEM === "3材料" ? 3 :
+        3 ) : 3; // 如果settings.ITEM完全未定义，也赋予ITEM为3
+    
+    /**
+     * 文字OCR识别封装函数（测试中，未封装完成，后续会优化逻辑）
+     * @param text 要识别的文字，默认为"空参数"
+     * @param timeout 超时时间，单位为秒，默认为10秒
+     * @param afterBehavior 点击模式，0表示不点击，1表示点击识别到文字的位置，2表示输出模式，默认为0
+     * @param debugmodel 调试代码，0表示输入判断模式，1表示输出位置信息，2表示输出判断模式，默认为0
+     * @param x OCR识别区域的起始X坐标，默认为0
+     * @param y OCR识别区域的起始Y坐标，默认为0
+     * @param w OCR识别区域的宽度，默认为1920
+     * @param h OCR识别区域的高度，默认为1080
+     * @returns 包含识别结果的对象，包括识别的文字、坐标和是否找到的结果
+     */
+    async function textOCR(text="空参数",timeout=10,afterBehavior=0,debugmodel=0,x=0,y=0,w=1920,h=1080) {
+        const startTime = new Date();
+        var Outcheak = 0 
+        for (var ii = 0; ii < 10; ii++) 
+        {    
+             // 获取一张截图
+             var captureRegion = captureGameRegion();
+             var  res1 
+             var  res2 
+             var  conuntcottimecot=1;
+             var  conuntcottimecomp=1;
+            // 对整个区域进行 OCR
+            var resList = captureRegion.findMulti(RecognitionObject.ocr(x,y,w,h));
+            //log.info("OCR 全区域识别结果数量 {len}", resList.count);
+            if (resList.count !== 0) {
+             for (let i = 0; i < resList.count; i++) 
+             { // 遍历的是 C# 的 List 对象，所以要用 count，而不是 length
+                let  res = resList[i];
+                res1=res.text  
+                conuntcottimecomp++;
+                 if (res.text.includes(text) && debugmodel !==2 ) {
+                    conuntcottimecot ++;
+                    log.info(`“${res1}”找到`);
+                    if (debugmodel===1 & x===0 & y===0){log.info("全图代码位置：({x},{y},{h},{w})", res.x-10, res.y-10, res.width+10, res.Height+10);}else{log.info("文本OCR完成'{text}'", res.text);}
+                    if (afterBehavior===1){log.info("点击模式:开");await sleep(1000);click(res.x, res.y);}else{if (debugmodel===1 & x===0 & y===0){log.info("点击模式:关")}}  
+                    if (afterBehavior===2){log.info("F模式:开");await sleep(100);keyPress("F");}else{if (debugmodel===1 & x===0 & y===0){log.info("F模式:关");}}
+                    if (conuntcottimecot>=conuntcottimecomp/2){return result = { text: res.text, x: res.x, y: res.y, found: true };}else{return result = {  found: false};}  
+                 }
+                 if (debugmodel ===2 ){
+                    if (res1 === res2){conuntcottimecot ++;res2=res1;}
+                    log.info("输出模式：全图代码位置：({x},{y},{h},{w},{string})", res.x-10, res.y-10, res.width+10, res.Height+10, res.text);
+                    if (Outcheak===1){ if (conuntcottimecot>=conuntcottimecomp/2){return result = { text: res.text, x: res.x, y: res.y, found: true };}else{return result = {  found: false};}}
+                }}}             
+            const NowTime = new Date();
+            if ((NowTime - startTime)>timeout*1000){if (debugmodel===2){ if (resList.count === 0){return result = {found: false};} else{Outcheak=1;ii=2;}     } else {Outcheak=0;if (debugmodel===1 & x===0 & y===0){log.info(`${timeout}秒超时退出，"${text}"未找到`)};return result = {found: false };}}
+            else{ii=2;if (debugmodel===1 & x===0 & y===0){log.info(`"${text}"识别中……`); } }
+            await sleep(100);
+            }  
+    }
+
+    /**
+     * 封装函数，执行图片识别及点击操作（测试中，未封装完成，后续会优化逻辑）
+     *
+     * @param filePath 图片路径，默认为"空参数"
+     * @param timeout 超时时间，单位为秒，默认为10秒
+     * @param afterBehavior 点击模式，0为关闭点击，1为开启点击，2为开启F键点击，默认为0
+     * @param debugmodel 调试代码模式，0为关闭调试模式，1为开启调试模式，默认为0
+     * @param xa 识别区域的x轴偏移量，默认为0
+     * @param ya 识别区域的y轴偏移量，默认为0
+     * @param wa 识别区域的宽度，默认为1920
+     * @param ha 识别区域的高度，默认为1080
+     * @returns 返回识别结果，包括图片的x轴坐标、y轴坐标、宽度、高度及是否找到图片
+     */
+    async function imageRecognition(filePath="空参数",timeout=10,afterBehavior=0,debugmodel=0,xa=0,ya=0,wa=1920,ha=1080) {
+        const startTime = new Date();
+        const Imagidentify = RecognitionObject.TemplateMatch(file.ReadImageMatSync(filePath));
+        for (let ii = 0; ii < 10; ii++) {    
+            captureRegion = captureGameRegion();  // 获取一张截图
+            res = captureRegion.DeriveCrop(xa, ya, wa, ha).Find(Imagidentify);
+        if (res.isEmpty()) {
+            if (debugmodel===1 & xa===0 & ya===0){log.info("识别图片中")};
+        } else {
+          if (afterBehavior===1){log.info("点击模式:开");await sleep(1000);click(res.x, res.y);}else{if (debugmodel===1 & xa===0 & ya===0){log.info("点击模式:关")}}
+          if (afterBehavior===2){log.info("F模式:开");await sleep(1000);keyPress("F");}else{if (debugmodel===1 & xa===0 & ya===0){log.info("F模式:关")}}
+          if (debugmodel===1 & xa===0 & ya===0){log.info("全图代码位置：({x},{y},{h},{w})", res.x-10, res.y-10, res.width+10, res.Height+10);}else{ log.info("识别到图片");}
+          return result = { x: res.x, y: res.y, w:res.width,h:res.Height,found: true }
+        }
+        const NowTime = new Date();
+        if ((NowTime - startTime)>timeout*1000){if (debugmodel===1 & xa===0 & ya===0){log.info(`${timeout}秒超时退出，未找到图片`);}return result = {found: false };}else{ii=8}
+        await sleep(200); 
+        }
+        await sleep(1200); 
+    }
+
+/**======================================================================================
+ * 执行质变仪的部署动作，未找到质变仪时返回false结束，找到质变仪时返回true
+ */
+async function deployTransformer(){
+    
+    await sleep(500);
+    await keyPress("B");
+    await sleep(1000);
+    await click(1067,57);//点开背包,可做图像识别优化
+
+    await textOCR("小道具",3,0,0,126,17,99,53);if (!result.found){throw new Error("未打开'小道具'页面");}//确认在小道具界面
+    await sleep(500);
+    await imageRecognition(ZHIBIANYI,1,1,0);//识别质变仪图片
+    if (!result.found){await genshin.returnMainUi();throw new Error("'质变仪CD中'或'未找到质变仪!'");}//没找到质变仪退出流程
+    else{await sleep(1000);await click(1699,1004);await sleep(1000);await genshin.returnMainUi();return true} //点击部署操作  
+
+}
+
+/**======================================================================================
+ * 游戏内“参量质变仪”的放入薄荷交互流程
+ */
+async function insertMaterial(){
+
+    //检测并进入质变仪界面
+    await middleButtonClick();
+    await sleep(500);
+    await textOCR("参量质变仪",1,2,0,1205,508,140,53);//单条F检测
+    await keyPress("F");
+
+    //检测是否到达材料页面
+    await textOCR("进行质变",3,0,0,1675,994,150,50);if (!result.found){throw new Error("质变仪页面未打开");}//单条F检测
+    await sleep(500);
+    switch (ITEM) {
+        case 1:
+            await click(863,47); // 初始化与'1养成道具'相关的设置或资源
+            await textOCR("养成道具",3,0,0,120,19,240,50);if (!result.found){throw new Error("'养成道具'页面未打开");}
+            break;
+        case 2:
+            await click(959,45);// 初始化与'2食物'相关的设置或资源
+            await textOCR("食物",3,0,0,124,16,93,63);if (!result.found){throw new Error("'食物'页面未打开");}
+            break;
+        case 3:
+            await click(1050,50); // 初始化与'3材料'相关的设置或资源
+            await textOCR("材料",3,0,0,124,16,93,63);if (!result.found){throw new Error("'材料'页面未打开");}
+            break;
+        default:
+            // 处理未知ITEM值的情况
+            break;
+    }
+
+        //滚轮预操作
+    await moveMouseTo(1287,131);
+    await sleep(100);
+    await leftButtonDown();
+    await sleep(100);
+    await moveMouseTo(1287,161);
+    // 薄荷图片检测
+    let YOffset = 0; // Y轴偏移量，根据需要调整
+    const maxRetries = 20; // 最大重试次数
+    let retries = 0; // 当前重试次数
+    while (retries < maxRetries) {
+        await imageRecognition(BH, 1, 0, 0);
+        if (result.found) {
+            await leftButtonUp();
+            await sleep(500);
+            await click(result.x,result.y); 
+            await sleep(1000);
+            await click(440,1008);  //选择最大数量 
+            await sleep(1000);
+            await click(1792,1019); //质变按钮 
+            await textOCR("参量质变仪",3,0,0,828,253,265,73);if (!result.found){throw new Error("单种材料不足，退出！");}
+            await sleep(1000);
+            await click(1183,764); //确认 ;
+            await sleep(1000);
+            await genshin.returnMainUi(); 
+            return true   
+        }
+        retries++; // 重试次数加1
+        //滚轮操作
+        YOffset += 50;
+        await sleep(500); 
+        if (retries === maxRetries || 161+YOffset > 1080) {
+            await leftButtonUp();
+            await sleep(100); 
+            await moveMouseTo(1287,131);
+            await genshin.returnMainUi(); 
+            throw new Error("未找到材料（默认薄荷，自定义请看'注意使用事项.txt'）！");
+        }
+        await moveMouseTo(1287,161+YOffset);
+        await sleep(300);   
+    }
+}
+
+
+/**======================================================================================
+ * 执行芭芭拉攻击指令，并等待质变仪完成提示出现。 若超时则强制结束流程。
+ */
+async function executeAttack(){
+
+    await genshin.SwitchParty(TEAM); //切换到指定队伍，必须进行配置，4号位放芭芭拉
+    await sleep(1000);
+    await keyPress("4");
+    await sleep(1200);
+    await middleButtonClick();
+    await sleep(1000);
+    log.info(`攻击动作开始，${actiontime}秒后超时退出！一般20秒左右完成！`)
+
+    var startTime = new Date();
+    await sleep(500);
+    var NowTime = new Date();
+    //芭芭拉攻击指令，等待质变仪完成提示出现，若超时则强制结束流程。
+    while ((NowTime - startTime)<actiontime*1000){
+        leftButtonClick();
+        await textOCR("质变产生了以下物质",0.7,1,0,539,251,800,425);if(result.found){return true}  
+        leftButtonClick();
+        await textOCR("质变产生了以下物质",0.7,1,0,539,251,800,425);if(result.found){return true}
+        NowTime = new Date();
+    }
+    await genshin.returnMainUi();
+    throw new Error(`${actiontime}秒攻击动作超时，结束流程！`);
+}
+
+
+//main/======================================================================================
+    await genshin.returnMainUi();
+    //检查用户是否配置队伍============================================
+    if (settings.TEAMname === undefined) { 
+        throw new Error("必填！请在配置页面填写队伍名称，芭芭拉放4号位！"); // 没选就报错后停止
+    }else{TEAM = settings.TEAMname}
+
+    log.info("请确保单种材料足够，现在开始部署！！");
+
+//开始执行质变仪流程============================================
+    try {
+        if ((await deployTransformer())) {//部署质变仪流程
+            log.info("部署成功，准备放入薄荷！！");
+        }
+        if ((await insertMaterial())) {//放入薄荷并开始质变流程
+            log.info("放入薄荷完成，开始质变！！");
+        }
+        if ((await executeAttack())) {//芭芭拉攻击指令流程
+            log.info("质变执行完成，结束！！");
+        }
+    } catch (error) {
+        log.error(`执行过程中发生错误：${error.message}`);
+    } finally {
+        await genshin.returnMainUi();
+    }
+//main/**======================================================================================
+
+})();
+
+

repo/js/ParametricTrans/manifest.json

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 1,
+  "name": "参量质变仪",
+  "version": "1.3",
+  "bgi_version": "0.44.0",
+  "description": "参量质变仪自动化,请注意说明文件,如有BUG请联系作者QQ:119996800",
+  "tags":["参量质变仪"],
+  "authors": [
+    {
+      "name": "LCB-茶包"
+    }
+  ],
+  "settings_ui": "settings.json",
+  "main": "main.js"
+}

repo/js/ParametricTrans/settings.json

@@ -0,0 +1,35 @@
+[
+  {
+    "name": "TEAMname",
+    "type": "input-text",
+    "label": "必填！！队伍名称，4号位放芭芭拉！"
+},
+  {
+    "name": "BH",
+    "type": "input-text",
+    "label": "选填，默认薄荷，识别物料的图片路径（默认assets/bh.bmp）",
+    "default": "assets/bh.bmp"
+},
+{
+  "name": "ZHIBIANYI",
+  "type": "input-text",
+  "label": "选填，质变仪的图片路径（默认assets/zhibian.bmp）",
+  "default": "assets/zhibian.bmp"
+},
+  {
+    "name": "actiontime",
+    "type": "input-text",
+    "label": "选填，攻击超时时间（默认50秒）",
+    "default": "50"
+},
+{
+  "name": "ITEM",
+  "type": "select",
+  "label": "选填，质变的材料在哪一类物品中（默认材料）",
+  "options": [
+    "1养成道具",
+    "2食物",
+    "3材料"
+  ]
+}
+]