### 作者：[秋云](https://github.com/physligl)

> 自动化刷取角色好感度的脚本，支持盗宝团和愚人众两种敌人类型。通过自动触发和完成突发任务来获得好感度经验。

### 目录
- [功能简介](#功能简介)
- [敌人类型](#敌人类型)
- [快速开始](#快速开始)
- [运行流程](#运行流程)
- [常见问题](#常见问题)
- [文件结构](#文件结构)
- [注意事项](#注意事项)
- [更新日志](#更新日志)

### 功能简介

自动化刷取角色好感度的脚本，支持盗宝团和愚人众两种敌人类型。通过自动触发和完成突发任务来获得好感度经验。



- **日限制**: 每日最多获得10次好感度奖励，50次任务触发，在别的地方触发过好感任务会扣减相应次数。
- **循环上限**: 单次运行最多50次循环，自动检测好感任务触发，不再触发时自动结束。
- **平均时长**: 每次循环约1分钟，效率高时可以达到40秒单次循环。
- **成功率**: 配置正确的情况下接近98%，有概率丢失第一次好感任务。

### 敌人类型

#### 盗宝团
| 属性 | 详情 |
|------|------|
| **触发任务** | 岛上无贼 - 消灭鬼鬼祟祟的盗宝团 |
| **活动地区** | 稻妻地区 |
| **敌人强度** | ⭐⭐⭐ (中等) |
| **特殊功能** | （可选）支持清理原住民（丘丘人） |

#### 愚人众&丘丘人&盗宝团
| 属性 | 详情 |
|------|------|
| **触发任务** | 买卖不成正义存 - 打倒愚人众与镀金旅团<br>禁止危险运输！ - 打倒所有盗宝团<br>丘丘人今晚的伙食 - 打倒所有丘丘人 |
| **活动地区** | 须弥地区 |
| **敌人强度** | ⭐⭐⭐⭐ (较高) |


#### 鳄鱼
| 属性 | 详情 |
|------|------|
| **触发任务** | 张牙舞爪的恶党 - 打倒所有鳄鱼 |
| **活动地区** | 须弥地区 |
| **敌人强度** | ⭐⭐ (较低) |
### 快速开始
#### 环境准备
✅ 安装 BetterGI，版本大于 0.44.7
✅ 订阅脚本并添加至调度器

#### 蕈兽 & 雷萤术士
属于测试版本，暂时并不稳定，可以进行测试，但不建议作为日常脚本使用。

#### 调度器配置
- **地图追踪行走配置**:
  - ✅ 勾选"只在传送点时回复"
  - ✅ 勾选"允许在JsScript使用"
  - ✅ 勾选"覆盖JS中的自动战斗配置"

- **战斗配置**
  - **战斗策略**: 根据队伍选择或者制定合适的战斗策略文件
  - **练度要求**: 建议较高练度，纯好感队可能无法击败敌人
  - **重要设置**: ❌ 关闭"自动检测战斗结束" (如果勾选清理丘丘人，则需要打开)
- **推荐队伍配置**
 > 基于社区测试的高效角色推荐，其他效率高的角色欢迎通过 pull request 添加到本文档，需附带理由和演示视频。

| 角色 | 优先级 | 特点 | 注意事项 |
|------|--------|------|----------|
| **那维莱特** | ⭐⭐⭐⭐⭐ | 群友测试效率最高 | 输出稳定，适合自动战斗 |
| **茜特菈莉** | ⭐⭐⭐⭐ | 带盾，后台冰冻结敌人 | 提供生存保障 |
| **枫原万叶** | ⭐⭐⭐⭐ | 拾取材料，扩散伤害 | 增加收益效率 |
| **芙宁娜** | ⭐⭐⭐ | 后台输出 | 生存压力较大 |
| **钟离** | ⭐⭐⭐ | 提供护盾 | 战斗策略中E技能应左右释放 |
#### **脚本设置**
> 通过调度器脚本右键-修改JS自定义配置

   - 敌人类型: 选择"盗宝团"或"愚人众"
   - 运行次数: 10次或者50次
     - 目标是好感选择10次
     - 目标是锄地摩拉选择50次
     - 目标是掉落物暂时不支持
   - 队伍名称: 
     - 填入您的战斗队伍名称
     - 不填默认当前队伍
  - OCR超时:
    - OCR检测超时时间（默认10秒）
    - 过短可能识别失败导致结束任务
    - 过长则会长时间检测导致等待时间过长
    - 推荐保持默认值
  - 战斗超时: 
    - 单次战斗超时时间（默认120秒）
    - 战斗超时会直接取消任务，因此不建议过短
    - 脚本会自动检测任务结束，识别精度很高

#### 一键运行
配置完成后，直接运行脚本即可开始自动刷取好感度。


#### 高级设置
- **清理原住民**: 仅盗宝团模式有效，清理丘丘人
- **卡时间模式**: 支持按日期周期运行

### 运行流程

1. **队伍切换**: 自动切换到指定队伍
2. **准备阶段**: 
   - 盗宝团: (可选) 清理丘丘人 → 前往触发点
   - 愚人众: 直接前往触发点
3. **任务检测**: 使用OCR检测突发任务触发
4. **战斗执行**: 自动导航到战斗点并开始战斗
5. **结果判定**: 检测战斗结果并记录
6. **循环执行**: 重复上述流程直到完成设定次数或者检测到任务未触发


### 常见问题

#### 重要提醒
- 脚本运行时请勿手动操作游戏

#### 常见问题解答

##### Q: 为什么战斗策略没有生效或战斗失败率较高？
**A**: 检查以下几点：
- 是否正确设置了战斗策略
- 战斗策略是否适合当前队伍
- 队伍练度是否足够
- 是否正确勾选了"覆盖JS中的自动战斗配置"


##### Q: OCR超时但是任务已经触发？
**A**: 
- 尝试提高 OCR 超时时间
- 如果观察到触发任务时，左侧没有任务文字，则游戏中关闭任务专注模式

##### Q: 如何选择合适的敌人类型？
**A**:
- **盗宝团**: 适合中等练度队伍，敌人相对较弱
- **愚人众**: 需要高练度队伍，怪物强度相对较高

##### Q: 脚本运行中断怎么办？
**A**:
- 检查是否有手动操作游戏
- 查看日志确定中断原因
- 重新运行脚本
- 若仍然未恢复，提交 issue

##### Q: 脚本卡在某个步骤不动怎么办？
**A**:
- 确认是否卡在了复活界面
- 重启脚本并检查 BetterGI 状态
- 若仍然未恢复，提交 issue

##### Q: 如何选择盗宝团还是愚人众？
**A**:
- **新手推荐**: 选择盗宝团，敌人较弱，容错率高
- **高练度队伍**: 选择愚人众，效率更高
- **好感度优先**: 两者都可以，选择队伍更适合的类型

##### Q: 战斗策略如何配置？
**A**:
- 查阅 BetterGI 文档

##### Q: 为什么任务触发失败？
**A**:
- 检查是否已达到每日任务触发上限
- 尝试手动触发

##### Q: 队伍切换失败怎么办？
**A**:
- 确认队伍名称填写正确（建议四字中文）

##### Q: 脚本运行速度慢怎么办？
**A**:
- 降低OCR超时时间（但不要过短）
- 优化战斗策略，减少不必要的等待
- 确保BetterGI版本为最新
- 检查计算机性能和网络状况
- 提高计算机配置

##### Q: 如何备份和恢复配置？
**A**:
- 配置保存在调度器配置文件中
- 可以手动备份该文件，当然建议直接备份 `User` 文件夹
- 重装后将备份文件复制回原位置即可恢复

> 💡 如遇其他问题，请在 GitHub 上提出 issue

### 文件结构

- `main.js`: 主要脚本逻辑
- `settings.json`: 配置文件
- `assets/AutoPath/`: 路径文件目录
  - `盗宝团-准备.json`: 盗宝团准备阶段路径，清理丘丘人
  - `盗宝团-触发点.json`: 盗宝团触发点路径
  - `盗宝团-战斗点.json`: 盗宝团战斗点路径
  - `愚人众-准备.json`: 愚人众准备阶段路径，从传送点到触发点
  - `愚人众-触发点.json`: 愚人众触发点路径
  - `愚人众-战斗点.json`: 愚人众战斗点路径

### 注意事项

#### 使用须知
- **仅供学习交流**: 本脚本仅用于技术研究和学习交流
- **风险自担**: 使用自动化脚本存在一定风险，请谨慎使用
- **适度使用**: 建议合理安排游戏时间，避免过度依赖自动化

#### 安全建议
- **备份存档**: 使用前建议备份游戏存档数据
- **监督运行**: 运行期间建议保持关注，及时处理异常情况
- **版本更新**: 及时更新 BetterGI 和脚本到最新版本
- **社区反馈**: 遇到问题及时向社区反馈，帮助改进脚本

### 更新日志

| 版本 | 更新内容 | 
|------|----------|
| **v1.3** | 新增愚人众支持，优化敌人类型切换 | 
| **v1.2** | 战斗触发检测，异步检测战斗结束 | 
| **v1.1** | 盗宝团重登功能优化，卡时间支持 |
| **v1.0** | 基础盗宝团好感度刷取功能 | 

---

### 贡献指南
欢迎提交 Pull Request 来改进此脚本！请遵循以下指南：

#### 代码贡献
- **功能改进**: 新增功能、性能优化、bug修复
- **文档完善**: 改进README、添加注释、使用指南
- **测试验证**: 提供测试用例、兼容性验证

#### 提交规范
- 清晰的提交信息描述
- 详细的PR说明和测试结果
- 遵循现有代码风格
- 避免在同一个提交中格式化代码

### 问题反馈
遇到问题请在 GitHub 上提出 issue，包含以下信息：
- 详细的错误描述和复现步骤
- 相关日志截图或错误信息
- 使用的BetterGI版本和游戏环境
- 脚本配置参数

### 社区支持
- 📖 **文档**: 查看完整文档和教程
- 🐛 **报告问题**: 通过Issues报告bug和建议
- 🤝 **贡献代码**: 通过Pull Request贡献代码

> 💝 **感谢所有为此项目做出贡献的开发者和测试者！**

> 🌟 **如果这个脚本对您有帮助，请给项目点个星标支持！**