* 锄地添加新路线 * 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 内部锚点链接; - 保留“琪零”和“芽一”等原有名称。
23 KiB
锄地一条龙
一、功能与运行前提
本脚本用于在 BetterGI 中执行地图追踪路线,并提供路线选择、路径分组、物品拾取、物品黑名单、药品检测、晶蝶辅助传送、泥头车和运行记录等功能。
- 依赖 BetterGI 的 JavaScript 脚本、地图追踪、图像识别和实时触发器接口。
- 主要识别区域按照
1920×1080游戏窗口制作,其他分辨率未经过同等验证。 - 运行路线时需要使用当前 BetterGI 版本能够识别的地图追踪文件和战斗策略。
- 脚本通过 BetterGI 配置组启动,配置组中的队伍、战斗策略和其他功能可能影响运行结果。
- 图像识别效果可能受到窗口尺寸、缩放、HDR、滤镜、插帧和其他显示设置影响。
- 脚本不判断角色组合是否合理,也不会因为角色组合触发提示或终止运行。
validateTeamMembers仅用于确认用户指定的角色是否位于当前队伍中。
二、快速上手
正常模式
最简配置如下:
operationMode:运行锄地路线groupIndex:路径组一accountName:填写账户名称,单账户可使用默认值targetEliteNum:400targetMonsterNum:2000pickup_Mode:按需求选择模板匹配拾取、BGI 原版拾取或不拾取
需要脚本切换队伍时填写 partyName,否则留空。首次运行可以先选择“调试路线分配”查看路线分组,再选择“运行锄地路线”。
仅指定怪物模式
最简配置如下:
operationMode:启用仅指定怪物模式targetMonsters:填写目标怪物名称,多个名称使用中文逗号分隔partyName:按需填写队伍名称pickup_Mode:按需求选择拾取方式
该模式会在路线文件名和路线描述中匹配目标怪物,只运行匹配到的路线,不使用普通路线组合选择逻辑。
三、配队建议
以下仅作建议,并非强制要求,基于开发时的 BGI 与原神版本,随着版本更新可能过时,一切以用户实际运行情况为准。
盾奶位
可以考虑携带盾位和治疗位,以提高路线运行的稳定性。不建议同时携带两个盾位,双盾的盾量不会叠加。
自动索敌角色
可以考虑使用自动索敌,且无需位移或位移可控的角色:
- 芙宁娜:索敌距离 25 m。
- 爱可菲:索敌距离 15 m。
- 伊涅芙:索敌距离 10 m,双中心索敌。
- 莉奈娅:索敌距离 25 m。
- 玛薇卡:火环索敌距离 15 m。
- 桑多涅:BetterGI 本体自带特化,使用
charge命令即可直接锁头,但需要配合队友触发对应星烁状态。
拾取角色
包含精英的分组可以考虑携带万叶或琴以提高拾取率,相关分组说明见进阶使用技巧中的分组用途。
推荐配队
以下配队仅为主观推荐,具体以实际运行效果为准。
推荐配队组合与特点
茜芙爱万:茜特菈莉、芙宁娜、爱可菲、枫原万叶。可以稳定冻结,生存能力较高,且没有雷、火伤害不会转化蕈兽,但伤害可能较低。火芙盾万:玛薇卡、芙宁娜、茜特菈莉/尼可/伊涅芙、枫原万叶。火神数值较高且具备较强的跑图性能,可大幅缩减跑图时间;但缺少治疗位,可能降低稳定性。万芙莉机:枫原万叶、芙宁娜、莉奈娅、伊涅芙。月反应配队,新时代体系数值较高,且有稳定的盾奶。桑机爱万:桑多涅、伊涅芙、爱可菲、枫原万叶。木偶的可用配队之一,可以稳定触发星超导;木偶本身处理次数盾怪物具有一定优势。
四、进阶使用技巧
分组的用途
分组可以让不同路线使用不同的队伍、战斗策略、拾取设置或运行时段。路线总目标仍然只在路径组一的路线选择配置中设置,分组发生在路线组合选择之后。
示例:将 400 精英和 2000 小怪拆分运行
按每只精英 2% 概率掉落价值 2520 的四星狗粮、8% 概率掉落价值 1260 的三星狗粮计算,狗粮期望价值为:
0.02 × 2520 + 0.08 × 1260 = 151.2
因此,精英路线存在额外的狗粮收益。如有条件,精英路线尽量携带万叶或琴以拾取狗粮;实际效果与路线、队伍和战斗策略有关,以用户自己的运行体验为准。小怪路线没有上述狗粮额外收益,无需刻意拾取。
具体操作:
- 在路径组一配置组中填写
targetEliteNum=400、targetMonsterNum=2000,并设置accountName、优先关键词、排除关键词、排序和自动优化选项。 - 将
tagsForGroup2填写为小怪。脚本会把自动带有小怪标签的纯小怪路线分配到路径组二。 - 未命中路径组二至路径组十标签的路线进入路径组一。由于脚本不会自动添加通用“精英”标签,路径组一可能包含混合路线,应通过调试输出确认。
- 建立两个 BetterGI 配置组,分别将
groupIndex设置为“路径组一”和“路径组二”,并使用相同的accountName。两个配置组可以分别设置队伍、战斗策略、拾取方式和时间限制。 - 选择“调试路线分配”确认
group1和group2的路线及统计,再按需要运行两个路径组。多个路径组的执行顺序由 BetterGI 配置组或调度设置决定。
不要将总目标分别填写成路径组一的 400-0 和路径组二的 0-2000。这两个字段表示路线组合的整体目标,不是每个路径组的独立目标。
添加自定义路线
支持标准 BetterGI 地图追踪 JSON 格式。建议先使用 BetterGI 地图追踪编辑器录制或导出路线,再将文件放入 pathing/0-保留/ 或其子目录。路线文件的最小结构如下,positions 中的位置点应由地图追踪编辑器生成:
{
"info": {
"name": "自定义路线",
"type": "collect",
"version": "1.0",
"description": "路线信息:该路线预计用时60秒,预计收入0摩拉,包含以下怪物:4只精英传奇倍率三。",
"map_name": "Teyvat",
"bgi_version": "0.45.0",
"tags": []
},
"positions": [
{
"id": 1,
"x": 0,
"y": 0,
"action": "",
"action_params": "",
"move_mode": "walk",
"type": "teleport"
},
{
"id": 2,
"x": 10,
"y": 10,
"action": "",
"action_params": "",
"move_mode": "walk",
"type": "path"
}
]
}
脚本对路线文件的使用规则:
- 根对象需要包含
info和positions,位置点、移动模式、动作和动作参数应符合 BetterGI 地图追踪格式。路线能否正常执行仍由 BetterGI 版本和路线内容决定。 info.description中使用预计用时数字秒提供预计时长,例如预计用时60秒。- 怪物信息使用
包含以下怪物:数量只怪物名称、数量只怪物名称。,例如包含以下怪物:4只精英传奇倍率三。。怪物名称必须与assets/monsterInfo.json中的名称一致,否则不会计入路线的怪物数量和收益。 info.tags使用字符串数组填写标签,例如["水免", "高危"]。标签用于优先、排除和路径组分配;自定义标签也可以通过路径或描述中的文字参与匹配。info.map_name、info.map_match_method等地图字段会随路线传递给 BetterGI,建议保留编辑器导出的值。
添加后可以先使用“调试路线分配”确认路线是否被读取、统计和分组。
添加自定义模板图片
将 .png 文件放入 assets/targetItems/其他/保留/ 或其子目录。模板文件名会作为物品名称参与识别和拾取历史记录;文件名中的括号数值可用于设置模板匹配阈值。使用模板匹配拾取模式时,脚本会在启动阶段加载这些模板。
模板图片可以从以下来源获取:
- 自行截图:从游戏中的拾取列表截取物品名称区域,截图时应注意位置、大小和显示比例,尽量与运行时画面保持一致,并保存为
.png。 - 采集 cd 管理:从该脚本的
assets/targetItems/目录中获取需要的模板图片,再复制到本脚本的自定义模板目录。 - 获取最新模板:前往交流与相关项目中的 QQ 群
1109232869获取。
使用盗宝团好感任务补足小怪
盗宝团好感任务单次可以击杀 7 只小怪,相比常规小怪路线通常具有更高的单位任务效率。该任务最多可运行 50 次,共计 350 只小怪。
如果需要提高整体运行效率,可以在调度末尾添加一个战斗好感任务,并勾选“无经验和摩拉时提前结束”。同时将本脚本的目标设置为精英 400、小怪 1700,即 400-1700,把剩余的小怪目标交给好感任务完成。
五、配置项说明
配置项按功能分组列出,字段名称与 settings.json 一致。每项默认折叠,点击标题可查看详细说明。
执行设置
operationMode:执行模式
可选值:
运行锄地路线:按路线选择和路径组配置执行路线。调试路线分配:只进行路线选择和分组,并输出调试结果。强制刷新所有运行记录:重新初始化当前账户的路线记录,不执行路线。启用仅指定怪物模式:只运行名称或描述中包含目标怪物的路线。
groupIndex:执行的路径组
选择当前运行的路径组,范围为“路径组一”至“路径组十”。脚本每次启动只处理当前选择的路径组。使用路径组二至十时,路线选择配置从同账户的路径组一配置文件读取。
partyName:路径组使用的队伍
填写 BetterGI 中的队伍名称。脚本会在适用的执行模式下尝试切换到该队伍。留空时不执行指定队伍切换。
validateTeamMembers:队伍成员确认
填写需要确认的角色名称,多个角色使用中文逗号分隔。切换队伍后,脚本会确认这些角色是否存在;确认失败时会重新尝试切换,最多重试 3 次。留空时不执行角色成员确认。该配置不评价队伍组合是否合理。
sortMode:组内路线排序
可选值:
原文件顺序:按路线文件名顺序运行。效率降序:按脚本计算的路线效率排序。高收益优先:将带有高收益标记的路线排在前面。
默认值:高收益优先。
拾取设置
pickup_Mode:拾取模式
可选值:
模板匹配拾取,拾取狗粮和怪物材料:加载对应目录下的物品模板进行识别。模板匹配拾取,只拾取狗粮:只加载狗粮模板。bgi原版拾取:由 BetterGI 的AutoPick实时触发器处理。不拾取任何物品:不启动脚本模板拾取。
默认值:模板匹配拾取,拾取狗粮和怪物材料。
onlyRelatedItems:只识别路线相关材料
模板匹配拾取时,根据当前路线包含的怪物筛选怪物材料模板。只拾取狗粮模式没有可筛选的怪物材料;BGI 原版拾取和不拾取模式下该选项不生效。
默认值:关闭。
disableSecondCheck:关闭物品二次确认
关闭模板识别到物品后的二次确认。该设置可能改变误识别和漏识别的情况,具体效果取决于模板和当前画面。
默认值:关闭。
路线选择与分组设置
accountName:账户名称
用于区分 settings/、records/ 和 blacklists/ 中的账户数据。多账户运行时使用不同名称。路径组一配置会将路线选择相关参数保存到该账户的配置文件中,其他路径组读取同一账户的该文件。
默认值:默认账户。
tagsForGroup2 至 tagsForGroup10:路径组标签
这组配置项分别对应路径组二至路径组十:tagsForGroup2、tagsForGroup3、tagsForGroup4、tagsForGroup5、tagsForGroup6、tagsForGroup7、tagsForGroup8、tagsForGroup9、tagsForGroup10 依次对应路径组二至路径组十。每个配置项填写该路径组要匹配的标签,多个标签使用中文逗号分隔。
脚本按路径组编号从小到大的顺序匹配标签,一条路线命中多个路径组时分配到先匹配到的路径组。没有命中路径组二至路径组十标签的路线进入路径组一;路径组一没有单独的标签配置项,是默认兜底组。
targetEliteNum:精英怪总目标
路线组合使用的精英怪总目标。脚本内部会额外预留一定数量,用于降低漏怪对目标的影响。该目标是所有选中路线的整体目标,不是每个路径组单独的目标。
默认值:400。
targetMonsterNum:小怪总目标
路线组合使用的小怪总目标。脚本内部会额外预留一定数量,用于降低漏怪对目标的影响。该目标是所有选中路线的整体目标,不是每个路径组单独的目标。
默认值:2000。
priorityTags:优先关键词
包含关键词的路线会被优先保留。匹配范围包括路线文件路径、路线描述中的怪物名称和路线标签。多个关键词使用中文逗号分隔。
excludeTags:排除关键词
包含关键词的路线不参与路线选择。匹配范围包括路线文件路径、路线描述中的怪物名称和路线标签。多个关键词使用中文逗号分隔。
默认值:蕈兽,传奇,狭窄地形。
disableSelfOptimization:关闭自动优化
关闭根据历史运行记录调整路线预计用时的功能。关闭后主要使用路线文件中的预计用时。
默认值:关闭。
efficiencyIndex:摩拉与耗时权衡因数
填写 0 或更大的数字。数值越大,路线选择计算中对收益的权重越高,具体选路结果还取决于路线数据和目标数量。
默认值:0.25。
curiosityFactor:好奇系数
填写 0 到 1 之间的数值。缺少运行记录的路线会按该系数调整预计用时,以增加对未知路线的尝试。调整后显示的预计用时可能与实际用时不同。
默认值:0。
ignoreRate:忽略比例
填写大于等于 0 的数值后启用。普通怪物数量与精英怪物数量的比例超过该值,且路线不含受保护标签时,脚本会将该路线中的精英数量按 0 处理,使其按小怪路线参与选择。默认值 -1 表示关闭。
默认值:-1。
运行辅助设置
activeDumperMode:泥头车模式
填写需要提前释放元素战技的角色编号,多个编号使用中文逗号分隔。路线文件中包含 keypress(T) 时,该路线不启用泥头车逻辑。角色技能效果和路线结果取决于队伍及战斗环境。
eatBuff:路线间使用料理
填写料理名称,多个名称使用中文逗号分隔。脚本会在路线之间尝试使用料理,使用间隔为 300 秒。
detectRevival:复活料理检测次数
填写大于 0 的整数后启用复活料理检测。使用次数按分钟统计,检测到目标后还需要经过多次确认。
默认值:0。
detectHealthBar:回血料理检测次数
填写大于 0 的整数后启用血条检测和回血料理使用。使用次数按分钟统计,检测到目标后还需要经过多次确认。
默认值:0。
timeRule:不运行时段
支持 8、8-11、23:11-23:55 等格式,多个规则使用中文逗号分隔。单独填写 8 时表示从 8:00 到 9:00 前;含分钟时按实际时分计算。留空表示不设置时间限制。
findFInterval:拾取图标识别间隔
控制两次检测拾取交互图标之间的等待时间,单位为毫秒。脚本会将该值限制在可用范围内。
默认值:100。
pickupDelay:拾取后延时
控制识别并按键拾取后等待下一次识别的时间,单位为毫秒。
默认值:50。
rollingDelay:滚动后延时
控制拾取列表滚动后的等待时间,单位为毫秒。
默认值:32。
timeMove:滚动周期
控制拾取列表上下滚动的周期,单位为毫秒。
默认值:1000。
logMonsterCount:输出怪物数量日志
路线运行结束时输出脚本传入的精英和小怪数量,便于在日志分析中核对路线数据。
默认值:关闭。
disableAsync:禁用异步队伍切换
调整队伍切换相关操作的执行方式。该设置只影响适用执行模式下的队伍切换流程。
默认值:关闭。
enableCoordCheck:启用坐标校验
路线结束时执行坐标校验。该设置主要用于宿主没有返回路线结果的情况,也会增加路线结束阶段的处理时间。
默认值:关闭。
useCrystalflyCatcher:晶蝶辅助传送
填写晶蝶诱捕装置坐标,格式为 X,Y,使用中文逗号分隔。满足当前位置、路线起点和装置距离条件时,脚本会尝试打开地图并点击装置,然后传送到路线起点。
targetMonsters:仅指定怪物模式目标
仅在 operationMode=启用仅指定怪物模式 时使用。填写怪物名称,多个名称使用中文逗号分隔。脚本会在路线文件名和路线描述中进行包含匹配。
默认值:空。
六、脚本运行逻辑说明
启动和配置读取
脚本启动后读取当前配置。路径组一会将路线选择相关配置保存到 settings/{accountName}.json;其他路径组读取该账户已经保存的路线选择配置。之后脚本加载拾取模板、账户黑名单和运行记录,并根据执行模式进入对应流程。
路线选择和运行
正常模式会读取路线文件,解析预计用时、怪物数量、收益和标签,然后应用优先关键词、排除关键词、自动优化和路线组合算法。选中的路线按路径组标签分配,脚本每次只运行当前 groupIndex 对应的组。
仅指定怪物模式会直接在路线文件名和描述中匹配 targetMonsters,匹配到的路线进入路径组一。
路线结果处理
宿主返回包含布尔类型 success 的结果时,脚本直接使用该结果。宿主没有可用返回值且启用 enableCoordCheck 时,脚本读取路线起点和终点并执行坐标校验。
宿主没有返回值且关闭坐标校验时,脚本没有可靠手段确认路线是否成功,这是宿主能力限制。路线返回失败、坐标校验异常、未回到主界面或检测到重连界面时,不写入本次运行时长和路线 CD。
运行记录和数据文件
records/:保存账户对应的路线 CD、有效运行时长和模板匹配拾取历史。blacklists/:保存物品黑名单。settings/:保存路径组一的路线选择配置。调试结果/:保存路线分配调试输出。pathing/0-保留/:保存用户自定义路线。assets/targetItems/其他/保留/:保存用户自定义拾取模板。
运行记录默认保留最近 7 次有效运行时长,模板拾取历史默认保留最近 20 个去重后的物品名称。失败路线不会加入有效运行时长记录。
七、故障排查
路线没有被选中
检查路线是否被 excludeTags 排除、是否命中路线组合目标、是否属于当前路径组,以及路线描述是否包含可解析的预计用时和怪物数量。
调试路线输出包含旧文件
由于 BetterGI 暂未向 JS 脚本提供删除文件的接口,执行“调试路线分配”时,调试结果/group1 至 调试结果/group10 中原有的路线文件不会被自动清除。因此,输出文件夹中可能同时存在本次结果和历史结果。
判断路线分配时应以 调试结果/路线分配结果.txt 中的路线清单和统计为准。建议每次重新调试前,先手动清空对应的 group1 至 group10 文件夹,再运行调试模式。
拾取没有生效
检查拾取模式、模板目录、物品黑名单和游戏窗口尺寸。模板匹配模式需要有效模板;BGI 原版拾取依赖宿主的 AutoPick 实时触发器。
路线记录没有更新
检查宿主是否返回 success,或是否开启坐标校验。路线失败、未回到主界面、坐标异常和重连状态都会跳过记录更新。
晶蝶辅助传送没有触发
检查坐标格式、地图坐标、路线文件中的起点坐标以及晶蝶装置是否位于识别范围内。该功能只在当前位置与装置位置满足距离条件时触发。
队伍切换失败
检查 partyName 是否对应 BetterGI 中的队伍名称。填写 validateTeamMembers 后,脚本还会确认指定角色是否存在;未填写时不会进行角色成员确认。
八、交流与相关项目
- QQ 群:1109232869。
- 茶包版 BetterGI 包含独立的联机锄地逻辑,可在上述群聊中了解相关信息。
- 相关工具包括:锄地一条龙、AAA 狗粮批发、AAA 狗粮联机团购、采集 CD 管理、锁定四星教官、只要大瓶、妙妙小工具、性能测试和食材加工极速版。
- 使用过程中可以通过上述群聊反馈问题和交流配置经验。