bettergi-scripts-list/repo/js/AutoHoeingOneDragon/README.md

**重要免责声明：**

1. **使用风险：**
   1. 本脚本为开源学习项目，禁止用于商业用途或违反游戏条款的行为。
   2. 滥用可能导致游戏账号封禁，开发者不承担任何直接或间接责任。

2. **责任限制：**
   1. 本脚本按“现状”提供，不承诺兼容性、安全性或功能完整性。
   2. 因使用本脚本导致的账号、数据、设备损失，开发者概不负责。

3. **禁止条款：**
   1. 严禁逆向工程、恶意篡改或用于外挂等非法用途。
   2. 如游戏运营商提出要求，开发者保留随时停止维护的权利。

使用即表示您已阅读并同意上述条款。

---
(简易配置描述部分)

### 一、**快速使用指南 ✅**

1. 添加脚本
在 BGI 配置组中点击 +添加 → 选择 “锄地一条龙”脚本。

2. 配置组设置（⚙️）
   - ⚠️ 关键设置，请务必检查！
   - 切换队伍：❌ 关闭（配队请在脚本自定义配置中填写）
   - 战斗策略：推荐使用万能策略，不在万能策略中的角色不建议使用
   - 自动拾取掉落物：❌ 强烈建议关闭（易卡死、拖慢速度）
   - 自动检测战斗结束：✅ 开启，延时设为 0.35-0.5秒（默认1.5秒太慢）
   - 战斗结束后执行万叶长E：✅ 强烈建议开启（大幅提升狗粮收益），如果你觉得慢，你打280精英然后把捡的狗粮摧毁，和打400不捡狗粮的收益时一样的
   - 战斗超时：小怪路线建议 ≤60秒；练度低可适当延长
   - 不在某时执行：⚠️ 无法中断运行，不要依赖此功能定时停止
   - 生存位、行走位：生存位不建议开启，行走位建议根据设备情况决定，设备情况良好可以使用高移速体型或角色提速，如成男或哥伦比娅，设备较差经常跑过头等时，建议使用移速较慢的体型或角色，与此同时，选择生命上限较高的角色和韧性较高的角色（如大剑>单手剑）有助于提高稳定性。
   - 其余选项如果你不确定其作用建议保持默认状态，或询问群友等

3. 脚本自定义配置（右键脚本 → 修改配置）
   - **正常以摩拉为目的的锄地**：
   - 🔹 第一部分：执行设置
   - - 执行模式：默认选 “运行锄地路线”
   - - 路径组编号：支持分组运行（如组1打精英，组2刷小怪），需为每组单独创建配置组
   - - 配队名称：填写该组使用的队伍名（脚本会自动切换）
   - - 拾取模式：✅ 推荐“模板匹配拾取”根据需求选择拾取狗粮或狗粮与怪物材料；❌ 不推荐“BGI原版拾取”或“不拾取”
   - - 泥头车模式：可提前开E的角色：芙宁娜、爱可菲（泥头车模式请填写角色在队伍里对应序号）；❌ 不建议盾角或纳塔角色

   - 🔹 第二部分：路线选择（仅路径组1生效！）

   - - 请正确设置路径组1的设置，其他组会自动读取组1的配置，无需重复设置❗❗❗

   - - 账户名称：多账号用户填写不同名字以区分记录
   - - 标签系统（中文逗号分隔）：
   - - 蕈兽：建议排除（雷火会转化，白占名额）
   - - 小怪：适合练级队，且无需携带万叶拾取狗粮
   - - 水免 / 次数盾 / 高危 / 传奇：根据队伍强度选择是否排除
   - - ⚠️路径一排除关键词仅针对路径一（如需在所有路径排除，请下滑到“排除关键词”并正确填写）
   - - 目标数量：精英怪建议 400，小怪建议 2000（均为游戏上限）
   - - 优先关键词：如 600,丘丘王（优先刷高收益怪）
   - - ⚠️优先关键词≠锄地顺序优先，优先关键词代表无视该路线效率，优先加入。
   - - 排除关键词：如 纳塔,雪山（跳过不想打的区域，亦可输入不想打的怪物名称）
   - - ⚠️排除关键词对所有路径组生效。

   - - ❗❗❗关于路径组，可使用一个路径组打完所有怪物，亦可拆分，以不同队伍应对不同的怪物❗❗❗
   - - ⚠️请注意：若拆分多个路径组，后续路径组均从前面路进组筛选后的路径中筛选
   - **极简版，以怪物材料为目的**：
   - - 执行模式：选 “仅指定怪物模式”
   - - 同上进行配置组设置
   - - 自定义配置拉到最下面，按要求填写需要的怪物名称

