bettergi-scripts-list/repo/js/营养袋吃药统计/README.md
2026-09-17 13:10:09 +08:00

115 lines
No EOL
6.8 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.

### 药品消耗统计脚本使用说明
## 📋 一、使用方法
本脚本需在锄地一条龙流程前后各运行一次(前置=记录药品初始数量,后置=对比统计消耗),开启通知后即可收到药品消耗情况推送。支持两种接入方式:
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. 增加筛选药品选项