Files
xyzw_web_helper/MD说明文件夹/批量任务使用说明.md
2025-10-17 20:56:50 +08:00

284 lines
9.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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