koishi-plugin-dwrgbwiki 1.0.0

package/index.js

@@ -0,0 +1,77 @@
+'use strict'
+
+const { Schema, h } = require('koishi')
+const lib = require('./lib')
+
+const HELP = lib.buildHelp()
+
+module.exports = {
+  name: 'dwrgbwiki',
+  description: '第五人格BWIKI编辑组测试用组件，纯AI生成喵',
+
+  Config: Schema.object({
+    dataSource: Schema.string()
+      .description('数据源地址，可在两个镜像站点之间切换：' + lib.KNOWN_SOURCES.join(' / '))
+      .default('https://website.homeworkkun.top'),
+    tryAlternate: Schema.boolean()
+      .description('主数据源失败时自动尝试备用数据源')
+      .default(true),
+    defaultPart: Schema.union(['8', '-127'])
+      .description('默认段位（8=巅七，-127=全段位）')
+      .default('8'),
+    showBadge: Schema.boolean()
+      .description('显示勋章分数据（获取失败时自动隐藏）')
+      .default(true),
+    badgeDays: Schema.number().min(1).max(365)
+      .description('勋章日增长率天数')
+      .default(7),
+    width: Schema.number().min(400).max(4000)
+      .description('图片宽度（px）')
+      .default(1000),
+    scale: Schema.number().min(1).max(4)
+      .description('截图倍率（越大越清晰）')
+      .default(2),
+    timeout: Schema.number().min(3000).max(60000)
+      .description('网络请求超时（毫秒）')
+      .default(15000),
+  }),
+
+  apply(ctx, config) {
+    ctx.command('胜率 <角色名> [条件:text]', '查询角色胜率并生成图片')
+      .usage(HELP)
+      .example('胜率 小女孩')
+      .example('胜率 小女孩 第43赛季 第3周 使用率')
+      .example('胜率 小女孩 43 3 胜率')
+      .action(async ({ session }, name, cond) => {
+        if (!name || !name.trim()) return HELP
+        if (!ctx.puppeteer) {
+          return '未检测到 puppeteer 服务，请先安装并启用 koishi-plugin-puppeteer'
+        }
+        try {
+          const result = await lib.collect(config, name.trim(), cond)
+          if (!result.ok) return result.error
+          const html = lib.buildHtml(result, { ...config, avatarBase: result.base })
+          const image = await capture(ctx, html, config)
+          return [h.image(image)]
+        } catch (e) {
+          ctx.logger('dwrgbwiki').warn(e)
+          return '查询失败：' + (e && e.message ? e.message : e)
+        }
+      })
+  },
+}
+
+async function capture(ctx, html, config) {
+  const page = await ctx.puppeteer.page()
+  try {
+    await page.setViewport({ width: config.width, height: 400, deviceScaleFactor: config.scale })
+    await page.setContent(html, { waitUntil: 'load' })
+    await page.waitForFunction(() => Array.from(document.images).every(i => i.complete), {
+      timeout: 15000,
+      polling: 200,
+    }).catch(() => {})
+    return await page.screenshot({ type: 'png', fullPage: true })
+  } finally {
+    await page.close().catch(() => {})
+  }
+}

package/lib.js

