xyzw_web_helper/MD说明文件夹/功能更新-批量任务添加发车功能v3.9.0.md

功能更新-批量任务添加发车功能 v3.9.0

📋 功能描述

在批量自动化任务中新增"发车"功能，支持自动查询、刷新、收获和发送俱乐部赛车。

🎯 用户需求

包含任务中，添加游戏功能模块中的 发车功能（先查询车辆，再批量刷新可选，默认1次，且只针对无刷新票的车辆进行刷新，然后就一键发车，每个token卡片每天四次的发车限制）

✨ 新增功能

1. 发车任务流程

发车任务按照以下顺序执行：

1. 查询车辆
   ↓
2. 批量刷新（可选）
   - 默认1次刷新
   - 只刷新无刷新票的车辆
   - 可设置0-10次
   ↓
3. 批量收获
   - 自动收获已到达的车辆
   ↓
4. 批量发送
   - 发送待发车的车辆
   - 严格执行每日4次限制
   ↓
5. 完成

2. 配置项

发车刷新次数

• 位置：批量任务面板 → 发车刷新次数
• 范围：0-10次
• 默认值：1次
• 说明：
  • 设置为0：跳过刷新步骤
  • 设置为N：每辆车刷新N轮
  • 只刷新无刷新票的车辆（itemId: 35002）

每日发车限制

• 限制：每个token每天最多发送4辆车
• 实现：
  • 基于 localStorage 按 tokenId 和日期独立计数
  • 跨日期自动重置
  • 支持多账号独立计数

3. 任务模板更新

已将"发车"任务添加到以下模板：

模板名称	包含任务
完整套餐	一键补差、俱乐部签到、一键答题、领取挂机奖励、加钟、发车、爬塔
快速套餐	俱乐部签到、一键答题、领取挂机奖励、加钟、发车、爬塔
仅一键补差	一键补差

🔧 技术实现

1. Store 修改 (batchTaskStore.js)

新增配置项

// 发车配置
const carRefreshCount = ref(
  parseInt(localStorage.getItem('carRefreshCount') || '1')
) // 发车前刷新次数（0-10，0表示跳过刷新）

新增方法

// 设置发车刷新次数
const setCarRefreshCount = (count) => {
  if (count < 0 || count > 10) {
    console.warn('⚠️ 发车刷新次数必须在0-10之间')
    return
  }
  carRefreshCount.value = count
  localStorage.setItem('carRefreshCount', count.toString())
  console.log(`🚗 发车刷新次数已设置为: ${count}`)
}

executeTask 新增 sendCar case

case 'sendCar':
  // 发车任务（查询、刷新、发送）
  // 1. 查询车辆
  // 2. 批量刷新（可选，只刷新无刷新票的车）
  // 3. 检查每日发车次数限制
  // 4. 批量收获
  // 5. 批量发送

2. UI 组件修改 (BatchTaskPanel.vue)

新增配置UI

<n-grid-item>
  <div class="tower-count-selector">
    <div class="selector-header">
      <label>发车刷新次数：</label>
      <n-input-number
        v-model:value="batchStore.carRefreshCount"
        :min="0"
        :max="10"
        :step="1"
        @update:value="handleCarRefreshCountChange"
      >
        <template #suffix>
          <span style="margin-left: 4px;">次</span>
        </template>
      </n-input-number>
    </div>
    <n-slider
      v-model:value="batchStore.carRefreshCount"
      :min="0"
      :max="10"
      :step="1"
    />
  </div>
</n-grid-item>

任务定义更新

const taskDefinitions = {
  dailyFix: { label: '一键补差', type: 'warning' },
  legionSignIn: { label: '俱乐部签到', type: 'info' },
  autoStudy: { label: '一键答题', type: 'warning' },
  claimHangupReward: { label: '领取挂机奖励', type: 'success' },
  addClock: { label: '加钟', type: 'info' },
  sendCar: { label: '发车', type: 'info' },  // ← 新增
  climbTower: { label: '爬塔', type: 'error' }
}

3. 发车任务详细逻辑

第1步：查询车辆

const queryResponse = await client.sendWithPromise('car_getrolecar', {}, 1500)
const carDataMap = queryResponse.roleCar.carDataMap || {}
const carIds = Object.keys(carDataMap).sort() // 按ID排序

第2步：批量刷新（可选）