4. 分组运行示例：
   - 路径组1排除标签：传奇，小怪，蕈兽（路径组一由于排除传奇与小怪，会执行精英路线，但精英路线会包含一部分小怪且无法避免）

   - 路径组2选择标签：旧日之海龙蜥（由于该怪物带有传奇标签，被路径一排除，所以路径二可以选择）

   - 路径组3选择标签：传奇（由于路径二已经筛选了旧日之海龙蜥，所以路径三将执行除该传奇以外的传奇路径）

   - 路径组4选择标签：小怪（执行剩余小怪路线）

   - ❗❗❗所有关键词均根据自己需求填写，然后执行一次路径调试输出，查看锄地一条龙目录下“调试结果”验证是否正确。
   - ❗❗❗若拆分路径需要添加对应的配置组，在每个配置组中的JS中选择需要运行的路径组。（在一条龙中执行顺序无要求，确保运行过路径一配置组生成正确的配置文件）
   - ❗❗❗部分路线可能因为效率过低不入选，请在优先关键词添加正确关键词；如部分路线经常出现问题，可以在排除关键词排除，并向作者提交详细问题说明。

5. 其他建议
   - 游戏分辨率：仅支持 1080p + 60帧，其他情况能够使用纯属巧合
   - 时间格式：建议使用 24小时制
   - 自定义拾取：将想捡的物品图（**.PNG）放入 assets/targetItems/其他/保留/，更新不会覆盖
   - 自定义路线：将自己想要额外添加的路线（**.json）放入 pathing/0-保留，更新不会覆盖


### 二、**收益说明 💰**

   - 精英怪
   - - 收益：200～600 摩拉 + 狗粮（概率，平均每只150狗粮经验值）+ 60经验
   - - 上限：400 只
   - 小怪
   - - 收益：32～49 摩拉 （部分怪物为1.5倍，2倍，3倍）+ 20经验
   - - 不掉落狗粮
   - - 上限：2000 只
   - 地方传奇
   - - 收益：占用多个精英（或小怪），不同类型掉落有所差异
   - - 上限：与精英（或小怪）同享上限
   - - 备注：队伍强度足够时建议打传奇增加收益。

   - ✅ 默认配置收益：约 23.5万摩拉 + 5.5万狗粮经验
   - ❗ 超出上限后不再获得任何奖励！


### 三、**拾取机制优势 🎒**

   - 智能识别 狗粮 + 怪物材料，自动跳过背包已满的物品
   - 黑名单独立存储（blacklists/ 文件夹），可手动编辑，请确保符合json格式要求
   - 支持自定义保留物品（见上文）

### 四、推荐配队思路👥 
   - BGI 不智能！配队不合理 = 卡死 / 打不过 / 捡不到狗粮！
   - 必备角色类型：
   - 抗打断：茜特菈莉、伊涅芙、莱伊拉、迪希雅
   - 召唤输出：✅ 芙宁娜（首选）、爱可菲（次选）
   - 治疗：白术、希格雯、芭芭拉、夏沃蕾
   - 辅助（可选）：万叶（聚怪+捡狗粮）、玛薇卡、那维莱特
   - 避雷配队：
   -  - ❌ 四神队（无奶、钟离柱子卡路、雷草神混子）
   -  - ❌ 无召唤物队伍（效率极低）
   -  - ❌ 不带万叶打精英（每天少捡6万狗粮！）
   -  - ❌ 夜兰/克洛琳德等位移大角色（易跑飞卡死）
   -  - ⚠️ 脚本内置配队校验，若无法通过校验可启用跳过验证，若跳过警告导致问题，责任自负。

