# 批量自动化任务功能使用说明

## 🎯 功能概述

批量自动化任务功能允许您在Token管理页面，**无需跳转到游戏功能界面**，直接对所有Token进行批量任务执行，大幅提升操作效率。

---

## ✨ 核心特性

### 1. **多Token并发执行**
- ✅ 可配置1-6个Token同时执行任务（默认5个）
- ✅ 自动队列管理，无需手动等待
- ✅ 失败自动跳过，不影响其他Token

### 2. **自定义任务模板**
- ✅ 预设3个常用模板（完整套餐、快速套餐、仅一键补差）
- ✅ 支持自定义创建/编辑/删除模板
- ✅ 灵活选择需要执行的任务

### 3. **定时自动执行**
- ✅ 间隔定时：每N小时自动执行一次
- ✅ 每日定时：每天特定时间点自动执行
- ✅ 智能调度，自动计算下次执行时间

### 4. **实时进度监控**
- ✅ 总体进度百分比显示
- ✅ 每个Token的详细执行状态
- ✅ 成功/失败/跳过统计
- ✅ 执行耗时实时更新
- ✅ 手动控制进度显示

### 5. **执行历史记录**
- ✅ 保存最近10次执行记录
- ✅ 详细统计信息
- ✅ 执行时间和耗时记录

---

## 📦 可用任务列表

| 任务ID | 任务名称 | 说明 |
|--------|---------|------|
| `dailyFix` | 一键补差 | **完整版每日任务**（22大类，约70+子操作），包含：分享游戏、赠送好友金币、免费招募、付费招募、免费点金(3次)、开启木质宝箱×10、福利签到、领取每日礼包、领取免费礼包、领取永久卡礼包、领取邮件奖励、免费钓鱼(3次)、灯神免费扫荡(4国)、领取免费扫荡卷(3次)、**黑市一键采购**、**竞技场战斗(3次)**、**军团BOSS**、**每日BOSS(3次)**、盐罐机器人重启、领取任务奖励(1-10)、领取日常任务奖励、领取周常任务奖励。超时时间：统一1000ms。详见《[一键补差完整子任务清单.md](一键补差完整子任务清单.md)》 |
| `legionSignIn` | 俱乐部签到 | 军团/俱乐部每日签到 |
| `autoStudy` | 一键答题 | 自动答题并领取奖励 |
| `claimHangupReward` | 领取奖励（挂机） | 领取离线挂机收益 |
| `addClock` | 加钟 | 延长挂机时间（需在领取挂机奖励之后执行） |

---

## 🚀 使用步骤

### 第一步：导入Token
1. 访问 `/tokens` 页面
2. 选择导入方式（推荐使用bin文件上传）
3. 确保至少有一个Token可用

### 第二步：选择任务模板
1. 在"批量自动化任务"面板中
2. 从下拉菜单选择预设模板：
   - **完整套餐**：包含所有5个任务（一键补差、俱乐部签到、一键答题、领取奖励、加钟）
   - **快速套餐**：不含一键补差，适合快速执行
   - **仅一键补差**：只执行一键补差任务
3. 或点击"自定义模板"创建自己的任务组合

### 第三步：设置并发数
1. 使用滑块调整并发数量（1-6个）
2. 建议根据网络状况和服务器压力选择：
   - **网络较好**：5-6个
   - **网络一般**：3-4个
   - **谨慎模式**：1-2个

### 第四步：开始执行
1. 点击"开始执行"按钮
2. 系统会自动：
   - 为每个Token建立WebSocket连接（自动从bin文件获取新token）
   - 按队列顺序执行任务
   - 实时显示进度和状态
   - 任务完成后自动断开WebSocket连接

### 第五步：监控进度
- 查看总体进度百分比
- 每个Token的卡片显示：
  - ⏳ **执行中**：黄色，显示当前任务
  - ✅ **已完成**：绿色，显示成功数量
  - ❌ **失败**：红色，显示错误信息
  - ⏭️ **已跳过**：灰色

### 第六步：查看详情
- 点击任意Token的进度卡片上的"详情"按钮
- 查看每个任务的具体执行结果：
  - 成功的任务
  - 失败的任务及错误原因
  - 执行统计

### 第七步：控制执行
- **暂停**：临时暂停任务执行（不影响已启动的任务）
- **继续**：从暂停状态恢复执行
- **停止**：立即停止所有任务
- **关闭进度显示**：任务完成后，点击"关闭"按钮隐藏进度区域

---

## ⏰ 定时任务设置

### 间隔定时
1. 点击"定时设置"按钮
2. 选择"间隔定时"模式
3. 设置间隔小时数（如每4小时执行一次）
4. 启用调度器
5. 系统将自动在后台执行任务

### 每日定时
1. 点击"定时设置"按钮
2. 选择"每日定时"模式
3. 添加多个时间点（如：08:00, 12:00, 18:00, 22:00）
4. 启用调度器
5. 系统将在每天指定时间自动执行

> **注意**：定时任务会在后台自动运行，即使关闭页面后也会在下次打开时继续执行

---

## 🎨 自定义模板

