1.0

MD说明文件夹/快速使用指南-v3.13.3.md

@@ -0,0 +1,314 @@
+# 快速使用指南 v3.13.3
+
+## 100并发批量任务配置指南
+
+### 🎯 目标
+稳定执行 100 个 token 的批量任务（俱乐部签到、发车等）
+
+### ⚙️ 推荐配置
+
+#### 方案一：连接池模式（推荐）✅
+
+```
+启用连接池模式: ✅ 开启
+连接池大小: 20
+同时执行数: 5
+```
+
+**优势：**
+- ✅ 突破浏览器连接数限制
+- ✅ 稳定性高
+- ✅ 每个 token 使用自己的连接（无账号混乱）
+- ✅ 适合 100 并发
+
+**工作原理：**
+```
+前20个token → 创建连接 → 其中5个开始执行任务
+第21个token → 等待名额 → 获得名额 → 创建连接 → 执行任务
+第22个token → 等待名额 → 获得名额 → 创建连接 → 执行任务
+...
+```
+
+#### 方案二：传统模式
+
+```
+启用连接池模式: ❌ 关闭
+并发数: 10-15
+```
+
+**优势：**
+- ✅ 简单直接
+- ✅ 适合 token 数量较少的场景
+
+**劣势：**
+- ❌ 受浏览器连接数限制（通常 6-10 个）
+- ❌ 并发数过高可能导致 WSS 连接失败
+- ❌ 不适合 100 并发
+
+### 🔧 配置步骤
+
+#### 1. 打开批量任务面板
+在"Token导入"页面找到"批量自动化"面板
+
+#### 2. 配置连接池模式
+```
+┌─────────────────────────────────────────┐
+│ 🏊 启用连接池模式                        │
+│ [✓] 启用 (推荐用于100并发)               │
+│                                         │
+│ 说明：突破浏览器连接数限制，让100个token │
+│      排队使用20个连接名额                │
+└─────────────────────────────────────────┘
+```
+
+#### 3. 配置连接池大小
+```
+┌─────────────────────────────────────────┐
+│ 连接池大小: [20] 个                     │
+│ ├─────────────────────────────────┤    │
+│ 10        15        20        25        │
+│                                         │
+│ 推荐配置:                                │
+│ • 15-20: 平衡稳定性和效率 ✅            │
+│ • 10-14: 极度保守，适合网络很差         │
+│ • 21-30: 可能超过浏览器限制             │
+└─────────────────────────────────────────┘
+```
+
+#### 4. 配置同时执行数
+```
+┌─────────────────────────────────────────┐
+│ 同时执行数: [5] 个 ⭐ 关键参数          │
+│ ├─────────────────────────────────┤    │
+│ 1     3     5     7     10       20     │
+│                                         │
+│ 推荐配置:                                │
+│ • 4-6: 推荐配置，平衡稳定性和效率 ✅    │
+│ • 1-3: 极度保守，适合网络很差           │
+│ • 7-10: 激进配置，适合网络很好          │
+│ • >10: 不推荐，可能导致请求拥堵         │
+└─────────────────────────────────────────┘
+```
+
+⚠️ **重要说明：**
+- **连接池大小** = 同时存在的最大连接数（推荐 20）
+- **同时执行数** = 同时发送请求的 token 数量（推荐 5）
+- **必须满足**: 连接池大小 >= 同时执行数
+
+### 📊 配置示例
+
+#### 示例 1：保守配置（网络不稳定）
+```
+启用连接池: ✅
+连接池大小: 15
+同时执行数: 3
+
+预期表现:
+- 非常稳定
+- 速度较慢
+- 适合网络差的环境
+```
+
+#### 示例 2：推荐配置（一般情况）✅
+```
+启用连接池: ✅
+连接池大小: 20
+同时执行数: 5
+
+预期表现:
+- 稳定性好
+- 速度适中
+- 适合大多数情况
+```
+
+#### 示例 3：激进配置（网络很好）
+```
+启用连接池: ✅
+连接池大小: 25
+同时执行数: 8
+
+预期表现:
+- 速度较快
+- 可能不稳定
+- 仅适合网络非常好的环境
+```
+
+### 🚀 执行流程
+
+#### 1. 选择 Token
+```
+☐ 全选 (100个)
+☑ Token001
+☑ Token002
+...
+☑ Token100
+```
+
+#### 2. 选择任务
+```
+☑ 俱乐部签到
+☑ 发车
+☐ 一键补差
+☐ 每日任务
+...
+```
+
+#### 3. 开始执行
+点击"开始执行"按钮
+
+#### 4. 观察日志
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏊 连接池模式已启用 (v3.13.3 修复版)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+连接池大小: 20 (同时存在的最大连接数)
+Token数量: 100
+工作方式: 每个token使用自己的连接（不复用给其他token）
+         100个token排队使用20个连接名额
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎫 [Token001] 请求连接...
+✅ [Token001] 获取连接成功 (此连接专属于此token)
+📌 [Token001] 执行任务: 俱乐部签到
+✅ [Token001] 任务完成: 俱乐部签到
+🔓 [Token001] 释放连接
+🔄 [连接池v3.13.3] 释放名额，允许 Token021 创建连接
+```
+
+### ⚠️ 常见问题排查
+
+#### 问题 1: 任务超时频繁
+**可能原因：** 同时执行数太高，服务器拥堵
+
+**解决方案：**
+```
+降低"同时执行数"
+推荐: 5 → 3 → 1（逐步降低）
+```
+
+#### 问题 2: "WebSocket未连接" 错误
+**可能原因：** 连接池大小超过浏览器限制
+
+**解决方案：**
+```
+降低"连接池大小"
+推荐: 20 → 15 → 10（逐步降低）
+```
+
+#### 问题 3: 执行速度很慢
+**可能原因：** 配置过于保守
+
+**解决方案：**
+```
+适当提高参数（在稳定的前提下）
+同时执行数: 3 → 5
+连接池大小: 15 → 20
+```
+
+#### 问题 4: "发车失败" 或 "签到失败"
+**可能原因：** 账号未加入俱乐部
+
+**解决方案：**
+```
+检查日志中的详细错误信息：
+- "未加入俱乐部" → 该账号需要加入俱乐部
+- "已签到" → 正常，跳过即可
+- "非发车时间" → 发车时间为 6:00-20:00
+```
+
+### 📈 性能监控
+
+#### 关注指标
+```
+📊 执行统计
+成功: 95/100  ← 成功率应该 >90%
+失败: 3/100   ← 失败率应该 <10%
+跳过: 2/100   ← 跳过是正常的（如已签到）
+```
+
+#### 连接池状态
+```
+📊 [连接池状态 v3.13.3]
+连接池大小: 20
+当前连接数: 20  ← 应该不超过连接池大小
+活跃连接: 5     ← 应该不超过同时执行数
+等待任务: 80    ← 剩余等待的 token 数量
+```
+
+### 🎓 进阶技巧
+
+#### 技巧 1: 分批执行
+```
+如果 100 个 token 一次性执行压力大，可以分批：
+第一批: Token 1-50
+第二批: Token 51-100
+
+好处：更稳定，更容易监控
+```
+
+#### 技巧 2: 任务分组
+```
+将不同类型的任务分开执行：
+批次1: 俱乐部签到（快速任务）
+批次2: 发车（慢速任务）
+
+好处：避免慢任务阻塞快任务
+```
+
+#### 技巧 3: 错峰执行
+```
+避开游戏高峰期（如整点）
+推荐时间段：
+- 凌晨 2:00-5:00
+- 上午 9:00-11:00
+- 下午 14:00-16:00
+```
+
+### 🆘 获取帮助
+
+#### 查看日志
+1. 打开浏览器开发者工具（F12）
+2. 切换到"Console"标签
+3. 查看详细的执行日志
+
+#### 关键日志
+```
+✅ 正常日志
+🔓 [Token001] 释放连接
+✅ [Token001] 任务完成
+
+❌ 错误日志
+❌ [Token002] 任务失败: WebSocket未连接
+⚠️ [连接池] 连接 Token003 已失效
+```
+
+#### 提交问题时请提供
+1. 配置截图（连接池大小、同时执行数）
+2. Token数量
+3. 任务类型
+4. 错误日志（控制台截图）
+5. 连接池状态日志
+
+### 📝 总结
+
+**v3.13.3 核心优势：**
+- ✅ 修复了账号混乱问题
+- ✅ 每个 token 使用自己的连接
+- ✅ 稳定支持 100 并发
+
+**推荐起始配置：**
+```
+启用连接池: ✅
+连接池大小: 20
+同时执行数: 5
+```
+
+**调优建议：**
+1. 从推荐配置开始
+2. 观察成功率和速度
+3. 如果频繁超时 → 降低同时执行数
+4. 如果太慢且稳定 → 适当提高同时执行数
+5. 不要超过浏览器连接数限制
+
+🎉 **祝您使用愉快！100并发稳定执行！**
+