Files
xyzw_web_helper/MD说明文件夹/批量任务使用说明.md

284 lines
9.1 KiB
Markdown
Raw Normal View History

2025-10-17 20:56:50 +08:00
# 批量自动化任务功能使用说明
## 🎯 功能概述
批量自动化任务功能允许您在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。
---
**享受自动化带来的便利!** 🎉