bettergi-scripts-list/repo/js/AutoDomainCustomizable/README.md
FFA 2c008071e2
修正秘境名稱錯別字導致的傳送問題 (#3663)
* 修正秘境名稱錯別字導致的傳送問題

堇色之庭→菫色之庭

* 更新版號
2026-09-17 23:48:20 +08:00

216 lines
8.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 传送并自动秘境 (增强版)
本脚本为 **BetterGI** 自带脚本的增强版本。
允许用户直接在脚本设置中自定义“刷取次数”、“树脂类型”及其他高级参数,支持周期性素材刷取,无需修改 BetterGI 全局设置。
---
⚠️有任何问题 **务必** 先阅读错误信息,依照错误信息指示修改设置,并确保您已 **完整阅读** 本说明。⚠️
遇到无法排除的问题,请将日志去除敏感信息(如账号名称)后,至github提issue上传。
本JS脚本修改者没有QQ账号。
**强烈建议**先以调试模式运行后再上传日志。
没有附上日志记录的问题将被 **无视** 。
日志默认位置在 `BetterGI\log\` 。
---
## ✨ 主要功能
* **全球时区自动换日**:内置时区计算逻辑,自动适配游戏服务器换日时间。
* **自定义树脂策略**:支持指定各类型树脂的使用次数,或选择自动刷取至树脂耗尽。
* **智能队伍切换**:进本前自动切换至指定队伍。
* **全自动托管**:自动传送、进门、战斗及领奖。
* **自动处理**:支持结束后自动分解圣遗物。
* **战斗策略选择**:支持自定义战斗策略文件,可针对不同秘境/队伍配置不同的战斗逻辑。
* **自动识别限时全开**:自动通过OCR识别游戏内的限时全开活动状态。
---
## 🚀 使用方法
⚠️ **重要** :本脚本的参数需要在 **调度器** 中配置!
1. 在调度器中添加脚本。
2. **右键点击**脚本并选择 **“修改JS脚本自定义配置”**。
### 📌 必填项
* **指定要前往的秘境**
* 请在下拉菜单中选择目标副本。
* **注意**:【角色天赋】、【武器升级】、【圣遗物】三类选项**互斥** (只能选其中一个),若同时选择多项,脚本将报错停止。
<br>
* **树脂策略配置**
* **刷取至树脂耗尽 (最高优先级)**
* 若启用此选项,脚本将**忽略**下方所有具体次数的设定。
* 依照配置中 **树脂刷取顺序** 栏中的树脂种类依序刷取至耗尽,未填写在顺序栏中的树脂 **不会** 进行刷取。
<br>
* **指定每种树脂刷取数量**
* 仅在“刷取至树脂耗尽”**关闭** 时生效。
* 脚本将按照设定的次数进行刷取(若四项均为 0 则不执行战斗)。
* 支持的树脂类型:
* **浓缩树脂**
* **原粹树脂(依照数量计算最少刷取次数)**
* **须臾树脂**
* **脆弱树脂**
### ⚙️ 可选项
* **【风险】强制运行**
* **功能**:勾选后将**忽略日期与限时全开检查**,直接进入副本。
* **适用场景**:限时全开自动识别有问题或确认游戏有“精通移涌”活动时使用。
* **警告**:若当日未开放该素材且无活动,勾选此项将会导致刷错素材。
* **优先级**:此选项优先级最高,勾选后“自动识别限时全开”将无效。
<br>
* **自动识别限时全开**
* **功能**:当日期不匹配时,自动通过OCR识别游戏内的限时全开活动状态。
* **适用场景**:希望脚本自动检测活动并在有活动时自动进入副本。
* **特点**:不需要再手动使用强制运行选项了
* **限制**:会增加约10-15秒的检测时间,面对特别卡的设备占用时间很长且容易报错
* **提示**:OCR识别实际上不太稳定,这里只做尽力识别,仍有优化空间,比如识别多处文本进行匹配,或者是利用上识别到的结束时间让不用每次运行都进行OCR,目前主要是测试稳定性
<br>
* **闲时刷取圣遗物**
* **功能**:当目标素材(武器/天赋)不在开放日期且无活动时,自动切换到圣遗物刷取。
* **适用场景**:希望在非素材开放日能消耗树脂刷取圣遗物。
* **配置要求**:需同时配置目标素材(武器/天赋)和圣遗物选项。
* **优先级**:优先尝试刷取目标素材(武器/天赋),条件不满足时才切换到圣遗物。
* **提示**:如果与自动识别限时全开同时开启时,OCR失败会导致前往刷取圣遗物
<br>
* **自动切换到指定队伍**
* 输入队伍名称(需与游戏内完全一致,支持正则表达式),留空则不切换。
<br>
* **秘境刷取轮数**
* `0`:刷到体力耗尽或达到指定树脂次数(默认)。
* `数字`:刷满该场数后强制停止(无论是否还有体力)。
<br>
* **战斗完成后等待时间**
* 设置战斗结算后的缓冲秒数(默认 5 秒),防止因电脑读取卡顿导致过早退出或识别失败。
<br>
* **结束后自动分解圣遗物**
* **功能**:开启后,任务结束前会自动执行圣遗物分解逻辑。
* **分解星级**:可指定分解 **1~4 星** 的圣遗物(需配合下拉菜单设置)。
<br>
* **启用调试模式**
* 开启后会输出更多详细日志信息,用于脚本出错时排查问题。
<br>
* **指定战斗策略**
* **功能**:指定使用的战斗策略文件,默认根据队伍自动选择战斗策略。
* **策略文件存放位置**:`BetterGI/User/AutoFight/`
* **用法**:在下拉菜单中选择指定战斗策略,并在战斗策略名称栏中填写文件名(后缀加不加都行,建议不加),策略文件放在 `User/AutoFight` 下的目录中,(如 `胡桃`,实际查找 `User/AutoFight/胡桃.txt`,如果位于子目录:例如`AutoFight/群友分享/胡桃.txt`则填写`群友分享/胡桃`)。
**温馨提示**:部分文件名含有.txt是不能使用的(不是指后缀),例如.txtaa.txt(或者aa.txt.txt)程序处理完之后会变成aa.txt,导致无法指向原有的文件 ~~但应该没人会用这种文件名~~
<br>
---
## ⏰ 时区设置
脚本会自动读取 BetterGI 的全局设置来判定今日素材。
请务必前往 **BetterGI设置 > 其他设置 > 服务器时区设置** 进行正确配置(如官服/亚服/B服设为 UTC+08:00)。
---
## ⚠️ 已知问题
暂无。
---
## ⚠️ 修改脚本
本脚本采用AI进行生成修改,修改者 **没有任何编程能力** 。
故在此授权任何人可以在不标注、不通知修改者(RJFAC)的情况下对脚本内容维护、修改、重写、分享、上传、覆盖此脚本的部分或全部内容。
* **注意事项**
* 修改脚本前请先进行 **备份**
* 修改脚本后请务必 **检查** 以下事项,再提交PR:
* 更新manifest.json中的version参数
* 在manifest.json中的authors栏位填上您的名字与github账户链接
* 更新README.md的更新日志栏位
* 在README.md关于作者栏位填上您的名字与github账户链接
* 掉落物名称统一使用最高稀有度(技能突破天赋书4星/武器突破素材5星)。
---
## 📜 更新日志
### v1.1.2 - [RJFAC](https://github.com/RJFAC)
* 修正「菫色之庭」异体字导致的传送问题
### v1.1.1 - [RJFAC](https://github.com/RJFAC)
* 新增支持7.0至冬版本
* 新增天赋技能材料秘境「荒坠的圣迹」与对应选项「「慈爱」的哲学」、「「坚忍」的哲学」、「「荣光」的哲学」
* 新增武器突破素材秘境「妄念的创痕」与对应选项「苍星军势的征服」、「藏窖灵浆的恣意」、「凛雪帝皇的辞决」
* 新增圣遗物秘境「逆悬的冰河」与对应选项「血红之证 / 炉火融炼之心」
* 说明文档更新
* 修正缺失璃月圣遗物秘境「山脊守望」与对应选项「苍白之火 / 千岩牢固」的问题
### v1.1.0 - [lingyu](https://github.com/aaahai00)
* 新增限时全开自动识别功能,通过OCR自动检测游戏内限时全开活动状态
* 新增"闲时刷取圣遗物"功能,当目标素材不在开放日且无活动时自动刷取圣遗物
* 修复战斗策略路径bug,支持子目录策略文件
* 优化战斗策略名称输入,自动处理路径分隔符和 `.txt` 后缀名 ~~(应该没有人用.txt作为文件名的一部分的吧)~~
* 优化配置界面布局
### v1.0.0 - [RJFAC](https://github.com/RJFAC)
* 新增BGI通知
* 新增月之七版本圣遗物秘境「山风的荆冕」
* 修正版本号以符合SemVer规范
### v0.10 - [RJFAC](https://github.com/RJFAC)
* 调整战斗策略设置方式
* 在显示日志中新增说明
* 说明文档排版
* 调试模式新增显示传入参数
### v0.8 - [风铃](https://github.com/zephyr-bell)
* 支持自定义战斗策略文件
---
## 👨‍💻 关于作者
* **原作者**: [huiyadanli](https://github.com/huiyadanli), iris, 霁
* **修改者**: [RJFAC](https://github.com/RJFAC), [风铃](https://github.com/zephyr-bell), [lingyu](https://github.com/aaahai00)
* **辅助生成**: AI