### 五、具体配置说明
1. 第一部分：路径组运行配置：该部分将决定当前路径组的具体执行参数
   - **执行模式：** 
   - - 默认选择 **运行锄地路线** ，选择该模式会按照后续设置选择并运行相应路线
   - - 选项 **输出地图追踪文件** ，会将选择的路线读取并分组输出到js文件夹下pathingOut文件夹
   - - 选项 **强制刷新所有运行记录** ，用于清除js记录的运行历史
   - - 选项 **启用仅指定怪物模式** ，适用于轻度、以特定怪物材料为目的的用户，选择该模式后拉到自定义配置最下面，按要求填写需要的怪物
   - **选择执行第几个路径组：** 本js支持分组运行地图追踪，分组方式详见后续选项，需要分组运行时请确保精英目标数量，小怪目标数量，各个路径组的标签等信息【完全相同】，复制配置组时未知原因无法正确复制配置，请不要使用
   - 如果你需要分组执行，请先建立和组数对应的配置组，分别添加本js，路径组一要【排除】的标签填写需要完全禁用的标签，如蕈兽，路径组二要【选择】的标签填写需要分配到路径组二的路线的标签，如小怪，不同配置组的js中选择对应的配队和路径组编号，其他配置保持默认的情况下即可实现精英和小怪分队伍和配置组锄地，更多路径组数量以此类推，需要分组运行的可以参考b站官号视频https://www.bilibili.com/video/BV1JYGVzHEmD/?spm_id_from=333.1387.collection.video_card.click
   - **本路径组使用配队名称：** 填写该路径组使用的配队名称，js会自动切换
   - **拾取模式：** 需要注意，沙暴路线只在模板匹配模式下可用
   - - 模板匹配拾取：推荐使用，速度最快，性能消耗最低
   - - bgi原版拾取：使用bgi自带的拾取
   - - 不拾取：不拾取任何物品
   - **拾取时间参数：** 建议先不要调节，观察到拾取异常时再根据自定义配置提示调节
   - **组内路线排序模式：** 效率降序用于当你的时间不足以刷完所有路线时使用，先刷效率最高的（可配合优先关键词使用，这些路线效率会被视为最高）；高收益优先选项将会将包含高倍率怪物（如600，400，81，飞萤）的路线排在前面，避免因为超出上限损失这部分收益
   - **输入不运行的时间或时间段的小时数** 当你需要让js在特定的时间终止运行时，按描述填写，js会在距离目标时间小于五分钟时终止运行并等待到目标时间
   - **泥头车模式：** 接近战斗地点（距离5-30）时，提前让指定序号的角色开e，建议以下角色开启：芙宁娜，爱可菲，雷电将军，不建议各种盾位或纳塔角色开启。
2. 第二部分：路线选择与分组配置：该部分将决定路线的选择与分配，js将尝试按照以下配置选择路线以达到目标数量的怪物，并分配到不同的路径组，在第一部分中选择不同的路径组以执行对应的路线
   - **账户名称：** 本js支持多用户，不同账户的记录分开存储，当你需要使用多用户时，请在这里填写不同的文本来区分不同账号的记录，如果你只使用一个账号，请不要修改该选项
   - **路径组x标签：** 本js使用不同的标签来禁用或分组路线，多个标签之间使用中文逗号分隔，目前支持的标签如下
   - - 水免：表明路线含有水元素伤害免疫的怪物，使用以水元素伤害为主的队伍处理该路线时可能较为麻烦
   - - 次数盾：表明路线含有带有次数盾的怪物，常规配队破盾效率较慢
   - - 高危 ：表明路线战斗强度较高，可能存在生存压力
   - - 传奇 ：表明路线含有地方传奇，战斗强度通常极高，请评估后选择是否排除
   - - 蕈兽 ：表明路线含有蕈兽，蕈兽遇到雷火元素时会发生转化，转化后占据精英怪物的名额却只掉落少量摩拉，通常建议禁用
   - - 小怪 ：表明路线只含小怪，战斗强度低，且无需携带万叶来拾取可能掉落的狗粮，可以适当携带等级较低或不上场的角色来获取经验收益
   - - 狂猎 ：标明路线含义挪德卡莱的狂猎类型怪物，需要先破血条后打灰条，难度较高
   - - 狭窄地形 ：表明路线存在部分非常狭窄，任何位移技能都容易导致致命后果
   - - 环境伤害 ：路线处于雪山或挪德卡莱苦壑崖区域，环境伤害会持续扣血
   - - 分组逻辑：不含路径组1排除标签和任何其他组标签的路径会进入路径组1，剩余路径若含有路径组x的标签之一，则会进入路径组x
   - - 新增支持自定义标签，将会尝试将未知的标签通过文件路径，description匹配，含有对应关键词的路线即视为含有这些标签
   - **路线效率计算权重：** 影响js评估路线价值，计算公式如下，权重越大越看重总收益
   - $$ 怪均^k \times 秒均 $$
   - **自动优化：** js将根据运行记录调整每条路线的预期运行时间，具体逻辑为，至多7条记录，去除一个最大值、一个最小值后，每条记录占据20%的权重，剩余权重由默认数据填充。如果你不想要这个功能，请禁用。
   - **目标数量：** 选取路线目标达到的精英怪数量，默认为400，同理小怪数量默认为2000
   - **优先关键词：** 含有关键词的路线会被视为拥有最高效率，例如填写600来让所有600怪物优先考虑，填写骗骗花来优先考虑骗骗花
   - **排除关键词：** 含有关键词的路线会被排除，例如填写纳塔来排除所有纳塔路线，同样使用中文逗号分隔

