bettergi-scripts-list/repo/js/采集cd管理/README.md
汐 0c970be672
重构锄地与狗粮脚本并完善配置文档 (#3603)
* 锄地添加新路线

* 1

* 1

* 2

* Update settings.json

* Update manifest.json

* 3

* 重构锄地与狗粮脚本并完善配置文档

PR 描述
变更概述
本 PR 主要涉及 AutoHoeingOneDragon 和 AAA-Artifacts-Bulk-Supply 两个 JS 脚本,包含运行逻辑修复、代码结构整理、配置项调整及 README 重写。
AutoHoeingOneDragon
- 重排 main.js 代码结构,按功能集中声明全局变量、常量和识别对象。
- 提取屏幕区域、识别阈值、延时、冷却时间和记录数量等常量。
- 修复 disableAsync 在非运行模式下错误等待不存在队伍切换任务的问题。
- 移除配队合理性校验及其强制终止逻辑,保留指定角色成员确认功能。
- 修复首次运行时拾取历史 items 未初始化的问题。
- 修复药品监控逻辑:
  - 识别到目标时确认计数增加;
  - 未识别到目标时确认计数减少;
  - 达到阈值后使用料理并清零;
  - 使用次数按分钟窗口重置;
  - 药品配置统一转换为非负整数,避免默认字符串 "0" 启动无效监控。
- 增加自定义路线逐文件读取和解析容错,损坏路线会记录错误并跳过。
- 调整路线组合迭代条件、目标余量、迭代上限和路线剔除逻辑。
- 修复路线结果判定和运行记录写入时机:
  - 优先使用宿主返回的 success;
  - 无返回值时按配置决定是否执行坐标校验;
  - 失败路线不更新 CD、不写入运行时长。
- 优化晶蝶辅助传送和坐标缓存逻辑。
- 修复非模板拾取模式下 onlyRelatedItems 遍历 null 的问题。
- 增加截图缓存上限、并发控制和旧截图释放逻辑。
- 修复模板匹配区域的资源释放和隐式全局变量问题。
- 删除无效变量、遗留代码和旧拾取历史注释代码。
- 修复单独填写小时限制时 8:59 无法匹配的问题。
- 统一处理路线标签、优先关键词和排除关键词中的空白字符。
AutoHoeingOneDragon 配置与文档
- 调整 settings.json 配置项顺序:
  - disableAsync 放入队伍相关配置;
  - logMonsterCount 放入运行辅助配置;
  - 自动优化配置放到目标数量及优先/排除关键词之后;
  - 路径组 5-10 配置保留在后部;
  - 移除 skipCheck 配置项。
- 重写 README,重新划分为功能与前提、快速上手、配队建议、进阶技巧、配置说明、运行逻辑、故障排查和交流等章节。
- 删除攻击性、嘲讽性、命令式及绝对化内容。
- 保留 QQ 群 1109232869 和相关项目介绍。
- 增加正常模式及仅指定怪物模式的最简配置。
- 增加配队建议、路线分组示例、精英路线狗粮收益说明和盗宝团好感任务使用方法。
- 增加 BetterGI 地图追踪 JSON 格式、自定义路线和自定义模板图片说明。
- 使用 <details> 折叠详细配置说明。
- 增加调试路线输出不会自动清除旧文件的故障排查说明。
- 增加宿主返回值、坐标校验和运行记录处理逻辑说明。
AAA-Artifacts-Bulk-Supply
- 修复非法账户名回退逻辑,统一使用回退后的有效账户名读写记录和 CD 数据。
- 可选路线目录不存在时直接跳过,避免产生无意义的异常日志。
- 将“只激活收尾和额外路线,不执行”改名为“联机收尾模式”,并同步调整配置说明。
- 重写并扩展 README:
  - 增加快速开始和运行前提;
  - 增加稳定、急速、联机三种配置说明;
  - 增加配置格式限制;
  - 补充调查点收益、刷新机制、路线结构和运行时间线;
  - 修正 README 内部锚点链接;
  - 保留“琪零”和“芽一”等原有名称。
2026-09-02 21:26:12 +08:00

264 lines
11 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.

**采集CD管理**
---
### 一、**📌 脚本定位**
1. 这是一个自动帮你管理"采集路线冷却时间(CD)"的工具。
2. 它会按你设定的顺序,自动运行不同采集路线(比如挖矿、采特产),并跳过还没刷新的路线。
3. 使用模板匹配拾取,功耗低,不易误触调查点,自带背包满识别并与采集联动(满背包材料加入黑名单并不计入路线效率计算)。
---
### 二、**🚀 快速上手**
<details>
<summary><b>1. 准备路线文件</b></summary>
- 前往脚本仓库订阅需要的地图追踪,打开bgi文件夹,User/AutoPathing文件夹下就是你订阅的地图追踪(食材采集推荐使用食材栏目下的提瓦特食材一条龙,内置部分路线信息)。
</details>
<details>
<summary><b>2. 极简模式</b></summary>
最简单的使用方式,将你需要的地图追踪文件全部复制到js文件夹(User/JsScript/采集cd管理)下的pathing中,无需考虑子文件夹层数,塞进去即可,也可尝试使用mklink等自动关联。
- 将js添加至配置组,右键js选择自定义配置,勾选仅刷新自定义配置,路径组数量填0,直接运行一次js
- 找到优先采集材料,按要求填写每天需要采集的材料和数量
- 根据材料和路径特点,配置合适的队伍并将队伍名称填写在自定义配置中的优先采集材料使用的配队名称
- 启动js,将自动寻找相关路径,采够需要的材料或所有相关路线都被使用后js将终止
- 填写的优先采集材料是每日(以四点为界)的数量,长期运行时,js会记录各个路线获取的数量与耗时,并据此优化,先选择效率更高的路线
- 特别的,锻造矿指代任意的水晶块,紫晶块,萃凝晶,虹滴晶,填写锻造矿*160即可满足每日锻造需求
- 循环模式提供“不循环 / 每組重试 / 全局循环”三种选项
| 模式 | 执行逻辑 |
| :--- | :--- |
| 不循环 | 顺序遍历所有路径组,每个路线只跑一次,不重试 |
| 每组重试 | 每组内反复循环,直到该组所有路线都跑满2次或都在CD中,才进入下一组 |
| 全局循环 | 每次执行完一条路线后立即跳回第一组第一个重新扫描,优先执行未满3次的靠前路线,直到所有路线都满3次或全部CD |
**详细示例**
假设有 A(A1~A3)、B(B1~B3)两组,所有路线CD就绪:
- **不循环**:A1, A2, A3, B1, B2, B3(结束)
- **每组重试**:A1, A2, A3, A1, A2, A3, B1, B2, B3, B1, B2, B3(结束)
- **全局循环**:A1, A1, A1, A2, A2, A2, A3, A3, A3, B1, B1, B1, B2, B2, B2, B3, B3, B3(结束)
> 实际运行中,若某路线处于CD中,则会跳过,不影响总体逻辑。执行次数与CD状态共同决定路线是否运行。
</details>
<details>
<summary><b>3. 更进一步</b></summary>
- 一个配队不能搞定所有的采集路线怎么办,是时候启用路径组了
- 路径组的作用是将路线分组运行,分出不同的优先级和配队
- 在pathing文件夹中,将路线分到不同的文件夹,第一层的每个文件夹都可供路径组选择
- 勾选仅刷新自定义配置,路径组数量填你需要的数量,直接运行一次js
- 再次打开自定义配置,为每个路径组选择对应的文件夹和使用的配队,并按要求配置其他项目
- 此外,优先采集执行时也会优先使用路径组指定的配置,因此你完全可以路径组配置后不用,只用来指定配队,临界效率填个100即可在事实上禁用该路径组的正常运行
- 正常使用路径组时,将会依次执行各个路径组,前一个路径组所有路线都未刷新或低于临界效率等不可用时,将会进入下一个路径组
- 定时终止:按要求填写定时终止,js将提前结束采集并等待到预定时间,可用于卡4点
- 不同配置组并不共用配置与路径组信息,只会根据账户名共用cd信息,因此你可以在不同的配置组中使用本js,设置不同的多个路径组与终止时间,实现合理分配采集时间
- cd类型可参考js文件夹中的表格
- “每天一次”模式(04:00–16:00采集次日04:00刷新,其余时段12小时刷新)。
</details>
<details>
<summary><b>4. 采集队伍推荐</b></summary>
根据自己想采集的物品(部分路线强制需要某些角色)进行配队。
- 当需要采集禽肉/兽肉等时,最好携带:绮良良等天赋不会惊动肉类动物的角色
- 当需要采集晶蝶/螃蟹/青蛙等,最好携带:早柚等天赋不会惊动其他动物的角色
- (详情请搜索B站/米游社攻略,或自行查阅角色天赋与游戏图鉴)
- 当采集绯樱绣球/琉鳞石时,必须携带雷系角色,推荐雷法:丽莎/八重神子等(选择一个即可)
- 采集路线有明确指定的角色也必须携带(例如路线中指定了"草神")
- 推荐携带一个血牛迪希雅,路径追踪行走位设置迪希雅,不容易在采集途中死亡。
- 更多详细对应采集角色请参考路线的readme,或询问群友。
**示例:**
- 队伍名称:迪希雅+八重神子+草神+琴
- 文件夹名称:特产1
- 该组可以采集:电气水晶/冰雾花,绯樱绣球/琉鳞石,路线中指定需要草神采集的,蒲公英,以及其他所有无指定的采集。
⚠️ **注意**:请注意区分物品CD时间,例如上述冰雾花刷新时间与其他区域特产CD不同,尽量不要放在同一个分组,具体刷新时间请参考本脚本自带的Excel。
</details>
---
### 三、**📁 文件结构**
- main.js:主程序。
- settings.json:用于展示配置组的自定义配置面板,不影响使用。
- pathing/ 文件夹:存放地图追踪文件。
- blacklists/ 文件夹:保存各个账户名的黑名单物品信息,可以在这里手动编辑,注意需要符合json格式
- record/ 文件夹:保存各个账户名的运行记录与cd信息
---
### 四、**⚙️ 其他说明**
1. **伪造日志**(不影响游戏)
- 生成的日志可以被日志分析识别,方便查看路线运行情况。
2. **跳过路线运行后的坐标校验**
- 勾选后,部分劣质路线,或因意外导致的卡死也将强制记录CD,可避免重跑。
3. **食材加工**
- 支持运行途中定时加工食材如面粉等,参考自定义配置使用
4. **自动处理异常状态**
- 运行过程中若角色被冰冻,脚本会自动尝试挣脱;若角色死亡,会自动点击复苏按钮,确保采集流程不中断。
---
### 五、**📞 联系方式**
- **QQ群**:1109232869(备用群1022240522)
- 测测莫酱(有其他问题也行)
- 不接受github渠道的问题反馈,只接受加群处理
---
### 六、**📋 Schedule 执行**
<details>
<summary>点击查看详情</summary>
#### 功能说明
采集cd管理支持执行 schedule 文件,可以将多个地图追踪或js脚本按顺序执行。
#### 文件格式
```json
{
"schedule": [
{ "action": "start", "task": "任务名", "count": 1 },
{ "action": "wait", "task": "任务名" }
],
"tasks": [
{
"name": "任务名",
"type": "autopathing",
"filePath": "路径/地图追踪.json"
}
]
}
```
#### schedule 数组
定义任务执行顺序:
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | string | 是 | 动作类型:`start` 或 `wait` |
| `task` | string | 是 | 任务名称,对应 tasks 中的 name |
| `count` | number | 否 | 执行次数,仅 start 有效,默认 1 |
**action 类型:**
- `start`: 启动任务,任务是否异步等待由 tasks 中 `async` 字段控制(默认 false,同步等待完成)
- `wait`: 等待异步任务完成
#### tasks 数组
定义所有可用的任务:
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `name` | string | 是 | 任务名称,唯一标识 |
| `type` | string | 是 | 任务类型 |
| `filePath` | string | 是 | 文件路径,相对于采集cd管理目录 |
| `settings` | object | 否 | 传递给任务的配置参数(仅 js 类型有效,传入脚本入口函数) |
| `async` | boolean | 否 | 是否异步执行,默认 false。设为 true 后 start 不等待完成,需搭配 schedule 中的 `wait` action |
**type 类型(大小写不敏感):**
| 值 | 说明 | filePath 示例 |
|------|------|------|
| `autopathing` | 地图追踪 | `pathing/挖矿/水晶矿.json` |
| `js` | 子脚本 | `subJs/脚本文件夹/` |
| `keymousescript` | 键鼠脚本 | `assets/滚轮下翻.json` |
#### 示例
```json
{
"schedule": [
{ "action": "start", "task": "采集任务" },
{ "action": "start", "task": "锄地任务" }
],
"tasks": [
{
"name": "采集任务",
"type": "autopathing",
"filePath": "pathing/水晶矿.json"
},
{
"name": "锄地任务",
"type": "js",
"filePath": "subJs/AutoHoeingOneDragon/",
"settings": {}
}
]
}
```
#### 注意事项
1. **路径格式**:`filePath` 路径使用正斜杠 `/`
2. **识别逻辑**:读取 JSON 文件后,如果包含 `schedule` 和 `tasks` 字段,则视为 schedule 文件执行
3. **拾取支持**:执行 schedule 期间会全程执行模板匹配交互和拾取
4. **settings 格式**:`settings` 对象格式与配置组文件中相同,建议在配置组中配好子 js 的自定义配置后,复制配置组中的部分
</details>
---
### 七、**📦 莫酱全家桶(部分)**
- 日常使用
- 锄地一条龙:一站式解决自动化锄地,支持只拾取狗粮
- AAA狗粮批发:自动卡时间拿狗粮,收益最大化
- AAA狗粮联机团购:联机获取更多狗粮收益
- 采集cd管理:管理采集路线并自动优化
- 锁定四星教官:锁定四星教官,支持筛选只要初始3和只要带充能
- 只要大瓶:尽可能将狗粮分解成大瓶,起个好看的作用
- 妙妙小工具
- 性能测试:测测你的电脑性能
- 食材加工极速版:与采集cd管理中相同的食材加工
- 更多妙妙小工具可以加群获取
---
### 八、**📋 更新日志**
<details>
<summary>点击查看历史更新</summary>
#### 2026/08/01
1.修正循环模式"每组重试"邏輯
#### 2026/08/01
1. 自动处理冰冻与复苏,提升长时间运行稳定性。
2. 兼容化种匣名称识别,减少漏捡。
3. 新增“每天一次”CD刷新模式,灵活适应不同采集时段。
4. 循环模式升级为下拉菜单,支持“每组重试”和“全局循环”。
5. 终点坐标校验适配 SIFT 路径,支持自定义地图匹配方法。
6. 补充“刷新自定义配置”的日志反馈,便于确认操作。
#### 2026/2/28
1. 重构代码结构
#### 2026/2/26
1. 无f时滚轮改为仅在识别到滚轮图标时触发
#### 2026/2/18
1. 对食材加工过程中可能出现的道具数量超过上限进行处理
#### 2026/2/17
1. 增加通知优先采集阶段和路径组切换
2. 优化部分日志和展示的自定义配置
3. 更新日志回归
</details>