mirror of
https://github.com/babalae/bettergi-scripts-list.git
synced 2026-11-17 04:17:45 +00:00
115 lines
No EOL
6.8 KiB
Markdown
115 lines
No EOL
6.8 KiB
Markdown
### 药品消耗统计脚本使用说明
|
||
## 📋 一、使用方法
|
||
本脚本需在锄地一条龙流程前后各运行一次(前置=记录药品初始数量,后置=对比统计消耗),开启通知后即可收到药品消耗情况推送。支持两种接入方式:
|
||
1. **直接添加脚本**:在锄地一条龙JS的前置/后置任务中分别添加本脚本
|
||
2. **配置组方式**:新建两个配置组并添加本脚本,在一条龙中分别添加前后两个配置组
|
||
|
||
## 🛠️ 二、环境与工具要求
|
||
### 工具要求
|
||
BGI支持两种自动吃药方案:
|
||
- **茶包版BGI**(可选):公版BGI默认关闭自动吃药功能且无法通过脚本开启,茶包版BGI可开启此功能
|
||
- **锄地一条龙js**(推荐):在锄地一条龙js设置中填写「使用复活药数量」和「使用回血药数量」,即可开启自动吃药功能
|
||
|
||
### 系统配置要求
|
||
1. **游戏分辨率**:固定1920×1080(不可修改,影响OCR识别区域定位)
|
||
2. **游戏和js设置**:
|
||
- 需装备「便携营养袋」
|
||
- 启用「筛选模式」和「综合模式」时需要填写完整的药名
|
||
|
||
## 📥 三、获取茶包版BGI
|
||
1. 仓库地址:[https://github.com/kaedelcb/better-genshin-impact](https://github.com/kaedelcb/better-genshin-impact)
|
||
2. 下载方式:登录GitHub账户 → 进入Actions页面 → 下载workflow产物
|
||
3. Actions链接:[https://github.com/kaedelcb/better-genshin-impact/actions](https://github.com/kaedelcb/better-genshin-impact/actions)
|
||
|
||
## ⚙️ 四、参数配置说明
|
||
| 参数项 | 类型 | 填写要求 | 默认值 | 核心说明 |
|
||
|--------|------|----------|--------|----------|
|
||
| **runMode** | 下拉选择 | 三选一:「营养袋模式」/「筛选模式」/「综合模式」 | 营养袋模式 | 营养袋模式:读取便携营养袋内药品;筛选模式:通过背包筛选搜索药品;综合模式:营养袋模式+筛选模式结合 |
|
||
| **initSelect** | 复选框 | 仅初始化/重置时临时勾选 | false | 勾选后运行脚本会删除当日同名记录,重新初始化数据(使用后务必取消) |
|
||
| **userName** | 文本输入 | 1-20字符,仅支持中英文、数字 | 默认账户 | 多账户区分核心,违规名称自动替换为默认账户 |
|
||
| **refreshTime** | 文本输入 | 0-24之间,支持一位小数 | 4.0 | 自定义每日统计周期分界点(如4.5=4:30),错误值自动修正为4.0 |
|
||
| **loadDelay** | 文本输入 | 非负整数(单位:毫秒) | 800 | 界面打开/切换的等待延迟,低配置设备可适当增大 |
|
||
| **stepDelay** | 文本输入 | 非负整数(单位:毫秒) | 500 | OCR识别/输入药名前的短暂等待,保证识别稳定性 |
|
||
| **autoRefillRecovery** | 复选框 | 自动补充回血药开关 | false | 开启后当回血药数量低于阈值时,自动前往烹饪锅制作回血药 |
|
||
| **refillThreshold** | 文本输入 | 正整数 | 100 | 回血药数量阈值,低于此值时触发自动补充 |
|
||
| **refillCount** | 文本输入 | 正整数 | 20 | 自动补充回血药的数量(1-99之间) |
|
||
|
||
### 配置优先级
|
||
脚本运行时参数读取规则:`自定义配置 > 默认值`,参数错误时自动兜底为默认值并输出警告日志。
|
||
|
||
## 🔄 五、操作流程(适配双模式)
|
||
### 场景一:首次使用
|
||
1. 启用筛选模式需要完成参数配置(填写药品名称),启用营养袋模式则需要营养袋装备两种药品
|
||
2. 确认游戏分辨率1920×1080,便携营养袋已装备
|
||
3. 运行脚本,自动执行:
|
||
- 校验账户名合法性 → 打开背包 → 按选定模式识别药品数量
|
||
- 在`assets/`目录生成「账户名.txt」记录文件
|
||
4. 收到「今日初始化完成」通知,首次配置完成
|
||
|
||
### 场景二:日常使用
|
||
#### 营养袋模式
|
||
- 脚本自动打开背包→进入小道具→读取便携营养袋内回血/复活药数量
|
||
- 无需手动筛选,识别速度更快,依赖便携营养袋装备状态
|
||
|
||
#### 筛选模式
|
||
- 脚本自动打开背包→进入食物分类→筛选搜索指定药品→读取数量
|
||
- 无需装备营养袋,适配未配置营养袋的场景,识别流程稍长
|
||
- 处理所有填写了名称的药品(回血/复活/攻击/防御/其他/增伤/抗性/额外,共8种)
|
||
|
||
#### 综合模式
|
||
- 脚本自动执行:营养袋模式识别回血/复活药 + 筛选模式识别攻击/防御/其他/增伤/抗性/额外药
|
||
- 结合两种模式优势,支持全类型药品统计
|
||
- 回血药和复活药通过营养袋模式获取,攻击药、防御药、其他药、增伤药、抗性药、额外药通过筛选模式获取
|
||
|
||
#### 通用规则
|
||
- 每日首次运行(自定义refreshTime后):记录为当日初始值
|
||
- 后续运行:对比初始值计算消耗/新增(正数=消耗,负数=新增)
|
||
- 每次运行自动保存记录,仅保留30天内数据,过期自动清理
|
||
- 只记录数量大于0的药品数据
|
||
|
||
### 自动烹饪功能
|
||
当开启「自动补充回血药」功能后,脚本会在检测到回血药数量低于阈值时,同时有消耗数量,自动制作回血药:
|
||
- **触发条件**:`autoRefillRecovery`开启 且 回血药数量 < `refillThreshold`
|
||
- **执行流程**:前往蒙德炉子 → 打开烹饪锅 → 搜索并制作指定的回血药
|
||
- **制作数量**:每次自动制作 `refillCount` 个回血药
|
||
- **适用场景**:适用于一天只运行两次JS的情况(如早晚各一次),多次运行不推荐开启此功能,避免记录错误
|
||
- **注意事项**:
|
||
- 复活药等其他药品暂不支持自动补充
|
||
- 回血药需要解锁自动烹饪功能,否则无法自动补充
|
||
|
||
### 场景三:更换药品/重置统计数据
|
||
1. 在设置中勾选`initSelect`选项
|
||
2. 确认药品名称已更新为新名称(如需更换)
|
||
3. 运行脚本一次,收到「强制初始化完成」通知
|
||
4. **立即取消`initSelect`勾选**(避免后续运行重复初始化)
|
||
|
||
## 📊 六、核心机制(新增/补充)
|
||
### 1. 自定义统计周期计算规则
|
||
以`refreshTime`为分界点,脚本自动判定统计范围:
|
||
- 当前时间 < 当日refreshTime:统计「昨日refreshTime → 今日refreshTime」数据
|
||
- 当前时间 ≥ 当日refreshTime:统计「今日refreshTime → 明日refreshTime」数据
|
||
示例:refreshTime=4.5(4:30),当前时间3:00 → 统计昨天4:30至今;当前时间5:00 → 统计今天4:30起。
|
||
|
||
### 2. 记录文件格式
|
||
```
|
||
时间:202X/XX/XX XX:XX:XX-【药品名称】-【数量】
|
||
时间:202X/XX/XX XX:XX:XX-【药品名称】-【数量】
|
||
...
|
||
```
|
||
每条记录包含时间戳+药品名+数量,支持8种药品类型:
|
||
- 回血药
|
||
- 复活药
|
||
- 攻击药
|
||
- 防御药
|
||
- 其他药
|
||
- 增伤药
|
||
- 抗性药
|
||
- 额外药
|
||
|
||
**注意**:只生成数量大于0的药品记录,保证数据有效性。
|
||
|
||
## 📝 九、更新日志
|
||
|
||
### 2026-09-17
|
||
1. 修改了一下ocr范围
|
||
2. 增加筛选药品选项 |