bettergi-scripts-list/repo/js/AutoPlan/README.md
云端客 d023577615
AutoPlan自动体力计划-0.1.4 (#3628)
* refactor(AutoPlan): 重构体力计划相关变量命名

- 将 autoOrderSet 参数重命名为 auto_plan_set
- 将 autoFightOrderSet 变量重命名为 auto_plan_set
- 将 from 变量重命名为 auto_plan_list
- 更新相关日志输出中的变量名称
- 统一使用 plan 相关术语以提高代码一致性

fix(AutoPlan): 修复异常处理逻辑

- 添加配置检查来控制异常抛出行为
- 实现排除异常与循环计划的互斥逻辑
- 确保在特定配置下正确抛出异常

fix(AutoPlan): 修复检查运行中的异常处理

- 在 try-catch 块中添加错误捕获机制
- 使用 Log.error 记录异常消息
- 确保程序在发生错误时能够正常继续执行 finally 块

fix(AutoPlan): 调整添加按钮的位置和尺寸

- 将按钮x坐标从1373调整为1248
- 将按钮y坐标从22调整为21
- 将按钮宽度从52调整为50
- 将按钮高度从49调整为50

* refactor(AutoPlan): 注释掉检查运行配置中的通知选项

- 临时禁用 adventurer handbook 使用选项
- 保留 transient resin 使用功能
- 移除 notification 通知功能的配置项
- 优化配置键值构建逻辑

feat(AutoPlan): 移除通知和冒险之证功能并更新版本

- 注释掉 useAdventurerHandbook 和 isNotification 配置项
- 移除相关的参数解析和赋值逻辑
- 更新插件版本从 0.1.3 到 0.1.4
- 更新 bgi_version 从 0.63.0 到 0.64.2

* refactor(AutoPlan): 调整配置参数结构并更新版本

- 移除使用冒险家之书和详细通知配置选项
- 修正复活重试次数字段名(rviveRetryCount -> reviveRetryCount)
- 更新配置表格参数编号,调整Boss类型参数起始位置
- 添加0.1.4版本更新记录,适配BGI本体API改动
- 修复OCR识别问题并更新版本兼容性说明

* docs(AutoPlan): 更新文档中的图片路径

- 将所有图片路径从 md/ 目录移动到 assets/md/ 目录
- 更新 README.md 中 check 和 record 图片的引用路径
- 更新 bgi-tools 登录和配置界面截图的引用路径
- 更新圣遗物阈值检查和执行记录功能截图的引用路径

* fix(security): 更新插件密钥配置

- 替换了旧的加密密钥为新的安全密钥
- 修复了密钥轮换后的主要密钥配置
- 更新了备用密钥的存储值以确保安全性
2026-09-10 19:31:57 +08:00

22 KiB
Raw Permalink Blame History

AutoPlan自动体力计划

自动体力计划JS
本脚本通过调用 BetterGI 本体自动秘境实现体力计划

功能说明

本脚本为 BetterGI 的自动秘境功能提供计划/排期能力,让你能:

  • 为不同队伍配置不同的秘境刷取目标
  • 设置刷取轮次
  • 限制只在特定星期几执行(例如周日限定本、周本)
  • 设置执行优先级(数字越大越先跑)
  • 支持三种配置来源(输入 / UID专属 / bgi_tools远程)
  • 自动检测幽境开启状态 check
  • 记录执行体力计划 record

配置项说明

脚本通过以下界面配置项进行设置(对应 settings.json):

配置项 类型 说明 示例值
key input-text 版本密钥(必填,仔细看本文档) xxxx
auto_load multi-checkbox 加载模式(可多选)
・输入加载:使用下方 run_config 字段
・UID加载:读取 config/run_config.json(每个UID独立)
・bgi_tools加载:从远程API拉取
默认:["输入加载","UID加载"]
auto_check multi-checkbox 检查(可多选)
・"幽境检查"=>检查幽境是否开启,"圣遗物空间检查"=>检查圣遗物背包空间
默认:["幽境检查","圣遗物空间检查"]
holy_relic_threshold input-text 圣遗物空间检查设置剩余阈值 如:2300/2400剩余阈值100,2409/2400剩余阈值9
run_config input-text 自动秘境计划配置(当选择“输入加载”时生效)
格式见下方“计划配置语法”
速刷|苍白的遗荣|3|1-3|0,6|9
(多条用英文逗号分隔)
loop_plan checkbox 启用循环体力计划
retry_count select 复活重试次数
bgi_tools_http_pull_json_config input-text bgi_tools 拉取配置的 API 地址(当选择 bgi_tools加载 时生效) https://example.com/api/pull
bgi_tools_open_push checkbox 是否在脚本结束时推送当前全部配置给 bgi_tools(用于同步/备份) 勾选 = 开启推送
bgi_tools_http_push_all_json_config input-text bgi_tools 推送秘境常量的 API 地址(当开启推送时使用) https://example.com/api/push-all
bgi_tools_http_push_all_country_config input-text bgi_tools 推送国家常量的 API 地址(当开启推送时使用) https://example.com/api/push-all
bgi_tools_http_push_all_boss_config input-text bgi_tools 推送Boss常量的 API 地址(当开启推送时使用) https://example.com/api/push-all
bgi_tools_token input-text bgi_tools授权token 语法:tokenName=tokenValue tokenName=tokenValue

计划配置语法(run_config 字段)

队伍名称|秘境名称/刷取物品名称|刷几轮|限时/周日(1-3和本体的一致)|周几执行(0-6)不填默认执行|树脂使用顺序|执行顺序(越大越先执行)
  • 多条计划用 英文半角逗号 , 分隔
  • 字段之间用 英文半角竖线 | 分隔
  • 必须 填写:秘境名称/物品名称
  • 其他字段可省略(留空即可,但竖线不能省)

字段详解

位置 字段 是否必填 说明 示例
1 类型 必填 秘境/地脉/幽境/Boss 秘境/地脉/幽境/Boss
2 周几执行(0-6) 可选 0=周日,1=周一,...,6=周六;可多选按/分割,不填=每天都可执行 0/3,3
3 执行顺序 可选 数字越大越优先执行(同时间点先跑优先级高的) 9 / 5 / 1
4 记录执行 可选 启用随便填个值
秘境类型后几位参数说明
5 队伍名称 可选 BetterGI 中已保存的队伍名称(用于切换队伍) 速刷 / 雷国 / 国家队
6 秘境名称/刷取物品名称 必填 与 BetterGI 自动秘境识别的名称保持一致 苍白的遗荣 / 炽烈的炎之魔女 / 辰砂往生录
7 刷几轮 可选 整数,执行几轮(每轮 = 1次完整秘境) 3 / 5 / 10
8 限时/周日 可选 和本体的1-3一致 1 / 2 / 3
9 树脂使用顺序 可选 原粹树脂,浓缩树脂,须臾树脂,脆弱树脂/分割,不填=默认执行 原粹树脂 原粹树脂/浓缩树脂,须臾树脂
地脉类型后几位参数说明
5 队伍名称 可选 BetterGI 中已保存的队伍名称(用于切换队伍) 速刷 / 雷国 / 国家队
6 国家 必填 识别国家(用于切换国家) 纳塔 ...
7 刷几轮 必填 刷几轮 1
8 地脉类型 必填 启示之花/藏金之花 启示之花 / 藏金之花
9 好感队 可选
10 使用脆弱树脂 可选 启用随便填个值
11 使用须臾树脂 可选 启用随便填个值
12 合成浓缩树脂 可选 启用随便填个值
13 战斗超时 可选 可选,默认 120
幽境类型后几位参数说明
5 指定刷取战场 可选 (1-3)不填使用BetterGI默认的配置 1
6 队伍名称 可选 BetterGI 中已保存的队伍名称(用于切换队伍)不填使用BetterGI默认的配置 速刷 / 雷国 / 国家队
7 是否指定使用自定义树脂 可选 启用随便填个值 不填使用BetterGI默认的配置
8 自定义树脂顺序 可选 原粹树脂,浓缩树脂,须臾树脂,脆弱树脂/分割 不填使用BetterGI默认的配置 原粹树脂 / 浓缩树脂 / 须臾树脂
9 自定义树脂次数 可选 和自定义树脂顺序对应 /分割 不填使用BetterGI默认的配置 1 / 2 / 3
Boss类型后几位参数说明
5 Boss 名称 必填 需要在 BetterGI 自动讨伐界面中选择的 Boss 名称,大小写和标点必须与游戏内完全一致 无相之雷、急冻树
6 策略名称 可选 BetterGI 中预设的战斗策略名称,留空则使用默认策略 速杀、国家队
7 战斗策略路径 可选 自定义战斗脚本路径,JS 可直接设置该路径来覆盖策略名称。普通用户可留空 D:\scripts\boss1.txt
8 队伍名称 可选 执行讨伐前需要切换到的队伍名称,留空保持当前队伍 雷国、永冻队
9 是否指定次数 可选 true 或 false,不填默认视为 false(即未指定次数,刷至体力耗尽)。注意:若指定次数,必须同时填写第10项 true
10 讨伐次数 可选 当第9项为 true 时必填,成功领取奖励的目标次数 5
11 使用须臾树脂 可选 指定次数模式下,原粹树脂不足时是否允许使用须臾树脂。true/false false
12 使用脆弱树脂 可选 指定次数模式下,原粹树脂不足时是否允许使用脆弱树脂。true/false false
13 复活重试次数 可选 角色死亡后自动回神像恢复并重试的最大次数/脚本全局 取最大值 3
14 每轮返回神像 可选 true 表示每打完一轮先返回神像再重新前往 Boss。true/false false
15 奖励识别 可选 是否启用奖励名称识别(通过 OCR 校验奖励是否正确)。true/false false
配置示例
秘境|0/3|9||速刷|苍白的遗荣|3|1,          # 优先级最高,周日,周三刷3轮遗荣
秘境||5||国家队|炽烈的炎之魔女|5||,       # 优先级次之,每天刷5轮魔女
秘境|0|2||雷国|无想之刃狭间|2|2|浓缩树脂/原粹树脂,          # 只在周日刷,优先使用浓缩树脂后使用原粹树脂,优先级较低
地脉||1|1||蒙德|1|启示之花|||||120, #优先级较低 刷1轮蒙德经验书
幽境||1||||, #幽境 默认本体配置
幽境||1||1|队伍|1|浓缩树脂/原粹树脂|1/1, #幽境 默认自定义树脂配置 切换到 队伍 运行->浓缩树脂 1次->原粹树脂 1次

Boss|0/3|8||无相之雷|速杀||雷国|true|3|false|false|2|true|false,   # 周日和周三执行,优先级8,速刷无相之雷3次,每轮返回神像,不识别奖励
Boss||5||急冻树|||国家队|true|1|true|false|1||,          # 每天执行,优先级5,打1次急冻树,允许用须臾树脂
Boss||3||爆炎树||||false||||||                            # 最简单配置:每日自动讨伐爆炎树直至体力耗尽(不指定次数,不切换队伍,其他默认)

(注意:最后一条也可以不带逗号)

计划配置语法(config/run_config.json 配置)

[
  [
    "uid",
    [
      {
        // 顺序值
        "order": 1,
        // 执行日期
        "days": [
          0
        ],
        // 类型支持。  秘境、地脉、幽境、Boss
        "runType": "秘境",
        //记录
        "record": true,
        // 秘境信息对象,
        "autoFight": {
          //树脂开启和使用顺序
          "physical": [
            {
              "order": 0,
              "name": "原粹树脂",
              "open": true
            },
            {
              "order": 1,
              "name": "浓缩树脂",
              "open": false
            },
            {
              "order": 2,
              "name": "须臾树脂",
              "open": false
            },
            {
              "order": 3,
              "name": "脆弱树脂",
              "open": false
            }
          ],
          //秘境名称
          "domainName": undefined,
          //队伍名称
          "partyName": undefined,
          //周日|限时选择的值
          "sundaySelectedValue": undefined,
          //副本轮数
          "domainRoundNum": undefined
        },
        //地脉信息对象
        "autoLeyLineOutcrop": {
          //刷几轮
          "count": 0,
          //国家
          "country": "",
          //地脉类型  启示之花/藏金之花
          "leyLineOutcropType": "启示之花",
          //好感队伍名称
          "friendshipTeam": "",
          //队伍名称
          "team": "",
          //战斗超时
          "timeout": 120,
          //合成浓缩树脂
          "isGoToSynthesizer": false,
          //使用脆弱树脂
          "useFragileResin": false,
          //使用须臾树脂
          "useTransientResin": false
        },
        //危战信息对象
        "autoStygianOnslaught": {
          //自定义树脂
          "physical": [
            {
              "order": 0,
              "name": "原粹树脂",
              "open": true,
              "count": 0
            },
            {
              "order": 1,
              "name": "浓缩树脂",
              "open": false,
              "count": 0
            },
            {
              "order": 2,
              "name": "须臾树脂",
              "open": false,
              "count": 0
            },
            {
              "order": 3,
              "name": "脆弱树脂",
              "open": false,
              "count": 0
            }
          ],
          // 是否指定使用自定义树脂
          "specifyResinUse": false,
          //指定刷取战场 1-3
          "bossNum": undefined,
          //队伍名称
          "fightTeamName": ""
        },
        // 讨伐信息对象 (Boss)
        "autoBoss": {
          // 需要讨伐的 Boss 名称,必填(与 BetterGI 内名称一致)
          "bossName": "",
          // 战斗策略名称(可选,留空则使用默认策略)
          "strategyName": "",
          // 自定义战斗脚本路径(JS 可直接设置,普通用户可留空)
          "combatStrategyPath": "",
          // 讨伐前切换的队伍名称(可选,留空保持当前队伍)
          "teamName": "",
          // 是否指定讨伐次数,true/false,默认 false
          "specifyRunCount": false,
          // 指定模式下的目标讨伐次数(specifyRunCount 为 true 时有效)
          "runCount": 1,
          // 次数不够时是否使用须臾树脂补充,true/false
          "useTransientResin": false,
          // 次数不够时是否使用脆弱树脂补充,true/false
          "useFragileResin": false,
          // 死亡后回神像重试的最大次数
          "rviveRetryCount": 3,
          // 是否每轮结束后返回神像再重新前往 Boss
          "returnToStatueAfterEachRound": false,
          // 是否启用奖励名称 OCR 识别
          "rewardRecognitionEnabled": false
        }
      }
    ]
  ]
]
[
  [
    "10000002",
    [
      {
        "order": 1,
        "days": [
          0
        ],
        "record": false,
        "runType": "秘境",
        "autoFight": {
          "physical": [
            {
              "order": 0,
              "name": "原粹树脂",
              "open": true
            },
            {
              "order": 1,
              "name": "浓缩树脂",
              "open": false
            },
            {
              "order": 2,
              "name": "须臾树脂",
              "open": false
            },
            {
              "order": 3,
              "name": "脆弱树脂",
              "open": false
            }
          ],
          "domainName": "",
          "partyName": "",
          "sundaySelectedValue": 1,
          "domainRoundNum": 1
        }
      },
      {
        "order": 2,
        "days": [],
        "record": true,
        "runType": "地脉",
        "autoLeyLineOutcrop": {
          "count": 1,
          "country": "纳塔",
          "leyLineOutcropType": "启示之花",
          "friendshipTeam": "",
          "team": "",
          "timeout": 120,
          "isGoToSynthesizer": false,
          "useFragileResin": false,
          "useTransientResin": false
        }
      },
      {
        "order": 3,
        "days": [0, 3],
        "record": true,
        "runType": "Boss",
        "autoBoss": {
          "bossName": "无相之雷",
          "strategyName": "速杀",
          "combatStrategyPath": "",
          "teamName": "雷国",
          "specifyRunCount": true,
          "runCount": 3,
          "useTransientResin": false,
          "useFragileResin": false,
          "reviveRetryCount": 2,
          "returnToStatueAfterEachRound": true,
          "rewardRecognitionEnabled": false
        }
      }
    ]
  ]
]

如果你不想研究语法 请部署bettergi-scripts-tools(点击前往部署) v0.0.4以上版本(建议使用v0.0.8+)

话不多说直接上图:

login init init-api config config-01 config-02

使用建议

  1. 第一次使用建议只勾选「输入加载」,把计划写在 run_config 里测试
  2. 熟练后可改为「UID加载」,把配置保存为 config/run_config.json(每个账号独立)
  3. 如果你有自己的云端配置服务,可使用「bgi_tools加载」 + 推送功能实现多端同步
  4. 确保 BetterGI 的自动秘境功能已正常可用(钟离识别、战斗策略等)

常见问题

  • 计划没有执行?
    → 检查密钥是否正确、是否勾选了对应的加载模式、秘境名称是否与 BetterGI 完全一致

  • 周几限制不生效?
    → 确认 BetterGI 系统时间正确,且格式为 0-6(0=周日)

欢迎提交 issue 或 PR 改进脚本~ 祝刷本愉快!

版本对应表

版本 密钥 bettergi-scripts-tools对应版本
0.0.1 oiJbmjU2R0NniiwiZxh 0.0.4+
0.0.2 oiJbmjU2R0NniiwiZxh 0.0.5+
0.0.3 oiJbmjU2R0NniiwiZxh 0.0.6+
0.0.4 oiJbmjU2R0NniiwiZxh 0.0.6+
0.0.5 oiJbmjU2R0NniiwiZxh 0.0.6+
0.0.6 oiJbmjU2R0NniiwiZxh 0.0.6+
0.0.7 oiJbmjU2R0NniiwiZxh 0.0.6+
0.0.8 yHlw8FHjTJAPEtpp9O+ 0.1.3+
0.0.9 yHlw8FHjTJAPEtpp9O+ 0.1.3+
0.1.0 yHlw8FHjTJAPEtpp9O+ 0.1.4+
0.1.1 yHlw8FHjTJAPEtpp9O+ 0.1.5+
0.1.2 yHlw8FHjTJAPEtpp9O+ 0.1.6+
0.1.3 2Cbayi1S2I41BlTXb/XAmw== 0.1.8+
0.1.4 2Cbayi1S2I41BlTXb/XAmw== 0.1.9+

版本历史(简要)

0.1.4 2026.09.06

  • 适配bgi本体API改动
  • 修复OCR识别问题

0.1.3 2026.08.22

  • 修复幽境检查功能
  • 更新JSON格式

0.1.2 2026.07.30

  • 分离幽境检查功能
  • 新增圣遗物背包剩余空间阈值检查
  • holy-relic-threshold
  • Boss配置加自定义战斗超时

0.1.1 2026.06.30

  • Boss常量推送和培养计划支持。

0.1.0 2026.06.27

  • 支持Boss配置

0.0.9 2026.06.12

  • 修复bug

0.0.8 2026.05.29

  • 新增执行记录功能(支持多次执行计划时单个配置只执行一次)
  • record

0.0.7 2026.05.27

  • 重构配置模块:使用新的 UID 获取方法 genshin.uid() 替代 OCR 识别
  • 移除对 ocrUid、getDayOfWeek、parseInteger、pullJsonConfig 和 findStygianOnslaught 的导入
  • 添加对 toMainUi 的导入,在初始化时调用确保回到主界面
  • 更新最低 BetterGI 版本要求从 0.58.0 到 0.61.0
  • 删除 utils/uid.js 文件中的 ocrUid 函数实现
  • 优化 UID 获取逻辑,提升稳定性和准确性

0.0.6 2026.04.23

  • 限制单例模式配置

0.0.5 2026.04.11

  • 调整幽境危战 查找结果判断条件,增加名称不存在的情况处理
  • 默认滚动页面次数为4

0.0.4 2026.03.25

  • 修复识别异常

0.0.3 2026.03.13

  • 健全体力识别(双重识别兜底)

0.0.2 2026.03.07

  • 新增幽境支持

0.0.1 2026.01.30

  • 基本功能完成
  • 支持三种配置加载方式
  • 支持 bgi_tools http 拉取/推送配置
  • 支持按队伍、秘境、轮次、周几、优先级执行计划

作者:云端客 (Kirito520Asuna)