@@ -0,0 +1,729 @@
+'use strict'
+
+const KNOWN_SOURCES = [
+  'https://website.homeworkkun.top',
+  'https://web.homeworkkun.top',
+]
+
+const METRICS = {
+  win_rate_without_draw: '去平胜率',
+  win_rate: '胜率',
+  ping_rate: '平率',
+  lose_rate: '负率',
+  use_rate: '使用率',
+  ban_rate: '禁用率',
+}
+
+const BADGE_TIERS = [
+  { key: '1', label: 'S1', cls: 'tier-s' },
+  { key: '10', label: 'S10', cls: 'tier-s' },
+  { key: '11', label: 'A11', cls: 'tier-a' },
+  { key: '100', label: 'A100', cls: 'tier-a' },
+  { key: '101', label: 'B101', cls: 'tier-b' },
+  { key: '300', label: 'B300', cls: 'tier-b' },
+  { key: '301', label: 'C301', cls: 'tier-c' },
+  { key: '500', label: 'C500', cls: 'tier-c' },
+]
+
+const PARTS = { 1: '一阶', 2: '二阶', 3: '三阶', 4: '四阶', 5: '五阶', 6: '六阶', 7: '七阶', 8: '巅七', '-127': '全段位' }
+const PART_ORDER = [8, 7, 6, 5, 4, 3, 2, 1]
+
+const RATE_METRICS = ['win_rate_without_draw', 'win_rate', 'ping_rate', 'lose_rate', 'use_rate', 'ban_rate']
+
+const METRIC_LABELS = {}
+Object.keys(METRICS).forEach(k => { METRIC_LABELS[METRICS[k]] = k })
+
+const CACHE_TTL = 15 * 60 * 1000
+const cache = new Map()
+
+// ===== 基础工具 =====
+
+function esc(s) {
+  return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
+}
+
+function url(base, path) {
+  return base.replace(/\/+$/, '') + encodeURI(path)
+}
+
+function loseRate(w, p) {
+  if (w == null || p == null || isNaN(w) || isNaN(p)) return null
+  return Math.max(0, 1 - w - p)
+}
+
+function winRateNoDraw(w, p) {
+  const l = loseRate(w, p)
+  if (l == null) return null
+  const t = w + l
+  return t > 0 ? w / t : 0
+}
+
+function getMetricVal(item, metric, badgeScores) {
+  if (metric.startsWith('badge_')) {
+    const tier = metric.slice(5)
+    const s = badgeScores && badgeScores[item.name] ? badgeScores[item.name][tier] : null
+    return s == null || isNaN(s) ? null : s
+  }
+  switch (metric) {
+    case 'win_rate_without_draw': return winRateNoDraw(item.win_rate, item.ping_rate)
+    case 'win_rate': return item.win_rate
+    case 'ping_rate': return item.ping_rate
+    case 'lose_rate': return loseRate(item.win_rate, item.ping_rate)
+    case 'use_rate': return item.use_rate
+    case 'ban_rate': return item.ban_rate
+    default: return null
+  }
+}
+
+function fmtPct(v) {
+  return v == null || isNaN(v) ? '--' : (v * 100).toFixed(2) + '%'
+}
+
+function fmtGrowth(v) {
+  if (v == null || isNaN(v)) return { text: '--', cls: '' }
+  const cls = v > 1 ? 'up' : (v < -1 ? 'down' : '')
+  return { text: (v > 0 ? '+' : '') + v.toFixed(1) + '%', cls }
+}
+
+function metricLabel(metric) {
+  if (METRICS[metric]) return METRICS[metric]
+  const m = metric.match(/^badge_(.+)$/)
+  if (m) {
+    const t = BADGE_TIERS.find(x => x.key === m[1])
+    return (t ? t.label : m[1]) + '勋章分'
+  }
+  return metric
+}
+
+function dateTo8(d) { return d < 20000000 ? d + 20000000 : d }
+
+function dateAddDays(dateInt, days) {
+  const y = Math.floor(dateInt / 10000), m = Math.floor((dateInt % 10000) / 100), d = dateInt % 100
+  const dt = new Date(y, m - 1, d)
+  dt.setDate(dt.getDate() + days)
+  return parseInt(dt.getFullYear() + String(dt.getMonth() + 1).padStart(2, '0') + String(dt.getDate()).padStart(2, '0'))
+}
+
+function dateDiffDays(a, b) {
+  const y1 = Math.floor(a / 10000), m1 = Math.floor((a % 10000) / 100), d1 = a % 100
+  const y2 = Math.floor(b / 10000), m2 = Math.floor((b % 10000) / 100), d2 = b % 100
+  return Math.floor((new Date(y2, m2 - 1, d2) - new Date(y1, m1 - 1, d1)) / 86400000)
+}
+
+// 与 animationshow.html 相同的逻辑：当前日期在上赛季对应的同一天
+function seasonComparisonDate(cur, seasonList) {
+  const seasons = []
+  Object.keys(seasonList).forEach(name => {
+    const m = seasonList[name].match(/(\d{6})/)
+    if (m) seasons.push({ name, end: dateTo8(parseInt(m[1])) })
+  })
+  seasons.sort((a, b) => a.end - b.end)
+  seasons.forEach((s, j) => { s.start = j === 0 ? dateAddDays(s.end, -60) : dateAddDays(seasons[j - 1].end, 1) })
+  let idx = -1
+  seasons.forEach((s, k) => { if (idx < 0 && cur >= s.start && cur <= s.end) idx = k })
+  if (idx <= 0) return dateAddDays(cur, -90)
+  const prev = seasons[idx - 1]
+  const curDays = dateDiffDays(seasons[idx].start, cur) + 1
+  const prevDays = dateDiffDays(prev.start, prev.end) + 1
+  return dateAddDays(prev.start, Math.min(curDays, prevDays) - 1)
+}
+
+// ===== 请求与缓存 =====
+
+async function fetchText(fullUrl, timeout) {
+  const hit = cache.get(fullUrl)
+  if (hit && Date.now() - hit.ts < hit.ttl) return hit.text
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), timeout)
+  try {
+    const res = await fetch(fullUrl, { signal: ctrl.signal })
+    if (!res.ok) throw new Error('HTTP ' + res.status + ' ' + fullUrl)
+    const text = await res.text()
+    cache.set(fullUrl, { text, ts: Date.now(), ttl: CACHE_TTL })
+    return text
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+async function fetchJson(fullUrl, timeout) {
+  return JSON.parse(await fetchText(fullUrl, timeout))
+}
+
+// ===== 参数解析 =====
+
+function parseArgs(rest) {
+  const tokens = String(rest || '').trim().split(/\s+/).filter(Boolean)
+  const r = { season: null, week: null, part: null, metric: null, seasonFull: false }
+  tokens.forEach(t => {
+    let m
+    if (t === '全赛季' || t === '全季') { r.seasonFull = true; return }
+    if (t === '全段位' || t === '全') { r.part = -127; return }
+    if ((m = t.match(/^第?\s*(\d{1,3})\s*赛季$/i))) { r.season = m[1]; return }
+    if ((m = t.match(/^s\s*(\d{1,3})\s*赛季$/i))) { r.season = m[1]; return }
+    if ((m = t.match(/^s\s*(\d{1,3})$/i))) { r.season = m[1]; return }
+    if ((m = t.match(/^第?\s*(\d{1,2})\s*周$/))) { r.week = m[1]; return }
+    if (METRIC_LABELS[t]) { r.metric = METRIC_LABELS[t]; return }
+    const pm = Object.keys(PARTS).find(k => PARTS[k] === t)
+    if (pm != null) { r.part = parseInt(pm); return }
+    if ((m = t.match(/^(S10|S1|A11|A100|B101|B300|C301|C500)\s*勋章分$/))) {
+      const tier = BADGE_TIERS.find(x => x.label === m[1])
+      r.metric = 'badge_' + tier.key
+      return
+    }
+    if ((m = t.match(/^(\d{1,3})$/))) {
+      const n = parseInt(m[1])
+      if (r.season == null && n >= 20) { r.season = String(n); return }
+      if (r.week == null) { r.week = String(n); return }
+    }
+  })
+  return r
+}
+
+function findSeasonKey(seasonList, q) {
+  const m = String(q).trim().match(/^s?\s*(\d{1,3})$/i)
+  if (!m) return null
+  const n = parseInt(m[1])
+  return Object.keys(seasonList).find(k => {
+    const km = k.match(/^第(\d+)赛季$/)
+    return km && parseInt(km[1]) === n
+  }) || null
+}
+
+function prevSeasonKey(sn) {
+  const m = String(sn).match(/第(\d+)赛季/)
+  return m ? '第' + (parseInt(m[1]) - 1) + '赛季' : null
+}
+
+// ===== 数据加载 =====
+
+async function loadMeta(base, timeout) {
+  const text = await fetchText(url(base, '/胜率数据/js/season.js'), timeout)
+  const ex = new Function(text + '\n;return { seasonList, latestSeason, weekList }')()
+  if (!ex || typeof ex.seasonList !== 'object') throw new Error('赛季列表解析失败')
+  return ex
+}
+
+async function resolveSource(config) {
+  const primary = (config.dataSource || KNOWN_SOURCES[0]).replace(/\/+$/, '')
+  const candidates = []
+  if (!candidates.includes(primary)) candidates.push(primary)
+  if (config.tryAlternate) {
+    KNOWN_SOURCES.forEach(s => {
+      const x = s.replace(/\/+$/, '')
+      if (!candidates.includes(x)) candidates.push(x)
+    })
+  }
+  let lastErr = null
+  for (const base of candidates) {
+    try {
+      return { base, meta: await loadMeta(base, config.timeout) }
+    } catch (e) {
+      lastErr = e
+    }
+  }
+  throw lastErr || new Error('无法连接数据源')
+}
+
+async function loadSeasonData(base, file, timeout) {
+  const j = await fetchJson(url(base, '/胜率数据/json/' + file), timeout)
+  return j.data || []
+}
+
+async function loadBadgeFiles(base, timeout) {
+  const text = await fetchText(url(base, '/胜率数据/日数据/js/fileList.js'), timeout)
+  const m = text.match(/\[([\s\S]*)\]/)
+  if (!m) return []
+  let files = []
+  try { files = new Function('return [' + m[1] + ']')() } catch (e) { return [] }
+  return files.filter(f => typeof f === 'string' && /^Badge_\d{8}\.json$/.test(f)).sort()
+}
+
+async function loadBadgeMap(base, file, timeout) {
+  const j = await fetchJson(url(base, '/胜率数据/日数据/json/' + file), timeout)
+  const map = {}, camps = {}
+  ;(j.data || []).forEach(item => {
+    if (!map[item.hero_name]) {
+      map[item.hero_name] = {}
+      camps[item.hero_name] = String(item.camp_id)
+    }
+    map[item.hero_name][item.rn] = parseInt(String(item.score).replace(/,/g, '')) || 0
+  })
+  return { map, camps }
+}
+
+function pickBadgeFile(files, targetDate, maxDiff) {
+  let best = null, bestDiff = Infinity
+  files.forEach(f => {
+    const d = parseInt(f.replace('Badge_', '').replace('.json', ''))
+    const diff = Math.abs(d - targetDate)
+    if (diff < bestDiff) { bestDiff = diff; best = f }
+  })
+  if (!best || bestDiff > maxDiff) return null
+  return best
+}
+
+async function loadBadgeAll(base, config, meta, dataFile) {
+  const files = await loadBadgeFiles(base, config.timeout)
+  if (!files.length) return null
+  const fm = String(dataFile).match(/(\d{6})/)
+  const endDate = fm ? dateTo8(parseInt(fm[1])) : null
+  if (!endDate) return null
+  const curFile = pickBadgeFile(files, endDate, 90)
+  if (!curFile) return null
+  const cur = await loadBadgeMap(base, curFile, config.timeout)
+  const short = f => f.replace('Badge_', '').replace('.json', '')
+  let prev = null, prevDate = null
+  const prevFile = pickBadgeFile(files, seasonComparisonDate(parseInt(short(curFile)), meta.seasonList), 90)
+  if (prevFile) {
+    prev = await loadBadgeMap(base, prevFile, config.timeout)
+    prevDate = short(prevFile)
+  }
+  let daily = null, dailyDate = null
+  const dailyFile = pickBadgeFile(files, dateAddDays(parseInt(short(curFile)), -config.badgeDays), 90)
+  if (dailyFile) {
+    daily = await loadBadgeMap(base, dailyFile, config.timeout)
+    dailyDate = short(dailyFile)
+  }
+  return {
+    map: cur.map, camps: cur.camps, curDate: short(curFile),
+    prevMap: prev ? prev.map : null, prevDate,
+    dailyMap: daily ? daily.map : null, dailyDate,
+  }
+}
+
+// ===== 数据计算 =====
+
+function uniqueBy(data, camp, part) {
+  const seen = new Set(), unq = []
+  data.forEach(d => {
+    if (d.camp_id === camp && d.part === part && !seen.has(d.name)) {
+      seen.add(d.name)
+      unq.push(d)
+    }
+  })
+  return unq
+}
+
+function sortDesc(unq, metric, badgeScores) {
+  return unq.slice().sort((a, b) => {
+    const va = getMetricVal(a, metric, badgeScores), vb = getMetricVal(b, metric, badgeScores)
+    return (vb == null ? -Infinity : vb) - (va == null ? -Infinity : va)
+  })
+}
+
+function rankMap(sorted) {
+  const map = {}
+  sorted.forEach((d, i) => { map[d.name] = i + 1 })
+  return map
+}
+
+function campAvg(data, camp, part) {
+  const fd = data.filter(d => d.camp_id === camp && d.part === part)
+  let tu = 0
+  fd.forEach(d => { tu += d.use_rate || 0 })
+  if (!tu) return null
+  let ww = 0, wp = 0
+  fd.forEach(d => {
+    const w = (d.use_rate || 0) / tu
+    ww += (d.win_rate || 0) * w
+    wp += (d.ping_rate || 0) * w
+  })
+  return { win_rate: ww, ping_rate: wp }
+}
+
+function computeCard(opts) {
+  const { allData, prevData, name, requestedPart, metric, badgeScores } = opts
+  const parts = [requestedPart, -127].concat(PART_ORDER.filter(p => p !== requestedPart && p !== -127))
+  let entry = null, part = null
+  for (const p of parts) {
+    const e = allData.find(d => d.name === name && d.part === p)
+    if (e) { entry = e; part = p; break }
+  }
+  if (!entry) return null
+  const camp = entry.camp_id
+
+  const sorted = sortDesc(uniqueBy(allData, camp, part), metric, badgeScores)
+  const rank = rankMap(sorted)
+  const total = sorted.length
+
+  const prevEntry = prevData.length
+    ? prevData.find(d => d.name === name && d.camp_id === camp && d.part === part)
+    : null
+
+  const six = RATE_METRICS.map(key => ({
+    key,
+    label: METRICS[key],
+    val: getMetricVal(entry, key, badgeScores),
+    prev: prevEntry ? getMetricVal(prevEntry, key, badgeScores) : null,
+  }))
+
+  const allRanks = {}
+  RATE_METRICS.forEach(key => {
+    const sorted2 = sortDesc(uniqueBy(allData, camp, part), key, badgeScores)
+    allRanks[key] = rankMap(sorted2)
+  })
+
+  let changeRanks = null
+  if (prevData.length) {
+    changeRanks = {}
+    RATE_METRICS.forEach(key => {
+      const changes = []
+      uniqueBy(allData, camp, part).forEach(d => {
+        const p = prevData.find(x => x.name === d.name && x.camp_id === camp && x.part === part)
+        const cv = getMetricVal(d, key, badgeScores)
+        const pv = p ? getMetricVal(p, key, badgeScores) : null
+        if (cv != null && pv != null) changes.push({ name: d.name, chg: cv - pv })
+      })
+      changes.sort((a, b) => (key === 'lose_rate' ? a.chg - b.chg : b.chg - a.chg))
+      const map = {}
+      changes.forEach((c, i) => { map[c.name] = i + 1 })
+      changeRanks[key] = map
+    })
+  }
+
+  const partsGrid = []
+  PART_ORDER.forEach(p => {
+    const e = allData.find(d => d.name === name && d.camp_id === camp && d.part === p)
+    const ca = campAvg(allData, camp, p)
+    if (!e || !ca) return
+    const wr = winRateNoDraw(e.win_rate, e.ping_rate)
+    const awr = winRateNoDraw(ca.win_rate, ca.ping_rate)
+    if (wr == null || awr == null) return
+    partsGrid.push({ label: PARTS[p], val: wr, diff: wr - awr })
+  })
+
+  return {
+    entry, camp, part,
+    rank: rank[entry.name] || 0, total,
+    six, allRanks, changeRanks, partsGrid, prevEntry,
+  }
+}
+
+function computeBadge(card, badge) {
+  const name = card.entry.name
+  const cur = badge.map[name] || {}
+  const campStr = String(card.camp)
+  const build = (srcMap, isPrev) => BADGE_TIERS.map(t => {
+    const cv = cur[t.key]
+    const pv = srcMap ? srcMap[name] ? srcMap[name][t.key] : null : null
+    return {
+      label: t.label,
+      delta: pv > 0 && cv != null ? (cv - pv) / pv * 100 : null,
+    }
+  })
+  const tiers = BADGE_TIERS.map(t => ({
+    label: t.label, cls: t.cls,
+    val: cur[t.key] != null ? cur[t.key] : null,
+  }))
+  const sums = {}, cnts = {}
+  BADGE_TIERS.forEach(t => { sums[t.key] = 0; cnts[t.key] = 0 })
+  Object.keys(badge.map).forEach(nm => {
+    if (badge.camps[nm] !== campStr) return
+    BADGE_TIERS.forEach(t => {
+      const v = badge.map[nm][t.key]
+      if (v) { sums[t.key] += v; cnts[t.key]++ }
+    })
+  })
+  const anomaly = BADGE_TIERS.map(t => {
+    const avg = cnts[t.key] ? sums[t.key] / cnts[t.key] : null
+    const cv = cur[t.key]
+    return { label: t.label, delta: avg > 0 && cv != null ? (cv - avg) / avg * 100 : null }
+  })
+  return {
+    tiers,
+    season: build(badge.prevMap),
+    daily: build(badge.dailyMap),
+    anomaly,
+    dates: { cur: badge.curDate, prev: badge.prevDate, daily: badge.dailyDate },
+  }
+}
+
+function findSimilar(data, name) {
+  const seen = new Set(), names = []
+  data.forEach(d => {
+    if (!seen.has(d.name)) { seen.add(d.name); names.push(d.name) }
+  })
+  return names.filter(n => n.includes(name) || name.includes(n)).slice(0, 8)
+}
+
+// ===== 主流程 =====
+
+async function collect(config, name, cond) {
+  const parsed = parseArgs(cond)
+  const src = await resolveSource(config)
+  const { base, meta } = src
+  const sourceLabel = base.replace(/^https?:\/\//, '')
+
+  const seasonName = parsed.season ? (findSeasonKey(meta.seasonList, parsed.season) || meta.latestSeason) : meta.latestSeason
+  const weeks = meta.weekList[seasonName] || []
+  let weekIdx = null
+  if (!parsed.seasonFull) {
+    if (parsed.week != null) {
+      const w = parseInt(parsed.week)
+      if (!weeks.length) return { ok: false, error: seasonName + '暂无周数据' }
+      if (w < 1 || w > weeks.length) return { ok: false, error: seasonName + '仅收录 ' + weeks.length + ' 周数据' }
+      weekIdx = w - 1
+    } else if (weeks.length) {
+      weekIdx = weeks.length - 1
+    }
+  }
+
+  const file = weekIdx != null ? weeks[weekIdx].fileName : meta.seasonList[seasonName]
+  if (!file) return { ok: false, error: seasonName + '暂无可用数据' }
+
+  const allData = await loadSeasonData(base, file, config.timeout)
+  if (!allData.length) return { ok: false, error: '数据文件为空' }
+
+  const part = parsed.part != null ? parsed.part : parseInt(config.defaultPart)
+  const metric = parsed.metric || 'win_rate_without_draw'
+
+  let prevData = []
+  const prevKey = prevSeasonKey(seasonName)
+  if (prevKey && meta.seasonList[prevKey]) {
+    const prevFile = weekIdx != null && (meta.weekList[prevKey] || [])[weekIdx]
+      ? meta.weekList[prevKey][weekIdx].fileName
+      : meta.seasonList[prevKey]
+    if (prevFile) {
+      try { prevData = await loadSeasonData(base, prevFile, config.timeout) } catch (e) { prevData = [] }
+    }
+  }
+
+  let badge = null
+  if (config.showBadge) {
+    try { badge = await loadBadgeAll(base, config, meta, file) } catch (e) { badge = null }
+  }
+  if (metric.startsWith('badge_') && !badge) {
+    return { ok: false, error: '勋章分排序需要勋章数据，但勋章数据获取失败' }
+  }
+
+  const card = computeCard({
+    allData, prevData, name, requestedPart: part, metric,
+    badgeScores: badge ? badge.map : null,
+  })
+  if (!card) {
+    const similar = findSimilar(allData, name)
+    return {
+      ok: false,
+      error: '未找到角色「' + name + '」' + (similar.length ? '\n相近角色：' + similar.join('、') : ''),
+    }
+  }
+
+  return {
+    ok: true,
+    base, sourceLabel, file,
+    seasonName,
+    weekLabel: weekIdx != null ? '第' + (weekIdx + 1) + '周' : '全赛季',
+    partName: PARTS[part] || String(part),
+    metric, metricLabel: metricLabel(metric),
+    name, card,
+    badge: badge ? computeBadge(card, badge) : null,
+    badgeScores: badge ? badge.map : null,
+    badgeDays: config.badgeDays,
+  }
+}
+
+// ===== HTML 生成（样式参考 animationshow.html）=====
+
+function buildHtml(data, config) {
+  const { name, seasonName, weekLabel, partName, metricLabel, metric, card, badge, sourceLabel, file, badgeDays } = data
+  const width = config.width || 1000
+
+  const hl = getMetricVal(card.entry, metric, data.badgeScores)
+  const hlCls = metric.startsWith('badge_') ? 'plain' : (hl == null ? '' : (hl >= 0.5 ? 'high' : (hl >= 0.3 ? 'mid' : 'low')))
+  const rankSup = '#' + card.rank + '/' + card.total
+
+  const sixRows = card.six.map(m => {
+    const rk = card.allRanks[m.key][card.entry.name]
+    return '<div class="s-row"><span class="s-label">' + m.label + '</span>' +
+      '<span class="s-val">' + fmtPct(m.val) + '</span>' +
+      '<span class="s-rank">' + (rk ? '#' + rk : '--') + '</span></div>'
+  }).join('')
+
+  let changeBlock = ''
+  if (card.changeRanks) {
+    const rows = card.six.map(m => {
+      const d = m.prev != null && m.val != null ? m.val - m.prev : null
+      const g = fmtGrowth(d != null ? d * 100 : null)
+      const cr = card.changeRanks[m.key][card.entry.name]
+      const cls = g.cls || (d != null && Math.abs(d) > 0.001 ? (d > 0 ? 'up' : 'down') : '')
+      const text = d == null ? (m.prev != null ? '--' : '<span class="stat-delta new">新增</span>') : '<span class="stat-delta ' + cls + '">' + (d > 0 ? '+' : '') + (d * 100).toFixed(2) + '%</span>'
+      return '<div class="s-row"><span class="s-label">' + m.label + '</span>' +
+        '<span class="s-val">' + text + '</span>' +
+        '<span class="s-rank">' + (cr ? '#' + cr : '--') + '</span></div>'
+    }).join('')
+    changeBlock = '<div class="zone-sep"></div>' +
+      '<div class="stat-block"><div class="comp-title">对比上赛季变化值 / 变化值在本阵营排名</div>' +
+      '<div class="s-row s-header-row"><span class="s-label"></span><span class="s-val">变化值</span><span class="s-rank">排名</span></div>' +
+      rows + '</div>'
+  }
+
+  const partsItems = card.partsGrid.map(p => {
+    const g = fmtGrowth(p.diff * 100)
+    return '<div class="allrank-item"><span class="allrank-label">' + p.label + '</span>' +
+      '<span class="allrank-val">' + fmtPct(p.val) + '</span>' +
+      '<span class="allrank-delta ' + g.cls + '">' + g.text + '</span></div>'
+  }).join('')
+
+  const zoneLeft = '<div class="stat-block">' + sixRows + '</div>' + changeBlock +
+    '<div class="zone-sep"></div>' +
+    '<div class="stat-block"><div class="comp-title" style="color:var(--accent);margin-bottom:4px">各段位去平胜率（距平均）</div>' +
+    '<div class="allrank-grid">' + partsItems + '</div></div>'
+
+  let zoneRight
+  if (badge) {
+    const tierItems = badge.tiers.map(t =>
+      '<div class="card-badge-item ' + t.cls + '"><span class="b-tier">' + t.label + '</span><span class="b-val">' + (t.val != null ? t.val : '--') + '</span></div>'
+    ).join('')
+    const short = d => d ? d.substring(4) : '--'
+    const growBlock = (title, items) =>
+      '<div class="stat-block badge-block"><div class="badge-block-title">' + title + '</div>' +
+      '<div class="badge-growth-grid">' + items + '</div></div>'
+    const growItems = list => list.map(x => {
+      const g = fmtGrowth(x.delta)
+      return '<div class="badge-growth-item"><span class="bg-tier">' + x.label + '</span><span class="bg-val ' + g.cls + '">' + g.text + '</span></div>'
+    }).join('')
+    zoneRight =
+      '<div class="stat-block badge-block"><div class="badge-block-title">勋章分数 (' + short(badge.dates.cur) + ')</div>' +
+      '<div class="card-badge-tiers">' + tierItems + '</div></div>' +
+      growBlock('赛季同比增长 (' + short(badge.dates.prev) + '→' + short(badge.dates.cur) + ')', growItems(badge.season)) +
+      growBlock(badgeDays + '日增长率 (' + short(badge.dates.daily) + '→' + short(badge.dates.cur) + ')', growItems(badge.daily)) +
+      growBlock('距阵营平均值', growItems(badge.anomaly))
+  } else {
+    zoneRight = '<div class="stat-block"><div class="comp-title" style="color:var(--text-secondary)">暂无勋章数据</div></div>'
+  }
+
+  const position = card.entry.position
+  const avatar = config.avatarBase || ''
+  const avatarUrl = avatar ? avatar.replace(/\/+$/, '') + '/statics/角色头像/' + encodeURIComponent(name) + '.png' : ''
+  const campName = card.camp === 1 ? '监管者' : '求生者'
+
+  const zoneCenter =
+    '<div class="card-avatar-wrap">' +
+    (avatarUrl
+      ? '<img class="card-avatar" src="' + avatarUrl + '" alt="' + esc(name) + '" onerror="this.style.display=\'none\';this.nextElementSibling.style.display=\'flex\';">' +
+        '<div class="card-avatar placeholder" style="display:none">' + esc(name.charAt(0)) + '</div>'
+      : '<div class="card-avatar placeholder">' + esc(name.charAt(0)) + '</div>') +
+    '</div>' +
+    '<div class="card-char-name">' + esc(name) + '</div>' +
+    (position ? '<div class="card-sub">' + esc(position) + ' · ' + campName + '</div>' : '') +
+    '<div class="card-highlight ' + hlCls + '">' + fmtHigh(hl, metric) + '<sup class="hl-rank">' + rankSup + '</sup></div>' +
+    '<div class="card-highlight-label">' + metricLabel + ' · ' + partName + '</div>'
+
+  const titleBar =
+    '<span>' + seasonName + '</span><span class="sep">·</span>' +
+    '<span>' + weekLabel + '</span><span class="sep">·</span>' +
+    '<span>' + partName + '</span><span class="sep">·</span>' +
+    '<span class="metric-tag">' + metricLabel + '↓</span>'
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<style>
+:root { --bg:#0d1117; --surface:#161b22; --border:#30363d; --text:#c9d1d9; --text-secondary:#8b949e; --accent:#58a6ff; --green:#3fb950; --red:#f85149; --yellow:#d2991d; --card-bg:#1c2333; }
+* { margin:0; padding:0; box-sizing:border-box; }
+body { background:var(--bg); color:var(--text); font-family:-apple-system,BlinkMacSystemFont,'Segoe UI','Microsoft YaHei',sans-serif; padding:16px; }
+.page { width:100%; margin:0 auto; }
+.title-bar { display:flex; justify-content:center; align-items:center; gap:8px; padding:6px 18px; background:rgba(22,27,34,.9); border:1px solid var(--border); border-radius:20px; font-size:20px; margin-bottom:14px; white-space:nowrap; }
+.title-bar .sep { color:var(--border); }
+.title-bar .metric-tag { color:var(--accent); font-weight:600; }
+.card { background:var(--card-bg); border:1px solid var(--border); border-radius:18px; padding:22px 26px; }
+.card-grid { display:grid; grid-template-columns:330px 1fr 330px; gap:0 20px; align-items:start; }
+.card-zone { width:100%; }
+.zone-center { display:flex; flex-direction:column; align-items:center; }
+.card-avatar-wrap { margin-bottom:8px; }
+.card-avatar { width:150px; height:150px; border-radius:50%; object-fit:cover; border:3px solid rgba(255,255,255,.12); background:#1a1e26; box-shadow:0 0 30px rgba(0,0,0,.4); }
+.card-avatar.placeholder { display:flex; align-items:center; justify-content:center; font-size:54px; color:var(--text-secondary); background:rgba(255,255,255,.04); }
+.card-char-name { font-size:26px; font-weight:700; text-align:center; margin:6px 0 2px; }
+.card-sub { font-size:13px; color:var(--text-secondary); margin-bottom:8px; }
+.card-highlight { position:relative; font-size:64px; font-weight:800; line-height:1; text-align:center; margin-bottom:4px; }
+.card-highlight.high { color:var(--green); }
+.card-highlight.mid { color:var(--yellow); }
+.card-highlight.low { color:var(--red); }
+.card-highlight.plain { color:var(--accent); }
+.card-highlight .hl-rank { position:absolute; top:-0.15em; font-size:.35em; font-weight:700; color:var(--accent); white-space:nowrap; }
+.card-highlight-label { font-size:15px; color:var(--text-secondary); }
+.stat-block { display:flex; flex-direction:column; gap:6px; }
+.stat-block + .stat-block { margin-top:12px; }
+.s-row { display:flex; align-items:center; justify-content:space-between; padding:8px 12px; background:rgba(255,255,255,.02); border:1px solid rgba(255,255,255,.04); border-radius:6px; gap:10px; }
+.s-label { font-size:15px; color:var(--text-secondary); font-weight:600; width:76px; flex-shrink:0; }
+.s-val { font-size:17px; font-weight:600; font-variant-numeric:tabular-nums; flex:1; text-align:center; }
+.s-rank { font-size:16px; color:var(--accent); font-weight:700; min-width:46px; text-align:right; }
+.stat-delta { font-size:15px; font-weight:600; font-variant-numeric:tabular-nums; }
+.stat-delta.up { color:var(--green); }
+.stat-delta.down { color:var(--red); }
+.stat-delta.new { color:var(--yellow); }
+.s-header-row { background:transparent; border:none; }
+.s-header-row .s-val, .s-header-row .s-rank { font-size:12px; color:var(--text-secondary); font-weight:400; }
+.zone-sep { margin:12px 0; border-top:1px solid rgba(255,255,255,.08); }
+.comp-title { font-size:15px; color:var(--green); font-weight:700; text-align:center; margin-bottom:8px; letter-spacing:1px; }
+.badge-block-title { font-size:15px; color:var(--yellow); font-weight:700; text-align:center; margin-bottom:8px; }
+.card-badge-tiers, .badge-growth-grid, .allrank-grid { display:grid; grid-template-columns:repeat(4,1fr); gap:6px; }
+.card-badge-item, .badge-growth-item, .allrank-item { display:flex; flex-direction:column; align-items:center; gap:2px; padding:6px 3px; background:rgba(255,255,255,.02); border:1px solid rgba(255,255,255,.04); border-radius:5px; }
+.b-tier, .bg-tier, .allrank-label { font-size:12px; color:var(--text-secondary); font-weight:700; }
+.b-val, .bg-val, .allrank-val { font-size:14px; font-weight:700; font-variant-numeric:tabular-nums; }
+.allrank-delta { font-size:11px; font-weight:600; font-variant-numeric:tabular-nums; }
+.allrank-delta.up { color:var(--green); }
+.allrank-delta.down { color:var(--red); }
+.card-badge-item.tier-s .b-tier { color:var(--yellow); }
+.card-badge-item.tier-a .b-tier { color:var(--green); }
+.card-badge-item.tier-b .b-tier { color:var(--accent); }
+.card-badge-item.tier-c .b-tier { color:var(--text-secondary); }
+.foot { text-align:center; color:var(--text-secondary); font-size:12px; margin-top:10px; opacity:.7; }
+</style>
+</head>
+<body>
+<div class="page">
+  <div class="title-bar">${titleBar}</div>
+  <div class="card">
+    <div class="card-grid">
+      <div class="card-zone zone-left">${zoneLeft}</div>
+      <div class="card-zone zone-center">${zoneCenter}</div>
+      <div class="card-zone zone-right">${zoneRight}</div>
+    </div>
+  </div>
+  <div class="foot">数据来源：${esc(sourceLabel)} · 数据文件：${esc(file)} · 数据均根据第五人格官方小程序数据计算</div>
+</div>
+</body>
+</html>`
+}
+
+function fmtHigh(v, metric) {
+  if (v == null || isNaN(v)) return '--'
+  if (metric.startsWith('badge_')) return String(v)
+  return (v * 100).toFixed(2) + '%'
+}
+
+function buildHelp() {
+  return [
+    '查询角色胜率并生成图片',
+    '',
+    '用法：胜率 <角色名> [赛季] [周数] [排序要素] [段位]',
+    '',
+    '示例：',
+    '  胜率 小女孩',
+    '  胜率 小女孩 第43赛季 第3周 使用率',
+    '  胜率 小女孩 43 3 胜率',
+    '  胜率 小女孩 S44 全赛季 禁用率',
+    '',
+    '排序要素：' + Object.keys(METRICS).map(k => METRICS[k]).join('、') +
+      '、' + BADGE_TIERS.map(t => t.label + '勋章分').join('、'),
+    '段位：巅七（默认）、七阶、六阶、五阶、四阶、三阶、二阶、一阶、全段位',
+    '赛季、周数不填默认使用最新赛季最新周；填“全赛季”使用赛季累计数据',
+  ].join('\n')
+}
+
+module.exports = {
+  KNOWN_SOURCES,
+  METRICS,
+  BADGE_TIERS,
+  PARTS,
+  PART_ORDER,
+  parseArgs,
+  resolveSource,
+  collect,
+  buildHtml,
+  buildHelp,
+  findSimilar,
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "koishi-plugin-dwrgbwiki",
+  "version": "1.0.0",
+  "description": "第五人格BWIKI编辑组测试用组件，纯AI生成喵",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "lib.js",
+    "readme.md"
+  ],
+  "keywords": [
+    "koishi",
+    "plugin",
+    "winrate",
+    "第五人格",
+    "bwiki"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "koishi": "^4.0.0"
+  },
+  "koishi": {
+    "description": {
+      "zh": "第五人格BWIKI编辑组测试用组件，纯AI生成喵"
+    }
+  }
+}

package/readme.md

@@ -0,0 +1,51 @@
+# dwrgbwiki
+
+第五人格BWIKI编辑组测试用组件，纯AI生成喵。
+
+查询第五人格角色胜率，返回一张图片（样式参考 胜率数据站 animationshow.html 的角色卡片）。
+
+需要安装 [koishi-plugin-puppeteer](https://www.npmjs.com/package/koishi-plugin-puppeteer) 用于截图。
+
+## 用法
+
+```
+胜率 <角色名> [赛季] [周数] [排序要素] [段位]
+```
+
+示例：
+
+| 指令 | 含义 |
+| --- | --- |
+| `胜率 小女孩` | 最新赛季最新周，按去平胜率 |
+| `胜率 小女孩 第43赛季 第3周 使用率` | 指定赛季、周数与排序要素 |
+| `胜率 小女孩 43 3 胜率` | 同上（数字写法） |
+| `胜率 小女孩 S44 全赛季 禁用率` | 赛季累计数据 |
+| `胜率 小女孩 巅七 B101勋章分` | 指定段位与勋章分排序 |
+
+- 赛季、周数不填时默认使用最新赛季最新周；填写 `全赛季` 使用赛季累计数据
+- 排序要素默认 `去平胜率`，可选：胜率、平率、负率、使用率、禁用率、S1/S10/A11/A100/B101/B300/C301/C500 勋章分
+- 段位默认 `巅七`，可选：七阶、六阶、五阶、四阶、三阶、二阶、一阶、全段位
+
+## 配置
+
+| 配置项 | 说明 | 默认值 |
+| --- | --- | --- |
+| `dataSource` | 数据源地址，可在两个镜像站点间切换 | `https://website.homeworkkun.top` |
+| `tryAlternate` | 主数据源失败时自动尝试备用数据源 | `true` |
+| `defaultPart` | 默认段位（8=巅七，-127=全段位） | `8` |
+| `showBadge` | 显示勋章分数据 | `true` |
+| `badgeDays` | 勋章日增长率天数 | `7` |
+| `width` | 图片宽度（px） | `1000` |
+| `scale` | 截图倍率 | `2` |
+| `timeout` | 网络请求超时（毫秒） | `15000` |
+
+数据源两个镜像：`https://website.homeworkkun.top` 与 `https://web.homeworkkun.top`，可直接在配置中切换。
+
+## 图片内容
+
+- 标题栏：赛季 · 周数 · 段位 · 排序要素
+- 中央：角色头像、名称、定位/阵营、排序要素数值（含本阵营排名）、要素名
+- 左侧：六项数据（去平胜率/胜率/平率/负率/使用率/禁用率）及阵营排名、对比上赛季变化值与变化排名、各段位去平胜率（距平均）
+- 右侧：勋章分数（S1~C500）、赛季同比增长、日增长率、距阵营平均值
+
+数据均根据第五人格官方小程序数据计算。