const refreshCount = carRefreshCount.value
if (refreshCount > 0) {
  for (let round = 1; round <= refreshCount; round++) {
    for (const carId of carIds) {
      const carInfo = carDataMap[carId]
      
      // 跳过有刷新票的车辆
      if (carHasRefreshTicket(carInfo)) {
        console.log(`⏭️ 跳过有刷新票的车辆: ${carId}`)
        continue
      }
      
      // 刷新车辆
      await client.sendWithPromise('car_refresh', { carId: carId }, 1500)
    }
  }
}

第3步：检查每日发车次数

const getTodayKey = (tokenId) => {
  const today = new Date().toLocaleDateString('zh-CN', { 
    year: 'numeric', month: '2-digit', day: '2-digit' 
  })
  return `car_daily_send_count_${today}_${tokenId}`
}

const dailySendKey = getTodayKey(tokenId)
const dailySendCount = parseInt(localStorage.getItem(dailySendKey) || '0')

if (dailySendCount >= 4) {
  return {
    task: '发车',
    success: true,
    message: `今日发车次数已达上限(${dailySendCount}/4)`
  }
}

第4步：批量收获

for (const carId of carIds) {
  const carInfo = carDataMap[carId]
  const state = getCarState(carInfo) // 计算车辆状态
  
  if (state === 2) { // 已到达
    await client.sendWithPromise('car_claim', { carId: carId }, 1500)
  }
}

第5步：批量发送

const remainingSendCount = 4 - dailySendCount
const readyToSendCars = carIds.filter(carId => getCarState(carDataMap[carId]) === 0)
const carsToSend = readyToSendCars.slice(0, remainingSendCount)

for (const carId of carsToSend) {
  await client.sendWithPromise('car_send', {
    carId: carId,
    helperId: 0,
    text: ""
  }, 1500)
  
  // 更新发车次数
  const newCount = dailySendCount + sendSuccessCount
  localStorage.setItem(dailySendKey, newCount.toString())
  
  if (newCount >= 4) break // 达到上限，停止发送
}

4. 辅助函数

检查车辆是否有刷新票

const carHasRefreshTicket = (carInfo) => {
  if (!carInfo?.rewards || !Array.isArray(carInfo.rewards)) {
    return false
  }
  // 刷新票的itemId是35002
  return carInfo.rewards.some(reward => reward.itemId === 35002)
}

计算车辆状态

const getCarState = (carInfo) => {
  if (!carInfo) return 0
  
  const { sendAt = 0, claimAt = 0, color = 1 } = carInfo
  
  // 运输时间（秒）
  const transportDuration = (color === 1 || color === 2) ? 9000 :   // 普通/稀有: 150分钟
                           (color === 3) ? 10800 :                  // 史诗: 180分钟
                           14400                                    // 神话/传奇: 240分钟
  
  // 状态判断
  if (sendAt === 0) {
    return 0 // 待发车
  } else if (claimAt === 0) {
    const now = Math.floor(Date.now() / 1000)
    const elapsed = now - sendAt
    if (elapsed >= transportDuration) {
      return 2 // 已到达
    } else {
      return 1 // 运输中
    }
  } else {
    return 0 // 待发车（已收获）
  }
}

📊 执行日志示例

成功执行

🚗 [token_123] 开始查询俱乐部车辆...
✅ [token_123] 查询到 4 辆车
🔄 [token_123] 开始批量刷新车辆（1次）...
🔄 [token_123] 第1轮刷新...
⏭️ [token_123] 跳过有刷新票的车辆: car_001
✅ [token_123] 刷新车辆成功: car_002
✅ [token_123] 刷新车辆成功: car_003
✅ [token_123] 刷新车辆成功: car_004
🔄 [token_123] 刷新完成：成功3次，跳过1次，失败0次
📊 [token_123] 今日已发车次数: 0/4
🎁 [token_123] 开始批量收获...
✅ [token_123] 收获车辆成功: car_001
🎁 [token_123] 收获完成：成功1次，跳过3次
🚀 [token_123] 开始批量发送...
🚀 [token_123] 待发车: 4辆，剩余额度: 4个，将发送: 4辆
✅ [token_123] 发送车辆成功: car_001
✅ [token_123] 发送车辆成功: car_002
✅ [token_123] 发送车辆成功: car_003
✅ [token_123] 发送车辆成功: car_004
🚀 [token_123] 发送完成：成功4次，跳过0次
✅ 完成发车任务 (收获1，发送4，今日4/4)