### 创建模板
1. 点击"自定义模板"按钮
2. 切换到"创建新模板"标签
3. 输入模板名称
4. 选择要包含的任务
5. 点击"创建模板"

### 编辑模板
1. 点击"自定义模板"按钮
2. 在"现有模板"标签中选择要编辑的模板
3. 修改任务选择
4. 点击"保存修改"

### 删除模板
1. 在编辑界面选择要删除的模板
2. 点击"删除模板"按钮
3. 确认删除

---

## 📊 执行历史

### 查看历史
1. 点击"执行历史"按钮
2. 查看最近10次执行记录
3. 每条记录包含：
   - 执行时间
   - 使用的模板
   - 总Token数
   - 成功/失败/跳过数量
   - 总耗时

### 清空历史
- 点击"清空历史"按钮清空所有记录

---

## ⚠️ 注意事项

### 任务顺序
- **领取挂机奖励** 必须在 **加钟** 之前执行
- 建议任务顺序：一键补差 → 俱乐部签到 → 一键答题 → 领取奖励 → 加钟

### 并发数选择
- 并发数越高，执行速度越快，但服务器压力越大
- 建议不要超过6个，避免触发服务器限流

### WebSocket连接
- 每次执行都会从bin文件重新获取token，确保连接有效
- 任务完成后会自动断开连接，节省资源
- 如果某个Token连接失败，会自动跳过，不影响其他Token

### 任务失败
- 单个任务失败不会中断整个流程
- 可以点击"详情"查看具体失败原因
- 建议检查Token是否有效、网络是否稳定

### 一键补差任务
- 包含22大类任务，约70+个子操作，涵盖游戏内所有日常活动（含战斗）
- 执行时间较快（约1-1.5分钟/Token）
- 超时时间优化：统一1000ms
- 自动切换到阵容1进行战斗（竞技场、BOSS）
- 部分子任务可能因游戏状态而失败（如已完成、资源不足等），这是正常现象
- 详细子任务列表请查看《[一键补差完整子任务清单.md](一键补差完整子任务清单.md)》

---

## 🔧 故障排查

### 问题：任务无法开始
- ✅ 检查是否有可用的Token
- ✅ 检查是否选择了任务模板
- ✅ 确认WebSocket连接状态

### 问题：Token执行失败
- ✅ 检查bin文件是否存在
- ✅ 验证Token是否过期
- ✅ 查看详细错误信息

### 问题：进度卡住不动
- ✅ 检查网络连接
- ✅ 尝试停止后重新执行
- ✅ 降低并发数

### 问题：定时任务未执行
- ✅ 确认调度器已启用
- ✅ 检查浏览器是否保持打开
- ✅ 查看执行历史验证

---

## 📝 更新日志

### v2.2.0 (最新 - 重大更新)
- ✨ **新增黑市一键采购任务**
- ✨ **新增竞技场战斗（3次，自动切换阵容1）**
- ✨ **新增军团BOSS（自动切换阵容1）**
- ✨ **新增每日BOSS/咸王考验（3次，自动切换阵容1）**
- ⚡ **超时时间大优化：统一1000ms（提速50%）**
- 📋 **任务顺序优化：领取奖励移到最后**
- 📊 一键补差现包含22大类，约70+个子操作
- ⏱️ 整体执行时间减少约30秒

### v2.1.0
- ✨ 一键补差新增"付费招募"任务
- ✨ 一键补差新增"开启木质宝箱×10"任务
- ✨ 一键补差现包含18大类，约50+个子操作
- 📄 新增《一键补差完整子任务清单.md》
- 🔍 执行时在控制台显示所有子任务列表

### v2.0.0
- ✨ 重构任务结构，整合完整一键补差
- ✨ 新增"俱乐部签到"任务
- ✨ 新增"领取奖励（挂机）"任务
- ✨ 新增"加钟"任务
- ✨ 优化任务模板，提供更合理的预设
- ✨ 改进任务顺序，确保执行逻辑正确
- ✨ 完善一键补差，包含所有原始每日任务

### v1.2.0
- ✨ 新增可配置并发数（1-6）
- ✨ 新增进度显示控制（手动关闭）
- ✨ 新增任务详情弹窗
- ✨ 优化WebSocket连接管理
- 🐛 修复连接未断开的问题

### v1.1.0
- ✨ 新增"加钟"任务
- ✨ 新增"重启盐罐机器人"任务
- 🔧 改进任务间隔时间

### v1.0.0
- 🎉 初始版本发布
- ✅ 基础批量任务功能
- ✅ 任务模板系统
- ✅ 定时调度功能
- ✅ 执行历史记录

---

## 💡 使用技巧

1. **快速日常**：使用"完整套餐"模板，一键完成所有日常任务
2. **定时挂机**：设置每日定时，自动领取挂机奖励+加钟
3. **分批执行**：网络不稳定时，降低并发数到2-3个
4. **详情检查**：执行完成后，点击详情查看是否有任务失败
5. **模板复用**：为不同场景创建多个模板，快速切换

---

## 🤝 技术支持

如遇到问题或有功能建议，请联系开发者或提交Issue。

---

**享受自动化带来的便利！** 🎉
