dsh-account-pool 0.1.0

package/lib/tasks.js

@@ -0,0 +1,429 @@
+/**
+ * 每日任务：签到、猫猫旅行、连登查询。
+ *
+ * 接口分两域：
+ *   - billing 域（www.codebuddy.cn/v2/billing/meter/*）：签到、余额
+ *   - growth 域（copilot.tencent.com/activity/growth/*）：Buddy、旅行、连登
+ *
+ * 与账号池的关系：任务**只做余额与状态维护**，不参与对话选号。
+ * 签到会让冷却中的账号恢复可用——这是它对网关的主要价值。
+ *
+ * 设计要点：
+ *   - 签到成功与「今天已签到」都算成功：上游对重复签到返回 code=10001，
+ *     那是幂等成功，当失败会让日志天天报红。
+ *   - 国际版账号没有这套任务体系（签到/旅行都是国内版活动），直接跳过，
+ *     不发起任何上游调用——避免无谓请求触发风控。
+ */
+
+import { chatBaseOf } from './accounts.js'
+import { commonHeaders } from './headers.js'
+
+/** 单次任务请求超时。 */
+const TASK_TIMEOUT_MS = 30_000
+
+/** 国内版计费域（签到、余额都在这里）。 */
+const CN_BILLING_BASE = 'https://www.codebuddy.cn'
+
+/** 签到端点。 */
+const CHECKIN_PATH = '/v2/billing/meter/daily-checkin'
+
+/** 余额端点（与 upstream.js 的 fetchCredits 同一个，这里只用于签到后回报）。 */
+const RESOURCE_PATH = '/v2/billing/meter/get-user-resource'
+
+/** 猫猫旅行：状态 / 派出 / 领奖。 */
+const TRAVEL_STATUS_PATH = '/activity/growth/buddy/travel/status'
+const TRAVEL_DEPART_PATH = '/activity/growth/buddy/travel/depart'
+const TRAVEL_CLAIM_PATH = '/activity/growth/buddy/travel/claim'
+
+/** Buddy 档案与连登信息。 */
+const BUDDY_INFO_PATH = '/activity/growth/buddy/info'
+const STREAK_PATH = '/activity/growth/streak'
+
+/** 连登兑换与抽奖。 */
+const REDEEM_PATH = '/activity/growth/redeem'
+const LOTTERY_SUMMARY_PATH = '/activity/growth/lottery/summary'
+const LOTTERY_DRAW_PATH = '/activity/growth/lottery/draw'
+
+/**
+ * 旅行地点固定用 4（古镇客栈）。
+ * 上游 4 个地点的收益与时长区间完全相同，没有最优解，所以固定一个即可。
+ */
+const TRAVEL_LOCATION_ID = 4
+
+/** 「今天已签到」的标记：命中说明是幂等成功，不是失败。 */
+const ALREADY_CHECKIN_MARKERS = ['已签到', 'already']
+
+/**
+ * 发一个任务请求。
+ *
+ * 与普通 API 的区别：任务域要带 X-CodeBuddy-Request（风控闸门头），
+ * 计费域还要带 X-User-Id / X-Domain / X-Enterprise-Id。
+ *
+ * @returns {Promise<{ok:boolean, code:number, msg:string, data:any}>}
+ */
+async function taskRequest(credential, base, path, { method = 'GET', body } = {}) {
+  const headers = {
+    ...commonHeaders(credential),
+    authorization: `Bearer ${credential.accessToken}`,
+  }
+  if (credential.uid) headers['x-user-id'] = credential.uid
+  if (credential.enterpriseId) {
+    headers['x-enterprise-id'] = credential.enterpriseId
+    headers['x-tenant-id'] = credential.enterpriseId
+  }
+  if (credential.domain) headers['x-domain'] = credential.domain
+
+  const response = await fetch(`${base}${path}`, {
+    method,
+    headers,
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(TASK_TIMEOUT_MS),
+  })
+
+  const text = await response.text()
+  let envelope
+  try {
+    envelope = text === '' ? {} : JSON.parse(text)
+  } catch {
+    return { ok: false, code: -1, msg: `上游返回非 JSON（HTTP ${response.status}）`, data: undefined }
+  }
+  return {
+    ok: response.ok && (envelope.code === 0 || envelope.code === undefined),
+    code: Number(envelope.code ?? 0),
+    msg: String(envelope.msg ?? ''),
+    data: envelope.data,
+  }
+}
+
+/** 是否「今天已签到」这类幂等成功。 */
+function isAlreadyCheckin(msg) {
+  const lower = String(msg ?? '').toLowerCase()
+  return ALREADY_CHECKIN_MARKERS.some(marker => msg.includes(marker) || lower.includes(marker.toLowerCase()))
+}
+
+/**
+ * 生成幂等令牌。上游要求兑换/抽奖带 client_token，
+ * 同一 token 重复提交不会重复发奖——这是防重复扣费的机制。
+ */
+function clientToken() {
+  const bytes = new Uint8Array(16)
+  crypto.getRandomValues(bytes)
+  const hex = [...bytes].map(b => b.toString(16).padStart(2, '0')).join('')
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`
+}
+
+/** 国内版账号才能做这些任务；国际版没有这套活动体系。 */
+export function tasksSupported(credential) {
+  return credential.region !== 'global'
+}
+
+/**
+ * 签到。
+ *
+ * @returns {Promise<{status:'done'|'already'|'failed', message:string}>}
+ */
+export async function checkin(credential) {
+  if (!tasksSupported(credential)) {
+    return { status: 'skipped', message: '国际版账号无签到体系' }
+  }
+  try {
+    const result = await taskRequest(credential, CN_BILLING_BASE, CHECKIN_PATH, { method: 'POST', body: {} })
+    if (result.ok) return { status: 'done', message: '签到成功' }
+    // 重复签到是幂等成功，不能算失败。
+    if (isAlreadyCheckin(result.msg)) return { status: 'already', message: '今天已签到' }
+    return { status: 'failed', message: `code=${result.code} ${result.msg}` }
+  } catch (error) {
+    return { status: 'failed', message: `请求失败：${error?.message ?? error}` }
+  }
+}
+
+/** 签到后查一次余额，用于回报「签到带来多少积分」。 */
+export async function fetchResource(credential) {
+  try {
+    const result = await taskRequest(credential, CN_BILLING_BASE, RESOURCE_PATH, {
+      method: 'POST',
+      body: {
+        PageNumber: 1,
+        PageSize: 100,
+        ProductCode: 'p_tcaca',
+        Status: [0, 3],
+      },
+    })
+    if (!result.ok) return undefined
+    const accounts = result.data?.Response?.Data?.Accounts
+    if (!Array.isArray(accounts)) return undefined
+    let total = 0
+    for (const account of accounts) {
+      const remain = typeof account?.CapacityRemain === 'number' ? account.CapacityRemain : 0
+      if (remain > 0) total += remain
+    }
+    return total
+  } catch {
+    return undefined
+  }
+}
+
+/** 读连登信息：连续登录天数、下一档位还差几天、可兑换档位。 */
+export async function fetchStreak(credential) {
+  if (!tasksSupported(credential)) return undefined
+  try {
+    const result = await taskRequest(credential, chatBaseOf(credential.domain), STREAK_PATH)
+    if (!result.ok) return undefined
+    const streak = result.data?.streak
+    if (streak === undefined || streak === null) return undefined
+    // 兑换状态的权威判定：tier_*_status 由上游给（locked / 已解锁 / 已兑换）。
+    // 不用「天数 >= 门槛」自己算——上游还会考虑补签卡、月份重置等因素。
+    const redemption = result.data?.redemption_status ?? {}
+    const tiers = Array.isArray(redemption.tiers) ? redemption.tiers : []
+    const redeemable = tiers
+      .map(tier => ({
+        tier: String(tier?.tier ?? ''),
+        days: Number(tier?.days ?? 0),
+        status: String(redemption[`tier_${String(tier?.tier ?? '')}_status`] ?? 'unknown'),
+      }))
+      .filter(tier => tier.tier !== '')
+
+    return {
+      days: Number(streak.days ?? 0),
+      monthTotalDays: Number(streak.month_total_days ?? 0),
+      nextTier: streak.next_tier ?? null,
+      nextTierRemaining: Number(streak.next_tier_remaining ?? 0),
+      makeupCards: Number(result.data?.makeup_cards?.balance ?? 0),
+      // 可兑换的档位（status 不是 locked、也不是已兑换）
+      redeemable: redeemable.filter(t => t.status === 'unlocked' || t.status === 'available' || t.status === 'redeemable'),
+      tiers: redeemable,
+    }
+  } catch {
+    return undefined
+  }
+}
+
+/** 读 Buddy（猫）档案；没有猫返回 undefined。 */
+export async function fetchBuddy(credential) {
+  if (!tasksSupported(credential)) return undefined
+  try {
+    const result = await taskRequest(credential, chatBaseOf(credential.domain), BUDDY_INFO_PATH)
+    if (!result.ok) return undefined
+    const buddy = result.data?.buddy
+    if (buddy === undefined || buddy === null) return undefined
+    return {
+      id: Number(buddy.instance_id ?? 0),
+      name: String(buddy.name ?? ''),
+      rarity: String(buddy.rarity ?? ''),
+    }
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 只读：读猫猫旅行状态（不改动任何东西，供界面展示）。
+ * 与 {@link travel} 的区别是它只查不派、不领。
+ */
+export async function travelStatus(credential) {
+  if (!tasksSupported(credential)) return undefined
+  try {
+    const result = await taskRequest(credential, chatBaseOf(credential.domain), TRAVEL_STATUS_PATH)
+    if (!result.ok) return undefined
+    return {
+      state: String(result.data?.state ?? 'unknown'),
+      recordId: Number(result.data?.record_id ?? 0),
+      dailyLimitReached: result.data?.daily_limit_reached === true,
+      rewardCredit: Number(result.data?.reward_credit ?? 0) || undefined,
+    }
+  } catch {
+    return undefined
+  }
+}
+
+/** 读抽奖次数（只读）。 */
+export async function fetchLottery(credential) {
+  if (!tasksSupported(credential)) return undefined
+  try {
+    const result = await taskRequest(credential, chatBaseOf(credential.domain), LOTTERY_SUMMARY_PATH)
+    if (!result.ok) return undefined
+    return { chances: Number(result.data?.chances ?? 0) }
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 连登兑换：把已解锁的档位兑换掉（发积分/能量/补签卡/抽奖次数）。
+ *
+ * 档位按连续登录天数解锁（7/14/28 天）。未解锁的档位上游返回 403，
+ * 属于正常情况，不当作失败。
+ *
+ * @returns {Promise<{status:string, message:string, redeemed:string[]}>}
+ */
+export async function redeemTiers(credential) {
+  if (!tasksSupported(credential)) {
+    return { status: 'skipped', message: '国际版账号无连登体系', redeemed: [] }
+  }
+  const base = chatBaseOf(credential.domain)
+  const redeemed = []
+
+  // 先读状态，拿到各档位的解锁情况与已兑换次数。
+  const streakResult = await taskRequest(credential, base, STREAK_PATH)
+  if (!streakResult.ok) {
+    return { status: 'failed', message: `读连登失败：code=${streakResult.code}`, redeemed: [] }
+  }
+  const status = streakResult.data?.redemption_status
+
+  // 用上游给的 tier_<n>d_status 判定能否兑换，不自己比天数——
+  // 上游还会考虑补签卡、月份重置等因素，自己算会漏。
+  const tiers = Array.isArray(status?.tiers) ? status.tiers : []
+  for (const tier of tiers) {
+    const name = String(tier?.tier ?? '')
+    if (name === '') continue
+    const tierStatus = String(status?.[`tier_${name}_status`] ?? 'locked')
+    // 只兑换上游明确说可领的档位；locked / 已兑换都跳过
+    const redeemable = tierStatus === 'unlocked' || tierStatus === 'available' || tierStatus === 'redeemable'
+    if (!redeemable) continue
+
+    const result = await taskRequest(credential, base, REDEEM_PATH, {
+      method: 'POST',
+      body: { tier: name, client_token: clientToken() },
+    })
+    if (result.ok) redeemed.push(name)
+  }
+
+  const message = redeemed.length > 0 ? `已兑换 ${redeemed.join('、')}` : '暂无可兑换档位'
+  return { status: 'done', message, redeemed }
+}
+
+/**
+ * 把当前的抽奖次数全部抽掉。
+ *
+ * 抽奖次数只能从连登兑换获得，所以顺序上必须「先兑换、后抽奖」。
+ *
+ * @returns {Promise<{status:string, message:string, drawn:number}>}
+ */
+export async function drawLottery(credential) {
+  if (!tasksSupported(credential)) {
+    return { status: 'skipped', message: '国际版账号无抽奖体系', drawn: 0 }
+  }
+  const base = chatBaseOf(credential.domain)
+
+  const before = await fetchLottery(credential)
+  const remaining = before?.chances ?? 0
+  if (remaining <= 0) return { status: 'done', message: '无抽奖次数', drawn: 0 }
+
+  let drawn = 0
+  // 上限保护：避免上游计数异常时无限循环。
+  const maxDraws = Math.min(remaining, 50)
+  for (let i = 0; i < maxDraws; i += 1) {
+    const result = await taskRequest(credential, base, LOTTERY_DRAW_PATH, {
+      method: 'POST',
+      body: { client_token: clientToken() },
+    })
+    if (!result.ok) break
+    drawn += 1
+  }
+  return { status: 'done', message: `抽了 ${drawn} 次`, drawn }
+}
+
+/**
+ * 猫猫旅行：一次调用完成完整的「领奖 → 派出」状态机。
+ *
+ * 上游把旅行做成了三态：
+ *   - arrived   → 先领奖，再尝试派出（同一天可以领完再派）
+ *   - idle      → 直接派出
+ *   - traveling → 什么都不做（在途，等下次调用）
+ *
+ * @returns {Promise<{status:string, message:string, reward?:number}>}
+ */
+export async function travel(credential) {
+  if (!tasksSupported(credential)) {
+    return { status: 'skipped', message: '国际版账号无旅行体系' }
+  }
+  const base = chatBaseOf(credential.domain)
+
+  try {
+    // 先看状态。没猫的账号直接跳过（领养是另一个流程，不在每日任务范围）。
+    const status = await taskRequest(credential, base, TRAVEL_STATUS_PATH)
+    if (!status.ok) {
+      return { status: 'failed', message: `查状态失败：code=${status.code} ${status.msg}` }
+    }
+    const state = String(status.data?.state ?? 'unknown')
+    const recordId = Number(status.data?.record_id ?? 0)
+    const dailyLimitReached = status.data?.daily_limit_reached === true
+
+    const steps = []
+
+    // 1) 到站 → 领奖
+    let reward
+    if (state === 'arrived' && recordId > 0) {
+      const claim = await taskRequest(credential, base, TRAVEL_CLAIM_PATH, {
+        method: 'POST',
+        body: { record_id: recordId },
+      })
+      if (claim.ok) {
+        reward = Number(claim.data?.reward_credit ?? 0) || undefined
+        steps.push(`领奖 +${reward ?? 0}`)
+      } else if (isAlreadyCheckin(claim.msg) || /already|已领/.test(claim.msg)) {
+        steps.push('奖励已领')
+      } else {
+        steps.push(`领奖失败(code=${claim.code})`)
+      }
+    }
+
+    // 2) 空闲（或刚领完）→ 派出
+    if ((state === 'idle' || state === 'arrived') && !dailyLimitReached) {
+      const depart = await taskRequest(credential, base, TRAVEL_DEPART_PATH, {
+        method: 'POST',
+        body: { location_id: TRAVEL_LOCATION_ID },
+      })
+      if (depart.ok) steps.push('已派出')
+      else if (/limit|已派/.test(depart.msg)) steps.push('今日已派')
+      else steps.push(`派出失败(code=${depart.code})`)
+    } else if (dailyLimitReached) {
+      steps.push('今日已派')
+    } else if (state === 'traveling') {
+      steps.push('在途中')
+    }
+
+    if (steps.length === 0) steps.push(`状态 ${state}，无需操作`)
+    return { status: 'done', message: steps.join('，'), reward }
+  } catch (error) {
+    return { status: 'failed', message: `请求失败：${error?.message ?? error}` }
+  }
+}
+
+/**
+ * 对一个账号执行全部每日任务。
+ *
+ * 顺序有意义：签到会让冷却账号恢复，所以排在前面。
+ *
+ * @param {object} credential
+ * @returns {Promise<object>} 各任务的结果
+ */
+export async function runDailyTasks(credential) {
+  const out = { accountId: credential.id, nickname: credential.nickname ?? credential.uid }
+
+  // 签到
+  out.checkin = await checkin(credential)
+
+  // 签到后立刻看余额变化
+  const credits = await fetchResource(credential)
+  if (credits !== undefined) out.credits = credits
+
+  // 连登与猫（只读，用于展示）
+  const [streak, buddy] = await Promise.all([
+    fetchStreak(credential),
+    fetchBuddy(credential),
+  ])
+  if (streak !== undefined) out.streak = streak
+  if (buddy !== undefined) out.buddy = buddy
+
+  // 连登兑换（必须在抽奖之前：抽奖次数只能从兑换获得）
+  out.redeem = await redeemTiers(credential)
+
+  // 抽奖
+  out.lottery = await drawLottery(credential)
+
+  // 旅行
+  out.travel = await travel(credential)
+
+  return out
+}