已达上限

🚗 [token_456] 开始查询俱乐部车辆...
✅ [token_456] 查询到 4 辆车
⏭️ [token_456] 刷新次数设置为0，跳过刷新
📊 [token_456] 今日已发车次数: 4/4
⚠️ [token_456] 今日发车次数已达上限: 4/4
✅ 今日发车次数已达上限(4/4)

🎨 UI 展示

批量任务面板

┌─────────────────────────────────────┐
│ ⚡ 批量自动化任务                    │
├─────────────────────────────────────┤
│ 选择任务模板: [完整套餐 ▼]          │
│                                     │
│ 并发数量: [5] ━━━━━○━━━━━━━━━━ 次   │
│                                     │
│ 爬塔次数: [10] ━━━━━○━━━━━━━━ 次    │
│                                     │
│ 发车刷新次数: [1] ○━━━━━━━━━━ 次 ← 新增 │
│                                     │
│ 包含任务 (7个):                      │
│  [一键补差] [俱乐部签到] [一键答题]  │
│  [领取挂机奖励] [加钟] [发车] [爬塔] │
│                            ↑ 新增    │
│                                     │
│ [▶ 开始执行 (318个角色)]             │
└─────────────────────────────────────┘

🧪 测试场景

场景1：首次发车（刷新1次）

1. 设置发车刷新次数为1
2. 启动批量任务
3. 预期结果：
   • 查询4辆车
   • 刷新无刷新票的车辆1次
   • 收获已到达的车辆
   • 发送待发车的车辆（最多4辆）
   • 更新今日发车次数

场景2：跳过刷新

1. 设置发车刷新次数为0
2. 启动批量任务
3. 预期结果：
   • 查询车辆
   • 跳过刷新步骤
   • 直接收获和发送

场景3：已达每日上限

1. 账号今日已发送4辆车
2. 再次执行发车任务
3. 预期结果：
   • 查询车辆
   • 检测到已达上限
   • 跳过收获和发送
   • 提示："今日发车次数已达上限(4/4)"

场景4：多账号独立计数

1. 账号A发送4辆车（4/4）
2. 切换到账号B
3. 执行发车任务
4. 预期结果：
   • 账号B显示0/4
   • 可以正常发送4辆车

📝 相关文件

修改的文件

1. src/stores/batchTaskStore.js

   • 添加 carRefreshCount 配置项
   • 添加 setCarRefreshCount() 方法
   • 添加 sendCar case 到 executeTask()
   • 更新任务模板，添加 'sendCar'

2. src/components/BatchTaskPanel.vue

   • 添加发车刷新次数配置UI
   • 添加 handleCarRefreshCountChange() 方法
   • 更新 taskDefinitions，添加 'sendCar'

新增文件

• MD说明/功能更新-批量任务添加发车功能v3.9.0.md

🔄 版本信息

• 版本号: v3.9.0
• 更新日期: 2025-01-08
• 更新内容:
  • 批量任务新增"发车"功能
  • 支持可配置的批量刷新
  • 支持每日4次发车限制
  • 支持多账号独立计数
• 依赖版本: v3.8.1

🎯 使用说明

基本使用

1. 打开"批量自动化任务"面板
2. 选择包含"发车"任务的模板（如"完整套餐"）
3. 设置发车刷新次数（推荐1次）
4. 点击"开始执行"

高级配置

• 跳过刷新：将发车刷新次数设置为0
• 多轮刷新：将发车刷新次数设置为2-10（适合追求极品奖励）
• 定时执行：配合定时任务，每天自动发车

注意事项

1. 每日限制：每个token每天最多发送4辆车，超出会自动跳过
2. 刷新逻辑：只刷新无刷新票的车辆（有刷新票的车辆会被跳过）
3. 执行顺序：发车任务在"加钟"之后、"爬塔"之前执行
4. 并发执行：支持多账号并发，每个账号独立计数

🐛 已知问题

无

🚀 后续计划

• 添加发车结果详细统计
• 支持自定义刷新策略（如只刷新特定品质）
• 添加发车奖励记录

---

✅ 功能已完成！刷新页面（Ctrl + F5）即可使用批量发车功能！