koishi-plugin-haulmp-tools 1.0.0

package/lib/api/accountsApi.js

@@ -0,0 +1,43 @@
+// accounts.haulmp.com 账号服务（注册 / 设备码登录 / 找回密码共用的请求层）
+const { ACCOUNTS_BASE } = require('../util/constant')
+
+function cookiesOf(res) {
+  try {
+    if (typeof res.headers.getSetCookie === 'function') {
+      return res.headers.getSetCookie().map((c) => String(c).split(';')[0]).join('; ')
+    }
+    const raw = res.headers.get('set-cookie') || ''
+    return raw.split(',').map((c) => c.split(';')[0].trim()).filter(Boolean).join('; ')
+  } catch (e) {
+    return ''
+  }
+}
+
+async function request(url, { cookie, body } = {}) {
+  const headers = { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' }
+  if (cookie) headers.Cookie = cookie
+  if (body) {
+    headers['Content-Type'] = 'application/json'
+    headers.Origin = ACCOUNTS_BASE
+    headers.Referer = ACCOUNTS_BASE + '/'
+  }
+  const res = await fetch(url, {
+    method: body ? 'POST' : 'GET',
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+    signal: AbortSignal.timeout(15000),
+  })
+  const data = await res.json().catch(() => ({}))
+  return { status: res.status, data, cookies: cookiesOf(res) }
+}
+
+async function accountsApi(path, opts) {
+  return request(ACCOUNTS_BASE + path, opts)
+}
+
+async function registerAccount(handle, email, password) {
+  const s1 = await accountsApi('/api/session')
+  return accountsApi('/api/auth/register', { body: { handle, email, password }, cookie: s1.cookies })
+}
+
+module.exports = { request, accountsApi, registerAccount, cookiesOf }

package/lib/api/forumApi.js

@@ -0,0 +1,39 @@
+// HaulMP 论坛 API（资料 / 成员翻页 / 通知）
+const { fetchJson, fetchJsonMemo } = require('../util/common')
+const { FORUM_BASE } = require('../util/constant')
+const { request } = require('./accountsApi')
+
+async function fetchProfile(apiBase, key) {
+  const url = `${apiBase}/u/${encodeURIComponent(key)}`
+  let data = null
+  try {
+    data = await fetchJsonMemo(url, 300000)
+  } catch (e) {
+    await new Promise((r) => setTimeout(r, 1200))
+    data = await fetchJsonMemo(url, 300000).catch(() => null)
+  }
+  if (!data || data.error || !data.member || !data.member.handle) return null
+  return data
+}
+
+// 排行缓存构建用的成员翻页（带多重退避重试）
+async function fetchMembersPage(apiBase, page) {
+  const waits = [0, 2000, 5000, 10000]
+  for (let attempt = 0; attempt < waits.length; attempt++) {
+    if (waits[attempt]) await new Promise((r) => setTimeout(r, waits[attempt]))
+    let d = null
+    try {
+      d = await fetchJson(`${apiBase}/members?page=${page}`)
+    } catch (e) {
+      d = null
+    }
+    if (d && Array.isArray(d.members)) return d
+  }
+  return null
+}
+
+async function fetchNotifications(cookies) {
+  return request(`${FORUM_BASE}/api/forum/notifications?page=1`, { cookie: cookies })
+}
+
+module.exports = { fetchProfile, fetchMembersPage, fetchNotifications }

package/lib/api/vtcApi.js

@@ -0,0 +1,26 @@
+// HaulMP VTC API（车队信息 / 公告 / 登录态的驾驶数据）
+const { fetchJson } = require('../util/common')
+const { VTC_ROOT } = require('../util/constant')
+const { request } = require('./accountsApi')
+
+async function fetchCompany(config, slug) {
+  const d = await fetchJson(`${config.vtcBase}/public/company/${encodeURIComponent(slug)}`)
+  if (!d || !d.company || !Array.isArray(d.roster)) return null
+  return d
+}
+
+async function fetchAnnouncements(config, slug) {
+  const d = await fetchJson(`${config.vtcBase}/public/vtcs/${encodeURIComponent(slug)}`)
+  return (d && d.announcements) || []
+}
+
+// 登录态接口（我的行驶记录）
+async function driverMe(cookies) {
+  return request(`${VTC_ROOT}/api/driver/me`, { cookie: cookies })
+}
+
+async function gameStatus(cookies) {
+  return request(`${VTC_ROOT}/api/game/status`, { cookie: cookies }).catch(() => null)
+}
+
+module.exports = { fetchCompany, fetchAnnouncements, driverMe, gameStatus }

package/lib/command/announce.js

@@ -0,0 +1,151 @@
+const fs = require('fs')
+const path = require('path')
+const { renderCard, esc, isText, cardTheme, CARD_DECO } = require('../util/common')
+const { fetchAnnouncements } = require('../api/vtcApi')
+const { translateBatch } = require('../util/translate')
+
+function stateFile(ctx) {
+  return path.join(ctx.baseDir || process.cwd(), 'data', 'haulmp_company_ann.json')
+}
+
+function loadState(ctx) {
+  try {
+    return JSON.parse(fs.readFileSync(stateFile(ctx), 'utf8'))
+  } catch (e) {
+    return {}
+  }
+}
+
+function saveState(ctx, state) {
+  try {
+    fs.writeFileSync(stateFile(ctx), JSON.stringify(state, null, 1))
+  } catch (e) { /* ignore */ }
+}
+
+function fmtWhen(iso) {
+  if (!iso) return ''
+  const d = new Date(iso)
+  if (isNaN(d.getTime())) return ''
+  const t = new Date(d.getTime() + 8 * 3600 * 1000)
+  const p = (n) => String(n).padStart(2, '0')
+  return `${t.getUTCFullYear()}-${p(t.getUTCMonth() + 1)}-${p(t.getUTCDate())} ${p(t.getUTCHours())}:${p(t.getUTCMinutes())}`
+}
+
+// 🎨 设计提示词（车队公告）：车队长喇叭。琥珀暖光如封蜡火漆，徽记泛光，
+// 正文像正式通告，温暖、有人情味。底板为共享 ink 玻璃主题。
+function annCard(row, ann, titleCn, bodyCn) {
+  const title = titleCn || ann.title || '（无标题）'
+  const body = bodyCn || ann.body || ''
+  const tag = row.tag || 'VTC'
+  const initial = String(tag.replace(/[^A-Za-z0-9\u4e00-\u9fa5]/g, '')[0] || 'V').toUpperCase()
+  return `<!doctype html><html><head><meta charset="utf-8"><style>${cardTheme('#f59e0b', '#fbbf24', 720)}
+.head{display:flex;align-items:center;gap:14px;padding-bottom:16px;border-bottom:1px solid rgba(245,158,11,.18)}
+.ava{width:54px;height:54px;border-radius:13px;background:linear-gradient(150deg,rgba(245,158,11,.30),rgba(251,191,36,.12));border:1px solid rgba(245,158,11,.6);color:#ffd08a;font-weight:700;font-size:22px;display:flex;align-items:center;justify-content:center;flex:none;box-shadow:0 0 22px rgba(245,158,11,.3)}
+.who{flex:1;min-width:0}
+.kicker{font-size:13px;color:#c9a86a;letter-spacing:1px}
+.cname{font-size:20px;font-weight:700;color:#fff;margin-top:3px}
+.cname .tag{color:#ffd08a;font-size:13px;font-weight:600;margin-left:8px}
+.stamp{width:60px;height:60px;border:2px solid rgba(245,158,11,.7);border-radius:50%;color:#ffd08a;font-size:14px;font-weight:700;display:flex;align-items:center;justify-content:center;letter-spacing:3px;transform:rotate(-12deg);box-shadow:0 0 20px rgba(245,158,11,.28),inset 0 0 16px rgba(245,158,11,.15);flex:none}
+.title{margin-top:20px;font-size:20px;font-weight:700;color:#fff;line-height:1.5;padding-left:14px;border-left:3px solid rgba(245,158,11,.7);text-shadow:0 2px 14px rgba(245,158,11,.25)}
+.body{margin-top:12px;font-size:14.5px;line-height:1.95;color:#cdd9e6;white-space:pre-wrap;padding:13px 17px;background:var(--glass-lo);border:1px solid rgba(245,158,11,.14);border-radius:12px}
+.foot{margin-top:18px;padding-top:12px;border-top:1px solid rgba(245,158,11,.16);display:flex;justify-content:space-between;font-size:11.5px;color:#62748a}
+</style></head><body><div id="card">${CARD_DECO}
+<div class="head"><div class="ava">${esc(initial)}</div><div class="who"><div class="kicker">车队公告</div><div class="cname">${esc(row.name || row.slug)}<span class="tag">${esc(tag)}</span></div></div><div class="stamp">公告</div></div>
+<div class="title">${esc(title)}</div>
+<div class="body">${esc(body)}</div>
+<div class="foot"><span>发布者：${esc(ann.display_name || ann.handle || '—')} · ${fmtWhen(ann.created_at)}</span><span>自动推送 · 机器翻译仅供参考</span></div>
+</div></body></html>`
+}
+
+function annText(row, ann, titleCn, bodyCn) {
+  return `📢 ${row.name || row.slug} 车队公告\n${titleCn || ann.title || ''}\n\n${bodyCn || ann.body || ''}\n\n发布者：${ann.display_name || ann.handle || '—'} · ${fmtWhen(ann.created_at)}`
+}
+
+async function pushTo(ctx, rows, content) {
+  let sent = 0
+  for (const row of rows) {
+    try {
+      const idx = String(row.channelId).indexOf(':')
+      const platform = idx > 0 ? row.channelId.slice(0, idx) : row.platform
+      const id = idx > 0 ? row.channelId.slice(idx + 1) : row.channelId
+      const bot = ctx.bots.find((b) => b.platform === platform)
+      if (!bot) continue
+      await bot.sendMessage(id, content)
+      sent++
+    } catch (e) {
+      ctx.logger('haulmp').warn('公告推送失败（%s）: %s', row.channelId, e.message)
+    }
+  }
+  return sent
+}
+
+async function check(ctx, config) {
+  const logger = ctx.logger('haulmp')
+  let rows = []
+  try {
+    rows = await ctx.database.get('haulmp_company', {})
+  } catch (e) {
+    return
+  }
+  if (!rows || !rows.length) return
+
+  const bySlug = new Map()
+  for (const r of rows) {
+    if (!bySlug.has(r.slug)) bySlug.set(r.slug, [])
+    bySlug.get(r.slug).push(r)
+  }
+
+  const state = loadState(ctx)
+  let changed = false
+
+  for (const [slug, group] of bySlug) {
+    let ann = []
+    try {
+      ann = await fetchAnnouncements(config, slug)
+    } catch (e) {
+      continue
+    }
+    if (!ann.length) continue
+    const latest = ann.reduce((a, b) => (new Date(b.created_at || 0) > new Date(a.created_at || 0) ? b : a))
+    const prev = state[slug]
+    if (!prev) {
+      state[slug] = { id: latest.id, at: Date.now() }
+      changed = true
+      logger.info('首次记录车队公告 %s（不推送）', slug)
+      continue
+    }
+    if (prev.id === latest.id) continue
+
+    state[slug] = { id: latest.id, at: Date.now() }
+    changed = true
+
+    let titleCn = ''
+    let bodyCn = ''
+    try {
+      const parts = await translateBatch([latest.title || '', latest.body || ''])
+      if (parts && parts.length === 2) {
+        if (parts[0] && parts[0] !== latest.title) titleCn = parts[0]
+        if (parts[1] && parts[1] !== latest.body) bodyCn = parts[1]
+      }
+    } catch (e) { /* 用原文 */ }
+
+    const row = group[0]
+    let content = annText(row, latest, titleCn, bodyCn)
+    if (!isText(config, 'announce')) {
+      const card = await renderCard(ctx, annCard(row, latest, titleCn, bodyCn))
+      if (card) content = card
+    }
+    const sent = await pushTo(ctx, group, content)
+    logger.info('车队公告推送 %s「%s」→ %d 个群', slug, String(latest.title || '').slice(0, 30), sent)
+  }
+
+  if (changed) saveState(ctx, state)
+}
+
+function apply(ctx, config) {
+  const run = () => check(ctx, config).catch((e) => ctx.logger('haulmp').warn('车队公告检测异常: %s', e.message))
+  setTimeout(run, 60000)
+  ctx.setInterval(run, 10 * 60 * 1000)
+}
+
+module.exports = { apply, check, annCard, annText }

package/lib/command/bind.js

@@ -0,0 +1,100 @@
+const { bindingQuery, esc, avatarUrl, resolveAvatar, renderCard, isText, cardTheme, CARD_DECO } = require('../util/common')
+const { fetchProfile } = require('../api/forumApi')
+
+// 🎨 设计提示词（绑定成功）：成就解锁。翡翠绿庆典氛围，光环扩散 + 勾选徽记居中，
+// 光线收束到姓名，像游戏通关结算界面。底板用共享 ink 玻璃主题（深墨蓝 + 扫描线）。
+const CARD_CSS = cardTheme('#3aa86f', '#7fd4a0', 640) + `
+.hero{position:relative;height:150px;margin:-26px -28px 0;background:linear-gradient(120deg,rgba(58,168,111,.42),rgba(45,212,191,.24) 60%,rgba(7,16,26,.05));overflow:hidden}
+.hero::after{content:'';position:absolute;inset:0;background:radial-gradient(circle at 50% 135%,rgba(255,255,255,.20),transparent 60%)}
+.avatar{width:104px;height:104px;border-radius:50%;object-fit:cover;border:3px solid #14283b;background:#0f2233;box-shadow:0 0 0 3px rgba(94,211,154,.45),0 12px 40px rgba(0,0,0,.5),0 0 44px rgba(58,168,111,.4)}
+.avatar.ph{display:flex;align-items:center;justify-content:center;margin:0 auto;font-size:40px;font-weight:700;color:#dff8ea;background:linear-gradient(150deg,rgba(58,168,111,.45),rgba(45,212,191,.35))}
+h1{color:#fff;font-size:26px;margin-top:16px;letter-spacing:6px;text-align:center;text-shadow:0 2px 20px rgba(58,168,111,.4)}
+.uline{width:60px;height:3px;margin:11px auto 0;border-radius:2px;background:linear-gradient(90deg,transparent,var(--ac),transparent);box-shadow:0 0 12px var(--ac)}
+.name{margin-top:16px;font-size:25px;color:#fff;font-weight:700;text-align:center}
+.handle{font-size:14px;color:#9cc6f0;text-align:center;margin-top:4px}
+.ribbon{display:flex;gap:8px;justify-content:center;flex-wrap:wrap;margin-top:18px}
+.rchip{font-size:12.5px;color:#cfe3f7;background:var(--glass);border:1px solid var(--stroke-hi);border-radius:999px;padding:5px 14px;box-shadow:inset 0 1px 0 rgba(255,255,255,.07)}
+.rchip b{color:#fff}
+.hint{margin-top:18px;font-size:13px;color:#8ba0b5;line-height:1.85;text-align:center}
+.hint b{color:#cdd9e6}
+.foot{margin-top:22px;padding-top:13px;border-top:1px solid rgba(94,211,154,.16);display:flex;justify-content:space-between;font-size:12px;color:#62748a}
+`
+
+function successCard(member, session, avatarSrc) {
+  const m = member
+  const src = avatarSrc !== undefined ? avatarSrc : avatarUrl(m.avatar)
+  const avatarEl = src
+    ? `<img class="avatar" src="${esc(src)}">`
+    : `<div class="avatar ph">${esc((m.displayName || m.handle || '?').slice(0, 1))}</div>`
+  return `<!doctype html>
+<html><head><meta charset="utf-8"><style>${CARD_CSS}</style></head><body><div id="card">${CARD_DECO}
+<div class="hero"></div>
+<div style="text-align:center;margin-top:-72px;position:relative;z-index:3">${avatarEl}</div>
+<h1>绑定成功</h1>
+<div class="uline"></div>
+<div class="name">${esc(m.displayName || m.handle)}</div>
+<div class="handle">@${esc(m.handle)}</div>
+<div class="ribbon"><span class="rchip">QQ <b>${esc(session.userId)}</b></span>${m.company ? `<span class="rchip">车队 <b>${esc(m.company.name)} [${esc(m.company.tag)}]</b></span>` : ''}</div>
+<div class="hint">发送「查询H」查看完整资料 · 发送「解绑H」解除绑定</div>
+<div class="foot"><span>HaulMP Forums</span><span>forum.haulmp.com</span></div>
+</div></body></html>`
+}
+
+function apply(ctx, config) {
+  ctx.command('绑定H <handle>', '绑定 HaulMP 论坛账号')
+    .alias('bindh', '绑定h')
+    .usage('示例：绑定H 123456')
+    .action(async ({ session }, handle) => {
+      if (!session) return
+      const key = String(handle || '').trim().replace(/^@+/, '')
+      if (!key) return '请输入要绑定的 ID，例如：绑定H 123456'
+
+      const [exist] = await ctx.database.get('haulmp_binding', bindingQuery(session))
+      if (exist) {
+        return `你已经绑定过 ${exist.displayName}（@${exist.handle}）了，如需更换请先发送「解绑H」`
+      }
+
+      let data
+      try {
+        data = await fetchProfile(config.apiBase, key)
+      } catch (e) {
+        ctx.logger('haulmp').warn('绑定查询失败: %s', e.message)
+        return '查询失败，请稍后再试'
+      }
+      if (!data) return `没找到用户「${key}」，请检查 ID 是否正确`
+
+      const m = data.member
+      await ctx.database.create('haulmp_binding', {
+        ...bindingQuery(session),
+        handle: m.handle,
+        displayName: m.displayName || m.handle,
+        forumId: m.id || '',
+        boundAt: new Date(),
+      })
+
+      if (!isText(config, 'bind')) {
+        const card = await renderCard(ctx, successCard(m, session, await resolveAvatar(m)))
+        if (card) return card
+      }
+      return `${m.displayName || m.handle} 绑定成功！`
+    })
+
+  ctx.command('我的绑定H', '查看已绑定的 HaulMP 账号')
+    .alias('我的绑定h')
+    .action(async ({ session }) => {
+      if (!session) return
+      const [b] = await ctx.database.get('haulmp_binding', bindingQuery(session))
+      if (!b) return '你还没有绑定，发送「绑定H 你的ID」即可绑定'
+      return `你绑定的是 ${b.displayName}（@${b.handle}）`
+    })
+
+  ctx.command('解绑H', '解除 HaulMP 账号绑定')
+    .alias('解绑h')
+    .action(async ({ session }) => {
+      if (!session) return
+      const res = await ctx.database.remove('haulmp_binding', bindingQuery(session))
+      return res && res.removed ? '已解绑' : '你还没有绑定'
+    })
+}
+
+module.exports = { apply, successCard }

package/lib/command/changelog.js

@@ -0,0 +1,177 @@
+const fs = require('fs')
+const path = require('path')
+const { renderCard, esc, fetchJson, isText, cardTheme, CARD_DECO } = require('../util/common')
+const { translateBatch } = require('../util/translate')
+
+const STATUS_API = 'https://haulmp.com/api/status'
+
+function statePath(ctx) {
+  return path.join(ctx.baseDir, 'data', 'haulmp_client.json')
+}
+
+function loadState(ctx) {
+  try {
+    return JSON.parse(fs.readFileSync(statePath(ctx), 'utf8'))
+  } catch (e) {
+    return null
+  }
+}
+
+function saveState(ctx, state) {
+  try {
+    const p = statePath(ctx)
+    fs.mkdirSync(path.dirname(p), { recursive: true })
+    fs.writeFileSync(p, JSON.stringify(state, null, 1))
+  } catch (e) { /* ignore */ }
+}
+
+function fmtBytes(v) {
+  if (v == null || isNaN(v)) return '—'
+  const n = Number(v)
+  if (n < 1024) return `${n} B`
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`
+  return `${(n / 1024 / 1024).toFixed(1)} MB`
+}
+
+function fmtPublished(iso) {
+  if (!iso) return ''
+  const d = new Date(iso)
+  if (isNaN(d.getTime())) return ''
+  const t = new Date(d.getTime() + 8 * 3600 * 1000)
+  const p = (n) => String(n).padStart(2, '0')
+  return `${t.getUTCFullYear()}-${p(t.getUTCMonth() + 1)}-${p(t.getUTCDate())} ${p(t.getUTCHours())}:${p(t.getUTCMinutes())}`
+}
+
+// 🎨 设计提示词（客户端更新）：信号塔通报。冰蓝数据流，版本徽章自带辉光，
+// 像新固件在空中广播，干净、科技、可信。底板为共享 ink 玻璃主题。
+function updateCard(status, notesCn, oldVersion) {
+  const notes = notesCn || status.notes || '（本次更新无说明）'
+  const nm = String(status.notes || '').match(/HaulMP\s+([\d.]+)/i)
+  const verName = nm ? nm[1] : ''
+  return `<!doctype html><html><head><meta charset="utf-8"><style>${cardTheme('#38bdf8', '#22d3ee', 720)}
+.head{display:flex;align-items:baseline;justify-content:space-between;padding-bottom:15px;border-bottom:1px solid rgba(56,189,248,.16)}
+.title{font-size:24px;font-weight:700;color:#fff;letter-spacing:1px}
+.brand{color:#6f9bb3;font-size:13px;font-weight:700;letter-spacing:2px}
+.verline{display:flex;align-items:center;gap:14px;margin-top:18px}
+.vold{color:#8ba0b5;font-size:15px;padding:6px 13px;border:1px solid var(--stroke-hi);border-radius:10px}
+.arrow{color:#38bdf8;font-size:19px;font-weight:700;text-shadow:0 0 12px rgba(56,189,248,.7)}
+.vname{font-size:15px;font-weight:700;color:#9bdcff;background:rgba(56,189,248,.14);border:1px solid rgba(56,189,248,.45);border-radius:999px;padding:5px 13px;box-shadow:0 0 16px rgba(56,189,248,.2)}
+.vnew{font-size:22px;font-weight:800;color:#9bdcff;padding:6px 17px;background:linear-gradient(180deg,rgba(56,189,248,.25),rgba(56,189,248,.10));border:1px solid rgba(56,189,248,.55);border-radius:12px;box-shadow:0 0 26px rgba(56,189,248,.32)}
+.vinfo{margin-left:auto;color:#8ba0b5;font-size:12.5px;text-align:right;line-height:1.7}
+.notes{margin-top:16px;padding:14px 18px;background:var(--glass-lo);border:1px solid rgba(56,189,248,.16);border-left:3px solid rgba(56,189,248,.65);border-radius:10px;font-size:14.5px;line-height:1.9;color:#cdd9e6;white-space:pre-wrap}
+.foot{margin-top:18px;padding-top:12px;border-top:1px solid rgba(56,189,248,.16);display:flex;justify-content:space-between;font-size:11.5px;color:#62748a}
+</style></head><body><div id="card">${CARD_DECO}
+<div class="head"><span class="title">HaulMP 客户端更新</span><span class="brand">RELEASE</span></div>
+<div class="verline">${oldVersion ? `<span class="vold">v${oldVersion}</span><span class="arrow">→</span>` : ''}<span class="vnew">v${status.version}</span>${verName ? `<span class="vname">HaulMP ${verName}</span>` : ''}<span class="vinfo">发布于 ${fmtPublished(status.publishedAt) || '—'}<br>${fmtBytes(status.bytes)}</span></div>
+<div class="notes">${esc(notes)}</div>
+<div class="foot"><span>HaulMP · haulmp.com</span><span>自动推送 · 机器翻译仅供参考</span></div>
+</div></body></html>`
+}
+
+function textFallback(status, notesCn, oldVersion) {
+  const notes = notesCn || status.notes || '（本次更新无说明）'
+  const nm4 = String(status.notes || '').match(/HaulMP\s+([\d.]+)/i)
+  return `📦 HaulMP 客户端更新${oldVersion ? ` v${oldVersion} → v${status.version}` : ` v${status.version}`}${nm4 ? `（HaulMP ${nm4[1]}）` : ''}\n发布于：${fmtPublished(status.publishedAt)} · ${fmtBytes(status.bytes)}\n\n${notes}`
+}
+
+async function broadcast(ctx, config, content) {
+  let sent = 0
+  const only = String((config && config.pushChannels) || '').split(',').map((s) => s.trim()).filter(Boolean)
+  if (only.length) {
+    for (const ch of only) {
+      const idx = ch.indexOf(':')
+      const platform = idx > 0 ? ch.slice(0, idx) : 'onebot'
+      const id = idx > 0 ? ch.slice(idx + 1) : ch
+      const bot = ctx.bots.find((b) => b.platform === platform)
+      if (!bot) continue
+      try {
+        await bot.sendMessage(id, content)
+        sent++
+      } catch (e) {
+        ctx.logger('haulmp').warn('更新推送失败（%s）: %s', ch, e.message)
+      }
+    }
+    return sent
+  }
+  const bots = ctx.bots.filter((b) => b.platform === 'onebot')
+  for (const bot of bots) {
+    try {
+      const res = await bot.getGuildList()
+      const groups = (res && res.data) || res || []
+      for (const g of groups) {
+        const channelId = g.id != null ? g.id : g.guildId
+        if (channelId == null) continue
+        try {
+          await bot.sendMessage(String(channelId), content)
+          sent++
+        } catch (e) {
+          ctx.logger('haulmp').warn('更新推送失败（群 %s）: %s', channelId, e.message)
+        }
+      }
+    } catch (e) {
+      ctx.logger('haulmp').warn('获取群列表失败: %s', e.message)
+    }
+  }
+  return sent
+}
+
+async function check(ctx, config) {
+  const logger = ctx.logger('haulmp')
+  let client
+  try {
+    const d = await fetchJson(STATUS_API)
+    client = d && d.client
+  } catch (e) {
+    return
+  }
+  if (!client || client.version == null) return
+
+  const state = loadState(ctx)
+  if (!state || state.version == null) {
+    saveState(ctx, {
+      version: client.version,
+      notes: client.notes || '',
+      bytes: client.bytes,
+      publishedAt: client.publishedAt,
+      seenAt: Date.now(),
+    })
+    logger.info('首次记录客户端版本 v%s（不推送）', client.version)
+    return
+  }
+  if (state.version === client.version) return
+
+  let notesCn = ''
+  if (client.notes) {
+    try {
+      const parts = await translateBatch([client.notes])
+      if (parts && parts[0]) notesCn = parts[0]
+    } catch (e) {
+      notesCn = ''
+    }
+  }
+
+  saveState(ctx, {
+    version: client.version,
+    notes: client.notes || '',
+    notesCn,
+    bytes: client.bytes,
+    publishedAt: client.publishedAt,
+    pushedAt: Date.now(),
+  })
+
+  let content = textFallback(client, notesCn, state.version)
+  if (!isText(config, 'changelog')) {
+    const card = await renderCard(ctx, updateCard(client, notesCn, state.version))
+    if (card) content = card
+  }
+  const sent = await broadcast(ctx, config, content)
+  logger.info('客户端更新 v%s → v%s，已推送到 %d 个群', state.version, client.version, sent)
+}
+
+function apply(ctx, config) {
+  const run = () => check(ctx, config).catch((e) => ctx.logger('haulmp').warn('更新检测异常: %s', e.message))
+  setTimeout(run, 45000)
+  ctx.setInterval(run, 10 * 60 * 1000)
+}
+
+module.exports = { apply, check, updateCard, textFallback, broadcast }