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

# 快速使用指南 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并发稳定执行！**