3. **只建议在原神中设置1080p，60帧使用，其他分辨率或帧率出现任何问题都是正常现象**
4. **不建议使用12小时制时间（虽然也能跑）**
5. **注意，仅选择路径组一的配置组的第二部分路线与分组配置有效，选择路径组一的配置组的本js运行后将保存配置，供其他路径组读取，其他路径组的自定义配置中第二部分完全无效，该设定是为了确保各个配置组中同账户的路线分配完全相同**
6. **个性化编辑**:允许一定程度的个性化配置。
   - 只需要拾取狗粮和部分材料时，可以将所需材料的图片复制到assets/targetItems/其他/保留文件夹，这个文件夹内的图片不会被更新覆盖（至多三层子文件夹，且只保留png）,此时选择只拾取狗粮模式就会同时拾取狗粮和你添加的材料，选择拾取狗粮和怪物材料则会拾取狗粮，你添加的材料，怪物材料
   - 虽然仓库中“敌人与魔物”路径普遍质量较差，本js仍然允许用户自行添加部分路径，建议放在pathing/0-保留文件夹下，这个文件夹下的地图追踪文件不会被更新覆盖(至多三层子文件夹，且只保留json)，按照本js规则正确标注了预计用时与怪物信息的路线可以正常参与路线分配和怪物数量计算，没有进行标注的路径则默认60秒，0怪物数量，0收益，通常仅在启用仅指定怪物模式时使用。使用自行添加路线造成的卡死、被击败、怪物数量异常等问题，本js概不负责。**强烈建议只使用本js原装的，经过优选和验证的路线**

 - **js内置校验，用于在配队等存在问题时进行警告，如果无视警告执意使用，或勾选跳过校验阶段，则任意问题均由用户配置导致**

### 六、其他
 - **想要测作者怎么办** ：来q群1057307824测测莫酱（有其他问题也行）
 - **茶包版小广告**：茶包版bgi具有许多公版bgi没有的功能（如火神赶路），能相当程度提高锄地效率与稳定性，想要测测茶包也可以加上面的群聊
 - **莫酱全家桶（部分）**：
   - 日常使用
   - 锄地一条龙：一站式解决自动化锄地，支持只拾取狗粮
   - AAA狗粮批发：自动卡时间拿狗粮，收益最大化
   - AAA狗粮联机团购：联机获取更多狗粮收益
   - 采集cd管理：管理采集路线并自动优化
   - 锁定四星教官：锁定四星教官，支持筛选只要初始3和只要带充能
   - 只要大瓶：尽可能将狗粮分解成大瓶，起个好看的作用
   - 妙妙小工具
   - 性能测试：测测你的电脑性能
   - 食材加工极速版：与采集cd管理中相同的食材加工
   - 更多妙妙小工具可以加群获取