koishi-plugin-dwrgbwiki 1.0.0 → 1.2.0

package/index.js

@@ -5,13 +5,30 @@ const lib = require('./lib')
 
 const HELP = lib.buildHelp()
 
+const MAIN_HELP = [
+  '第五人格BWIKI数据查询机器人',
+  '',
+  '支持指令：',
+  '  胜率 <角色名> [赛季] [周数] [排序要素] [段位]',
+  '    查询角色胜率，例：胜率 小女孩',
+  '  地图 <地图名> [赛季] [周数] [段位] [阵营]',
+  '    查询地图胜率，例：地图 军工厂',
+  '  模仿者 <角色名> [日期] [模式]',
+  '    查询模仿者游戏数据，例：模仿者 侦探',
+  '  勋章 <角色名> [日期] [模式]',
+  '    查询角色勋章分数线，例：勋章 小女孩',
+  '',
+  '发送“胜率”等单独指令可查看对应完整帮助',
+  '数据均根据第五人格官方小程序数据计算',
+].join('\n')
+
 module.exports = {
   name: 'dwrgbwiki',
   description: '第五人格BWIKI编辑组测试用组件，纯AI生成喵',
 
   Config: Schema.object({
-    dataSource: Schema.string()
-      .description('数据源地址，可在两个镜像站点之间切换：' + lib.KNOWN_SOURCES.join(' / '))
+    dataSource: Schema.union(lib.KNOWN_SOURCES)
+      .description('数据源地址，可在两个镜像站点之间切换')
       .default('https://website.homeworkkun.top'),
     tryAlternate: Schema.boolean()
       .description('主数据源失败时自动尝试备用数据源')
@@ -19,6 +36,9 @@ module.exports = {
     defaultPart: Schema.union(['8', '-127'])
       .description('默认段位（8=巅七，-127=全段位）')
       .default('8'),
+    mapDefaultCamp: Schema.union(['1', '2'])
+      .description('地图查询默认阵营（1=监管者，2=求生者）')
+      .default('1'),
     showBadge: Schema.boolean()
       .description('显示勋章分数据（获取失败时自动隐藏）')
       .default(true),
@@ -26,8 +46,17 @@ module.exports = {
       .description('勋章日增长率天数')
       .default(7),
     width: Schema.number().min(400).max(4000)
-      .description('图片宽度（px）')
+      .description('图片宽度（px），其他指令未单独设置时使用该值')
       .default(1000),
+    mapWidth: Schema.number().min(400).max(4000)
+      .description('地图指令图片宽度（px），0=使用默认宽度')
+      .default(0),
+    mimicWidth: Schema.number().min(400).max(4000)
+      .description('模仿者指令图片宽度（px），0=使用默认宽度')
+      .default(0),
+    badgeWidth: Schema.number().min(400).max(4000)
+      .description('勋章指令图片宽度（px），0=使用默认宽度')
+      .default(0),
     scale: Schema.number().min(1).max(4)
       .description('截图倍率（越大越清晰）')
       .default(2),
@@ -37,30 +66,135 @@ module.exports = {
   }),
 
   apply(ctx, config) {
+    ctx.command('BWIKI机器人', '显示当前支持的指令列表')
+      .action(async ({ session }) => {
+        return helpImage(ctx, config, MAIN_HELP)
+      })
+
     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)
-        }
+        if (!name || !name.trim()) return helpImage(ctx, config, HELP)
+        return run(ctx, config, lib.collect, lib.buildHtml, name.trim(), cond, 'width')
+      })
+
+    ctx.command('地图 <地图名> [条件:text]', '查询地图胜率并生成图片')
+      .usage(MAP_HELP)
+      .example('地图 军工厂')
+      .example('地图 红教堂 S44 3 求生者')
+      .example('地图 月亮河公园 全赛季')
+      .action(async ({ session }, name, cond) => {
+        if (!name || !name.trim()) return helpImage(ctx, config, MAP_HELP)
+        return run(ctx, config, lib.collectMap, lib.buildMapHtml, name.trim(), cond, 'mapWidth')
+      })
+
+    ctx.command('模仿者 <角色名> [条件:text]', '查询模仿者游戏角色数据并生成图片')
+      .usage(MIMIC_HELP)
+      .example('模仿者 侦探')
+      .example('模仿者 药剂师 260531 低级场')
+      .action(async ({ session }, name, cond) => {
+        if (!name || !name.trim()) return helpImage(ctx, config, MIMIC_HELP)
+        return run(ctx, config, lib.collectMimic, lib.buildMimicHtml, name.trim(), cond, 'mimicWidth')
+      })
+
+    ctx.command('勋章 <角色名> [条件:text]', '查询角色勋章分数线并生成图片')
+      .usage(BADGE_HELP)
+      .example('勋章 小女孩')
+      .example('勋章 小女孩 20250917 7日增长率')
+      .example('勋章 小女孩 赛季同比增长率')
+      .action(async ({ session }, name, cond) => {
+        if (!name || !name.trim()) return helpImage(ctx, config, BADGE_HELP)
+        return run(ctx, config, lib.collectBadge, lib.buildBadgeHtml, name.trim(), cond, 'badgeWidth')
       })
   },
 }
 
+async function run(ctx, config, collectFn, buildFn, name, cond, widthKey) {
+  if (!ctx.puppeteer) {
+    return '未检测到 puppeteer 服务，请先安装并启用 koishi-plugin-puppeteer'
+  }
+  try {
+    const result = await collectFn(config, name, cond)
+    if (!result.ok) return errorImage(ctx, config, result.error)
+    const width = (config[widthKey] && config[widthKey] > 0) ? config[widthKey] : config.width
+    const html = buildFn(result, { ...config, avatarBase: result.base, width })
+    const image = await capture(ctx, html, { ...config, width })
+    return [h.image(image)]
+  } catch (e) {
+    ctx.logger('dwrgbwiki').warn(e)
+    return errorImage(ctx, config, '查询失败：' + (e && e.message ? e.message : e))
+  }
+}
+
+async function helpImage(ctx, config, text) {
+  if (!ctx.puppeteer) return text
+  try {
+    const html = lib.buildHelpHtml(text, { ...config, width: config.width })
+    const image = await capture(ctx, html, config)
+    return [h.image(image)]
+  } catch (e) {
+    ctx.logger('dwrgbwiki').warn(e)
+    return text
+  }
+}
+
+async function errorImage(ctx, config, text) {
+  if (!ctx.puppeteer || !text) return text
+  try {
+    const html = lib.buildHelpHtml(text, { ...config, width: config.width })
+    const image = await capture(ctx, html, config)
+    return [h.image(image)]
+  } catch (e) {
+    ctx.logger('dwrgbwiki').warn(e)
+    return text
+  }
+}
+
+const MAP_HELP = [
+  '查询地图胜率并生成图片',
+  '',
+  '用法：地图 <地图名> [赛季] [周数] [段位] [阵营]',
+  '',
+  '示例：',
+  '  地图 军工厂',
+  '  地图 红教堂 S44 3 求生者',
+  '  地图 月亮河公园 全赛季 全段位',
+  '',
+  '阵营：监管者（默认）、求生者；赛季：S44 / 第44赛季；周数：第3周 / 3',
+  '段位：巅七（默认）、七阶、六阶、五阶、四阶、三阶、二阶、一阶、全段位',
+  '赛季、周数不填默认使用最新赛季最新周',
+].join('\n')
+
+const MIMIC_HELP = [
+  '查询模仿者游戏角色数据并生成图片',
+  '',
+  '用法：模仿者 <角色名> [日期] [模式]',
+  '',
+  '示例：',
+  '  模仿者 侦探',
+  '  模仿者 药剂师 260531 低级场',
+  '',
+  '日期：YYMMDD（如 260531），不填默认最新日期',
+  '模式：低级场、10人高级场、12人高级场、所有模式（默认）',
+].join('\n')
+
+const BADGE_HELP = [
+  '查询角色勋章分数线并生成图片',
+  '',
+  '用法：勋章 <角色名> [日期] [模式]',
+  '',
+  '示例：',
+  '  勋章 小女孩',
+  '  勋章 小女孩 20250917 7日增长率',
+  '  勋章 小女孩 赛季同比增长率',
+  '',
+  '日期：YYYYMMDD（如 20250917），不填默认最新日期',
+  '模式：勋章分数（默认）、距平百分比、1/3/7/15/30日增长率、赛季同比增长率',
+].join('\n')
+
 async function capture(ctx, html, config) {
   const page = await ctx.puppeteer.page()
   try {

package/lib.js

@@ -30,6 +30,24 @@ 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 MAP_CAMPS = { 1: '监管者', 2: '求生者' }
+const MAP_CAMP_LABELS = Object.keys(MAP_CAMPS).reduce((m, k) => { m[MAP_CAMPS[k]] = k; return m }, {})
+
+const MIMIC_MODES = { '67': '低级场', '68': '10人高级场', '73': '12人高级场', 'all_mode': '所有模式' }
+const MIMIC_MODE_LABELS = Object.keys(MIMIC_MODES).reduce((m, k) => { m[MIMIC_MODES[k]] = k; return m }, {})
+
+const BADGE_MODES = {
+  original: '勋章分数',
+  anomaly: '距平百分比',
+  '1d': '1日增长率',
+  '3d': '3日增长率',
+  '7d': '7日增长率',
+  '15d': '15日增长率',
+  '30d': '30日增长率',
+  season: '赛季同比增长率',
+}
+const BADGE_MODE_LABELS = Object.keys(BADGE_MODES).reduce((m, k) => { m[BADGE_MODES[k]] = k; return m }, {})
+
 const METRIC_LABELS = {}
 Object.keys(METRICS).forEach(k => { METRIC_LABELS[METRICS[k]] = k })
 
@@ -60,7 +78,7 @@ function winRateNoDraw(w, p) {
 
 function getMetricVal(item, metric, badgeScores) {
   if (metric.startsWith('badge_')) {
-    const tier = metric.slice(5)
+    const tier = metric.slice(6)
     const s = badgeScores && badgeScores[item.name] ? badgeScores[item.name][tier] : null
     return s == null || isNaN(s) ? null : s
   }
@@ -292,6 +310,125 @@ async function loadBadgeAll(base, config, meta, dataFile) {
   }
 }
 
+// ===== 地图数据 =====
+
+async function loadMapData(base, timeout) {
+  const files = await fetchJson(url(base, '/胜率数据/map/mapdata.json'), timeout)
+  if (!Array.isArray(files)) throw new Error('地图文件列表解析失败')
+  const all = {}
+  for (const f of files) {
+    if (!/^MAP_S\d+\.json$/.test(f)) continue
+    let j
+    try { j = await fetchJson(url(base, '/胜率数据/map/' + f), timeout) } catch (e) { continue }
+    ;(j.data || []).forEach(item => {
+      const season = 'S' + item.season
+      const isFullSeason = item.week_num === null || item.week_num == -127
+      const weekKey = isFullSeason ? 'full_season' : 'W' + item.week_num
+      const partKey = String(item.part) === '-127' ? 'all_tiers' : 'tier' + item.part
+      const campId = String(item.camp_id)
+      const spaceName = item.space_name
+      if (!spaceName) return
+      if (!all[season]) all[season] = { end_time: '' }
+      if (!all[season][weekKey]) all[season][weekKey] = {}
+      if (isFullSeason && item.end_time && item.end_time > all[season].end_time) all[season].end_time = item.end_time
+      if (!all[season][weekKey][partKey]) all[season][weekKey][partKey] = {}
+      if (!all[season][weekKey][partKey][campId]) all[season][weekKey][partKey][campId] = {}
+      const slot = all[season][weekKey][partKey][campId]
+      if (!slot[spaceName]) slot[spaceName] = {
+        win_rate: { sum: 0, count: 0 }, ping_rate: { sum: 0, count: 0 },
+        fail_rate: { sum: 0, count: 0 }, space_no: item.space_no,
+      }
+      const s = slot[spaceName]
+      s.win_rate.sum += item.win_rate || 0; s.win_rate.count++
+      s.ping_rate.sum += item.ping_rate || 0; s.ping_rate.count++
+      s.fail_rate.sum += item.fail_rate || 0; s.fail_rate.count++
+    })
+  }
+  const out = {}
+  Object.keys(all).forEach(season => {
+    out[season] = { end_time: all[season].end_time }
+    Object.keys(all[season]).forEach(weekKey => {
+      if (weekKey === 'end_time') return
+      out[season][weekKey] = {}
+      Object.keys(all[season][weekKey]).forEach(partKey => {
+        out[season][weekKey][partKey] = {}
+        Object.keys(all[season][weekKey][partKey]).forEach(campId => {
+          const camp = {}
+          Object.keys(all[season][weekKey][partKey][campId]).forEach(mapName => {
+            const s = all[season][weekKey][partKey][campId][mapName]
+            camp[mapName] = {
+              win_rate: s.win_rate.count ? s.win_rate.sum / s.win_rate.count : null,
+              ping_rate: s.ping_rate.count ? s.ping_rate.sum / s.ping_rate.count : null,
+              fail_rate: s.fail_rate.count ? s.fail_rate.sum / s.fail_rate.count : null,
+              space_no: s.space_no,
+            }
+          })
+          out[season][weekKey][partKey][campId] = camp
+        })
+      })
+    })
+  })
+  return out
+}
+
+function parseMapArgs(rest) {
+  const tokens = String(rest || '').trim().split(/\s+/).filter(Boolean)
+  const r = { season: null, week: null, part: null, camp: null }
+  tokens.forEach(t => {
+    let m
+    if ((m = t.match(/^s\s*(\d{1,3})\s*赛季$/i))) { r.season = 'S' + m[1]; return }
+    if ((m = t.match(/^s\s*(\d{1,3})$/i))) { r.season = 'S' + m[1]; return }
+    if ((m = t.match(/^第?\s*(\d{1,3})\s*赛季$/i))) { r.season = 'S' + m[1]; return }
+    if ((m = t.match(/^第?\s*(\d{1,2})\s*周$/))) { r.week = m[1]; return }
+    if (MAP_CAMP_LABELS[t]) { r.camp = MAP_CAMP_LABELS[t]; return }
+    if ((m = t.match(/^([12])$/))) { r.camp = m[1]; return }
+    const pm = Object.keys(PARTS).find(k => PARTS[k] === t)
+    if (pm != null) { r.part = parseInt(pm); return }
+    if ((m = t.match(/^(\d{1,2})$/))) { r.week = m[1]; return }
+  })
+  return r
+}
+
+// ===== 模仿者游戏数据 =====
+
+async function loadMimicFileList(base, timeout) {
+  const text = await fetchText(url(base, '/胜率数据/模仿者游戏/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' && /^data_\d{6}\.json$/.test(f)).sort()
+}
+
+async function loadMimicConfig(base, timeout) {
+  const j = await fetchJson(url(base, '/胜率数据/模仿者游戏/config.json'), timeout)
+  const nameToId = {}
+  Object.keys(j || {}).forEach(id => { const n = String(j[id]); if (n) nameToId[n] = id })
+  return { idToName: j || {}, nameToId }
+}
+
+function parseMimicArgs(rest) {
+  const tokens = String(rest || '').trim().split(/\s+/).filter(Boolean)
+  const r = { date: null, mode: null }
+  tokens.forEach(t => {
+    if (/^\d{6}$/.test(t)) { r.date = t; return }
+    if (MIMIC_MODE_LABELS[t]) { r.mode = MIMIC_MODE_LABELS[t]; return }
+  })
+  return r
+}
+
+// ===== 勋章数据 =====
+
+function parseBadgeArgs(rest) {
+  const tokens = String(rest || '').trim().split(/\s+/).filter(Boolean)
+  const r = { date: null, mode: 'original' }
+  tokens.forEach(t => {
+    if (/^\d{8}$/.test(t)) { r.date = t; return }
+    if (BADGE_MODE_LABELS[t] != null) { r.mode = BADGE_MODE_LABELS[t]; return }
+  })
+  return r
+}
+
 // ===== 数据计算 =====
 
 function uniqueBy(data, camp, part) {
@@ -396,6 +533,7 @@ function computeCard(opts) {
   return {
     entry, camp, part,
     rank: rank[entry.name] || 0, total,
+    ranking: sorted,
     six, allRanks, changeRanks, partsGrid, prevEntry,
   }
 }
@@ -447,6 +585,241 @@ function findSimilar(data, name) {
   return names.filter(n => n.includes(name) || name.includes(n)).slice(0, 8)
 }
 
+// ===== 地图查询主流程 =====
+
+async function collectMap(config, mapQuery, cond) {
+  const parsed = parseMapArgs(cond)
+  const src = await resolveSource(config)
+  const { base, meta } = src
+  const sourceLabel = base.replace(/^https?:\/\//, '')
+
+  const mapData = await loadMapData(base, config.timeout)
+  const seasons = Object.keys(mapData).filter(s => /^S\d+$/.test(s))
+    .sort((a, b) => parseInt(a.substring(1)) - parseInt(b.substring(1)))
+  if (!seasons.length) return { ok: false, error: '地图数据为空' }
+
+  const seasonName = parsed.season && mapData[parsed.season] ? parsed.season : seasons[seasons.length - 1]
+  const seasonObj = mapData[seasonName]
+  const weekKeys = Object.keys(seasonObj).filter(w => w !== 'end_time')
+
+  let weekKey = 'full_season'
+  if (parsed.week != null) {
+    const wk = 'W' + parsed.week
+    if (!weekKeys.includes(wk)) return { ok: false, error: seasonName + ' 无第' + parsed.week + '周地图数据' }
+    weekKey = wk
+  } else {
+    const ws = weekKeys.filter(w => /^W\d+$/.test(w))
+      .sort((a, b) => parseInt(a.substring(1)) - parseInt(b.substring(1)))
+    if (ws.length) weekKey = ws[ws.length - 1]
+  }
+
+  const part = parsed.part != null ? parsed.part : parseInt(config.defaultPart)
+  const partKey = part === -127 ? 'all_tiers' : 'tier' + part
+  const camp = parsed.camp != null ? parseInt(parsed.camp) : (config.mapDefaultCamp ? parseInt(config.mapDefaultCamp) : 1)
+
+  const slot = seasonObj[weekKey] && seasonObj[weekKey][partKey] && seasonObj[weekKey][partKey][camp]
+  if (!slot || !Object.keys(slot).length) {
+    return { ok: false, error: seasonName + ' ' + (weekKey === 'full_season' ? '全赛季' : '第' + weekKey.substring(1) + '周') + ' ' + (PARTS[part] || part) + ' ' + (MAP_CAMPS[camp] || camp) + ' 暂无地图数据' }
+  }
+
+  const mapNames = Object.keys(slot)
+  const exact = mapNames.find(n => n === mapQuery)
+  const match = exact || mapNames.find(n => n.includes(mapQuery) || mapQuery.includes(n))
+  if (!match) {
+    return { ok: false, error: '未找到地图「' + mapQuery + '」\n相近地图：' + mapNames.slice(0, 8).join('、') }
+  }
+
+  const cur = slot[match]
+  const nodraw = (cur.win_rate != null && cur.fail_rate != null && cur.win_rate + cur.fail_rate > 0)
+    ? cur.win_rate / (cur.win_rate + cur.fail_rate) * 100 : null
+
+  let prev = null
+  const seasonNum = parseInt(seasonName.substring(1))
+  const prevSeason = 'S' + (seasonNum - 1)
+  if (mapData[prevSeason]) {
+    const prevSlot = mapData[prevSeason][weekKey] && mapData[prevSeason][weekKey][partKey] && mapData[prevSeason][weekKey][partKey][camp]
+    const p = prevSlot && prevSlot[match]
+    if (p) {
+      const pn = (p.win_rate != null && p.fail_rate != null && p.win_rate + p.fail_rate > 0)
+        ? p.win_rate / (p.win_rate + p.fail_rate) * 100 : null
+      prev = { win_rate: p.win_rate, ping_rate: p.ping_rate, fail_rate: p.fail_rate, win_rate_nodraw: pn }
+    }
+  }
+
+  return {
+    ok: true, base, sourceLabel,
+    mapName: match, spaceNo: cur.space_no,
+    seasonName,
+    weekLabel: weekKey === 'full_season' ? '全赛季' : '第' + weekKey.substring(1) + '周',
+    partName: PARTS[part] || String(part),
+    campName: MAP_CAMPS[camp] || String(camp),
+    prevLabel: prev ? prevSeason + ' 同周' : null,
+    win_rate: cur.win_rate, ping_rate: cur.ping_rate, fail_rate: cur.fail_rate,
+    win_rate_nodraw: nodraw,
+    prev,
+    endTime: seasonObj.end_time || null,
+  }
+}
+
+// ===== 模仿者查询主流程 =====
+
+async function collectMimic(config, name, cond) {
+  const parsed = parseMimicArgs(cond)
+  const src = await resolveSource(config)
+  const { base, meta } = src
+  const sourceLabel = base.replace(/^https?:\/\//, '')
+
+  const files = await loadMimicFileList(base, config.timeout)
+  if (!files.length) return { ok: false, error: '模仿者数据文件为空' }
+
+  let file
+  if (parsed.date) {
+    file = files.find(f => f.includes(parsed.date))
+    if (!file) {
+      return { ok: false, error: '未找到日期 ' + parsed.date + ' 的模仿者数据（可用 ' + files[0].substring(5, 11) + ' ~ ' + files[files.length - 1].substring(5, 11) + '）' }
+    }
+  } else {
+    file = files[files.length - 1]
+  }
+
+  const j = await fetchJson(url(base, '/胜率数据/模仿者游戏/json/' + file), config.timeout)
+  const allPlayerData = j.all_player_data || {}
+  const cfg = await loadMimicConfig(base, config.timeout)
+
+  const ids = Object.keys(cfg.idToName)
+  const exact = ids.find(id => cfg.idToName[id] === name)
+  let charId = exact
+  if (!charId) {
+    const fuzzy = ids.filter(id => cfg.idToName[id].includes(name) || name.includes(cfg.idToName[id]))
+    if (fuzzy.length === 1) charId = fuzzy[0]
+    else if (fuzzy.length > 1) {
+      return { ok: false, error: '角色名「' + name + '」匹配到多个角色：' + fuzzy.map(id => cfg.idToName[id]).join('、') }
+    }
+  }
+  if (!charId) {
+    return { ok: false, error: '未找到模仿者角色「' + name + '」\n可尝试：' + ids.map(id => cfg.idToName[id]).slice(0, 12).join('、') }
+  }
+
+  const campId = parseInt(charId)
+  const campName = campId < 200 ? '侦探团' : (campId < 300 ? '模仿者' : '中立')
+
+  const modes = []
+  Object.keys(MIMIC_MODES).forEach(modeKey => {
+    const md = allPlayerData[modeKey] && allPlayerData[modeKey][charId]
+    if (md) modes.push({ key: modeKey, label: MIMIC_MODES[modeKey], ...md })
+  })
+  if (!modes.length) return { ok: false, error: '角色「' + cfg.idToName[charId] + '」在该日期无数据' }
+
+  let primary = modes
+  let modeLabel = '所有模式'
+  if (parsed.mode) {
+    primary = modes.filter(m => m.key === parsed.mode)
+    if (!primary.length) return { ok: false, error: '模式「' + (MIMIC_MODES[parsed.mode] || parsed.mode) + '」无数据' }
+    modeLabel = MIMIC_MODES[parsed.mode]
+  }
+
+  return {
+    ok: true, base, sourceLabel, file,
+    name: cfg.idToName[charId], charId,
+    campName, campId,
+    dateLabel: '20' + file.substring(5, 7) + '.' + file.substring(7, 9) + '.' + file.substring(9, 11),
+    modes, primary: primary[0], modeLabel,
+  }
+}
+
+// ===== 勋章查询主流程 =====
+
+async function collectBadge(config, name, cond) {
+  const parsed = parseBadgeArgs(cond)
+  const src = await resolveSource(config)
+  const { base, meta } = src
+  const sourceLabel = base.replace(/^https?:\/\//, '')
+
+  const files = await loadBadgeFiles(base, config.timeout)
+  if (!files.length) return { ok: false, error: '勋章数据文件为空' }
+
+  let curDate = parsed.date
+  if (!curDate) {
+    curDate = files[files.length - 1].replace('Badge_', '').replace('.json', '')
+  }
+  const curFile = 'Badge_' + curDate + '.json'
+  if (!files.includes(curFile)) {
+    return { ok: false, error: '未找到日期 ' + curDate + ' 的勋章数据（最新 ' + files[files.length - 1].replace('Badge_', '').replace('.json', '') + '）' }
+  }
+
+  const cur = await loadBadgeMap(base, curFile, config.timeout)
+  const campNames = ['', '监管者', '求生者']
+
+  const names = Object.keys(cur.map)
+  const exact = names.find(n => n === name)
+  let heroName = exact
+  if (!heroName) {
+    const fuzzy = names.filter(n => n.includes(name) || name.includes(n))
+    if (fuzzy.length === 1) heroName = fuzzy[0]
+    else if (fuzzy.length > 1) {
+      return { ok: false, error: '角色名「' + name + '」匹配到多个角色：' + fuzzy.join('、') }
+    }
+  }
+  if (!heroName) return { ok: false, error: '未找到角色「' + name + '」\n相近角色：' + names.slice(0, 8).join('、') }
+
+  const campId = parseInt(cur.camps[heroName]) || 2
+  const curScores = cur.map[heroName] || {}
+
+  const delta = {}
+  let prevDate = null
+  if (parsed.mode === 'anomaly') {
+    BADGE_TIERS.forEach(t => {
+      const cv = curScores[t.key]
+      let sum = 0, cnt = 0
+      Object.keys(cur.map).forEach(nm => {
+        if (cur.camps[nm] !== String(campId)) return
+        const v = cur.map[nm][t.key]
+        if (v) { sum += v; cnt++ }
+      })
+      const avg = cnt ? sum / cnt : null
+      delta[t.key] = avg > 0 && cv != null ? (cv - avg) / avg * 100 : null
+    })
+  } else if (parsed.mode === 'season') {
+    prevDate = seasonComparisonDate(parseInt(curDate), meta.seasonList)
+    const prevFile = prevDate ? pickBadgeFile(files, prevDate, 30) : null
+    if (prevFile) {
+      const prev = await loadBadgeMap(base, prevFile, config.timeout)
+      const p = prev.map[heroName] || {}
+      BADGE_TIERS.forEach(t => {
+        delta[t.key] = p[t.key] > 0 && curScores[t.key] != null ? (curScores[t.key] - p[t.key]) / p[t.key] * 100 : null
+      })
+      prevDate = prevFile.replace('Badge_', '').replace('.json', '')
+    }
+  } else if (/^\d+d$/.test(parsed.mode)) {
+    const days = parseInt(parsed.mode)
+    const prevTarget = dateAddDays(parseInt(curDate), -days)
+    const prevFile = pickBadgeFile(files, prevTarget, 3)
+    if (prevFile) {
+      const prev = await loadBadgeMap(base, prevFile, config.timeout)
+      const p = prev.map[heroName] || {}
+      BADGE_TIERS.forEach(t => {
+        delta[t.key] = p[t.key] > 0 && curScores[t.key] != null ? (curScores[t.key] - p[t.key]) / p[t.key] * 100 : null
+      })
+      prevDate = prevFile.replace('Badge_', '').replace('.json', '')
+    }
+  }
+
+  const fmtDate = d => d ? String(d).substring(0, 4) + '.' + String(d).substring(4, 6) + '.' + String(d).substring(6, 8) : null
+
+  return {
+    ok: true, base, sourceLabel, file: curFile,
+    name: heroName, campName: campNames[campId] || '未知', campId,
+    dateLabel: fmtDate(curDate),
+    mode: parsed.mode, modeLabel: BADGE_MODES[parsed.mode] || parsed.mode,
+    tiers: BADGE_TIERS.map(t => ({
+      label: t.label, cls: t.cls,
+      val: curScores[t.key] != null ? curScores[t.key] : null,
+      delta: delta[t.key] != null ? delta[t.key] : null,
+    })),
+    prevDate: fmtDate(prevDate),
+  }
+}
+
 // ===== 主流程 =====
 
 async function collect(config, name, cond) {
@@ -531,7 +904,6 @@ function buildHtml(data, config) {
 
   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]
@@ -568,7 +940,8 @@ function buildHtml(data, config) {
   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>'
+    '<div class="allrank-grid">' + partsItems + '</div></div>' +
+    '<div class="credit">@夜莺小姐档案馆</div>'
 
   let zoneRight
   if (badge) {
@@ -588,9 +961,11 @@ function buildHtml(data, config) {
       '<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))
+      growBlock('距阵营平均值', growItems(badge.anomaly)) +
+      '<div class="cmd-hint">' + esc(buildHelp()) + '</div>'
   } else {
-    zoneRight = '<div class="stat-block"><div class="comp-title" style="color:var(--text-secondary)">暂无勋章数据</div></div>'
+    zoneRight = '<div class="stat-block"><div class="comp-title" style="color:var(--text-secondary)">暂无勋章数据</div></div>' +
+      '<div class="cmd-hint">' + esc(buildHelp()) + '</div>'
   }
 
   const position = card.entry.position
@@ -598,6 +973,14 @@ function buildHtml(data, config) {
   const avatarUrl = avatar ? avatar.replace(/\/+$/, '') + '/statics/角色头像/' + encodeURIComponent(name) + '.png' : ''
   const campName = card.camp === 1 ? '监管者' : '求生者'
 
+  const rankRows = buildRankRows(card, metric, data.badgeScores)
+  const rankBlock = rankRows.length
+    ? '<div class="zone-sep"></div>' +
+      '<div class="comp-title" style="color:var(--accent);margin-bottom:4px">本阵营排名（' + metricLabel + '）</div>' +
+      '<div class="rank-table"><div class="rank-row rank-header"><span class="rk-pos">排名</span><span class="rk-name">角色名</span><span class="rk-val">数据</span></div>' +
+      rankRows.join('') + '</div>'
+    : ''
+
   const zoneCenter =
     '<div class="card-avatar-wrap">' +
     (avatarUrl
@@ -607,8 +990,9 @@ function buildHtml(data, config) {
     '</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>'
+    '<div class="card-highlight ' + hlCls + '">' + fmtHigh(hl, metric) + '</div>' +
+    '<div class="card-highlight-label">' + metricLabel + ' · ' + partName + ' · #' + card.rank + '/' + card.total + '</div>' +
+    rankBlock
 
   const titleBar =
     '<span>' + seasonName + '</span><span class="sep">·</span>' +
@@ -642,8 +1026,18 @@ body { background:var(--bg); color:var(--text); font-family:-apple-system,BlinkM
 .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); }
+.rank-table { width:100%; border:1px solid rgba(255,255,255,.08); border-radius:8px; overflow:hidden; }
+.rank-row { display:grid; grid-template-columns:48px 1fr 84px; gap:6px; align-items:center; padding:8px 12px; background:rgba(255,255,255,.02); border-bottom:1px solid rgba(255,255,255,.05); font-size:16px; }
+.rank-row:last-child { border-bottom:none; }
+.rank-row.self { background:rgba(88,166,255,.12); border-left:3px solid var(--accent); font-weight:700; }
+.rank-header { background:rgba(255,255,255,.05); font-size:13px; color:var(--text-secondary); font-weight:600; }
+.rk-pos { color:var(--accent); font-weight:700; font-variant-numeric:tabular-nums; }
+.rank-row.self .rk-pos { color:var(--yellow); }
+.rk-name { white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+.rk-val { text-align:right; font-variant-numeric:tabular-nums; font-weight:600; font-size:16px; }
+.rank-header .rk-pos, .rank-header .rk-val { color:var(--text-secondary); font-weight:600; }
+.credit { text-align:center; color:var(--text-secondary); font-size:12px; margin-top:14px; opacity:.7; }
 .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; }
@@ -671,6 +1065,7 @@ body { background:var(--bg); color:var(--text); font-family:-apple-system,BlinkM
 .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; }
+.cmd-hint { margin-top:16px; padding:8px 12px; border:1px solid rgba(255,255,255,.08); border-radius:8px; background:rgba(22,27,34,.5); white-space:pre-wrap; font-family:inherit; font-size:10px; line-height:1.55; color:var(--accent); }
 </style>
 </head>
 <body>
@@ -695,6 +1090,236 @@ function fmtHigh(v, metric) {
   return (v * 100).toFixed(2) + '%'
 }
 
+function buildRankRows(card, metric, badgeScores) {
+  const { rank, total, ranking } = card
+  if (!rank || !total || !ranking || !ranking.length) return []
+  const lo = Math.max(1, rank - 5)
+  const hi = Math.min(total, rank + 5)
+  const list = []
+  if (1 < lo || 1 > hi) list.push(1)
+  for (let i = lo; i <= hi; i++) list.push(i)
+  if (total !== hi && total !== 1) list.push(total)
+  return list.map(r => {
+    const item = ranking[r - 1]
+    if (!item) return ''
+    const v = getMetricVal(item, metric, badgeScores)
+    const self = r === rank
+    return '<div class="rank-row' + (self ? ' self' : '') + '">' +
+      '<span class="rk-pos">#' + r + '</span>' +
+      '<span class="rk-name">' + esc(item.name) + '</span>' +
+      '<span class="rk-val">' + fmtHigh(v, metric) + '</span></div>'
+  })
+}
+
+// ===== 地图 HTML =====
+
+function buildMapHtml(data, config) {
+  const width = config.width || 1000
+  const d = (v, suffix) => v == null || isNaN(v) ? '--' : v.toFixed(2) + suffix
+  const diffHtml = (cur, prev) => {
+    if (cur == null || prev == null) return '<span class="stat-delta">--</span>'
+    const diff = cur - prev
+    const cls = Math.abs(diff) < 0.01 ? '' : (diff > 0 ? 'up' : 'down')
+    return '<span class="stat-delta ' + cls + '">' + (diff > 0 ? '+' : '') + diff.toFixed(2) + '%</span>'
+  }
+
+  const rows = [
+    { label: '胜率', cur: data.win_rate, prev: data.prev ? data.prev.win_rate : null },
+    { label: '平率', cur: data.ping_rate, prev: data.prev ? data.prev.ping_rate : null },
+    { label: '负率', cur: data.fail_rate, prev: data.prev ? data.prev.fail_rate : null },
+    { label: '去平胜率', cur: data.win_rate_nodraw, prev: data.prev ? data.prev.win_rate_nodraw : null },
+  ].map(r =>
+    '<div class="s-row"><span class="s-label">' + r.label + '</span>' +
+    '<span class="s-val">' + d(r.cur, '%') + '</span>' +
+    '<span class="s-rank" style="text-align:right;min-width:110px">' + (data.prev ? diffHtml(r.cur, r.prev) : '<span class="stat-delta">--</span>') + '</span></div>'
+  ).join('')
+
+  const prevBlock = data.prev
+    ? '<div class="zone-sep"></div><div class="comp-title" style="color:var(--accent);margin-bottom:4px">对比上赛季（' + data.prevLabel + '）</div>'
+    : ''
+
+  const titleBar =
+    '<span>' + data.seasonName + '</span><span class="sep">·</span>' +
+    '<span>' + data.weekLabel + '</span><span class="sep">·</span>' +
+    '<span>' + data.partName + '</span><span class="sep">·</span>' +
+    '<span>' + data.campName + '</span>'
+
+  const spaceNo = data.spaceNo != null ? '<div class="card-sub">地图编号 ' + esc(String(data.spaceNo)) + '</div>' : ''
+
+  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; }
+.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); }
+.card { background:var(--card-bg); border:1px solid var(--border); border-radius:18px; padding:22px 26px; max-width:560px; margin:0 auto; }
+.zone-center { display:flex; flex-direction:column; align-items:center; }
+.card-map-name { font-size:28px; font-weight:700; text-align:center; margin:4px 0 2px; }
+.card-sub { font-size:13px; color:var(--text-secondary); margin-bottom:10px; }
+.stat-block { display:flex; flex-direction:column; gap:6px; }
+.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:90px; flex-shrink:0; }
+.s-val { font-size:18px; font-weight:700; font-variant-numeric:tabular-nums; flex:1; text-align:center; }
+.s-rank { font-size:15px; min-width:110px; text-align:right; }
+.stat-delta { font-size:14px; font-weight:600; font-variant-numeric:tabular-nums; }
+.stat-delta.up { color:var(--green); }
+.stat-delta.down { color:var(--red); }
+.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; }
+.foot { text-align:center; color:var(--text-secondary); font-size:12px; margin-top:10px; opacity:.7; }
+</style>
+</head>
+<body>
+<div class="title-bar">${titleBar}</div>
+<div class="card">
+  <div class="zone-center">
+    <div class="card-map-name">${esc(data.mapName)}</div>
+    ${spaceNo}
+  </div>
+  <div class="stat-block">${rows}</div>
+  ${prevBlock}
+</div>
+<div class="foot">数据来源：${esc(data.sourceLabel)} · 数据均根据第五人格官方小程序数据计算</div>
+</body>
+</html>`
+}
+
+// ===== 模仿者 HTML =====
+
+function buildMimicHtml(data, config) {
+  const pct = v => v == null || isNaN(v) ? '--' : (v * 100).toFixed(2) + '%'
+  const p = data.primary
+  const rows = [
+    { label: '胜率', val: pct(p.win_rate) },
+    { label: '出场率', val: pct(p.show_rate) },
+    { label: '投票正确率', val: pct(p.vote_correct_rate) },
+    { label: '被杀率', val: pct(p.bekill_rate) },
+  ].map(r =>
+    '<div class="s-row"><span class="s-label">' + r.label + '</span>' +
+    '<span class="s-val">' + r.val + '</span><span class="s-rank"></span></div>'
+  ).join('')
+
+  const otherModes = data.modes.map(m => {
+    const isPrimary = m.key === p.key
+    return '<div class="mode-item' + (isPrimary ? ' active' : '') + '">' +
+      '<span class="mode-name">' + esc(m.label) + '</span>' +
+      '<span class="mode-val">' + pct(m.win_rate) + '</span></div>'
+  }).join('')
+
+  const titleBar =
+    '<span>' + data.dateLabel + '</span><span class="sep">·</span>' +
+    '<span>' + data.modeLabel + '</span><span class="sep">·</span>' +
+    '<span>' + data.campName + '</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; }
+.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); }
+.card { background:var(--card-bg); border:1px solid var(--border); border-radius:18px; padding:22px 26px; max-width:560px; margin:0 auto; }
+.zone-center { display:flex; flex-direction:column; align-items:center; }
+.card-char-name { font-size:28px; font-weight:700; text-align:center; margin:4px 0 2px; }
+.card-camp { font-size:13px; color:var(--accent); margin-bottom:12px; }
+.stat-block { display:flex; flex-direction:column; gap:6px; }
+.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:110px; flex-shrink:0; }
+.s-val { font-size:18px; font-weight:700; font-variant-numeric:tabular-nums; flex:1; text-align:center; }
+.s-rank { min-width:46px; }
+.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; }
+.mode-grid { display:grid; grid-template-columns:repeat(2,1fr); gap:6px; }
+.mode-item { display:flex; align-items:center; justify-content:space-between; padding:6px 10px; background:rgba(255,255,255,.02); border:1px solid rgba(255,255,255,.04); border-radius:5px; }
+.mode-item.active { border-color:var(--accent); }
+.mode-name { font-size:13px; color:var(--text-secondary); font-weight:600; }
+.mode-val { font-size:15px; font-weight:700; font-variant-numeric:tabular-nums; }
+.foot { text-align:center; color:var(--text-secondary); font-size:12px; margin-top:10px; opacity:.7; }
+</style>
+</head>
+<body>
+<div class="title-bar">${titleBar}</div>
+<div class="card">
+  <div class="zone-center">
+    <div class="card-char-name">${esc(data.name)}</div>
+    <div class="card-camp">${esc(data.campName)}</div>
+  </div>
+  <div class="stat-block">${rows}</div>
+  <div class="zone-sep"></div>
+  <div class="comp-title" style="color:var(--accent);margin-bottom:4px">各模式胜率</div>
+  <div class="mode-grid">${otherModes}</div>
+</div>
+<div class="foot">数据来源：${esc(data.sourceLabel)} · 数据文件：${esc(data.file)}</div>
+</body>
+</html>`
+}
+
+// ===== 勋章 HTML =====
+
+function buildBadgeHtml(data, config) {
+  const tierItems = data.tiers.map(t => {
+    const deltaHtml = data.mode === 'original'
+      ? ''
+      : '<div class="b-delta ' + (t.delta == null ? '' : (t.delta > 0 ? 'up' : (t.delta < 0 ? 'down' : ''))) + '">' +
+        (t.delta == null ? '--' : (t.delta > 0 ? '+' : '') + t.delta.toFixed(1) + '%') + '</div>'
+    return '<div class="card-badge-item ' + t.cls + '"><span class="b-tier">' + t.label + '</span>' +
+      '<span class="b-val">' + (t.val != null ? t.val : '--') + '</span>' + deltaHtml + '</div>'
+  }).join('')
+
+  const titleBar =
+    '<span>' + data.dateLabel + '</span><span class="sep">·</span>' +
+    '<span>' + data.modeLabel + '</span><span class="sep">·</span>' +
+    '<span>' + data.campName + '</span>'
+
+  const footNote = data.prevDate && data.mode !== 'original'
+    ? '<div class="foot">对比日期：' + data.prevDate + ' · 数据来源：' + esc(data.sourceLabel) + '</div>'
+    : '<div class="foot">数据来源：' + esc(data.sourceLabel) + '</div>'
+
+  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; }
+.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); }
+.card { background:var(--card-bg); border:1px solid var(--border); border-radius:18px; padding:22px 26px; max-width:560px; margin:0 auto; }
+.zone-center { display:flex; flex-direction:column; align-items:center; }
+.card-char-name { font-size:28px; font-weight:700; text-align:center; margin:4px 0 8px; }
+.card-badge-grid { display:grid; grid-template-columns:repeat(4,1fr); gap:8px; }
+.card-badge-item { display:flex; flex-direction:column; align-items:center; gap:3px; padding:8px 3px; background:rgba(255,255,255,.02); border:1px solid rgba(255,255,255,.04); border-radius:5px; }
+.b-tier { font-size:13px; color:var(--text-secondary); font-weight:700; }
+.b-val { font-size:18px; font-weight:700; font-variant-numeric:tabular-nums; }
+.b-delta { font-size:12px; font-weight:600; font-variant-numeric:tabular-nums; }
+.b-delta.up { color:var(--green); }
+.b-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="title-bar">${titleBar}</div>
+<div class="card">
+  <div class="zone-center"><div class="card-char-name">${esc(data.name)}</div></div>
+  <div class="card-badge-grid">${tierItems}</div>
+</div>
+${footNote}
+</body>
+</html>`
+}
+
 function buildHelp() {
   return [
     '查询角色胜率并生成图片',
@@ -714,16 +1339,55 @@ function buildHelp() {
   ].join('\n')
 }
 
+function buildHelpHtml(text, config) {
+  const width = config.width || 1000
+  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; --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; }
+.card { background:var(--card-bg); border:1px solid var(--border); border-radius:18px; padding:22px 26px; max-width:${Math.min(width, 720)}px; margin:0 auto; }
+.help-title { font-size:22px; font-weight:700; color:var(--accent); text-align:center; margin-bottom:14px; }
+.help-text { font-size:15px; line-height:1.8; white-space:pre-wrap; word-break:break-all; }
+.foot { text-align:center; color:var(--text-secondary); font-size:12px; margin-top:10px; opacity:.7; }
+</style>
+</head>
+<body>
+<div class="card">
+  <div class="help-title">指令帮助</div>
+  <div class="help-text">${esc(text)}</div>
+</div>
+<div class="foot">数据均根据第五人格官方小程序数据计算</div>
+</body>
+</html>`
+}
+
 module.exports = {
   KNOWN_SOURCES,
   METRICS,
   BADGE_TIERS,
   PARTS,
   PART_ORDER,
+  MAP_CAMPS,
+  MIMIC_MODES,
+  BADGE_MODES,
   parseArgs,
+  parseMapArgs,
+  parseMimicArgs,
+  parseBadgeArgs,
   resolveSource,
   collect,
+  collectMap,
+  collectMimic,
+  collectBadge,
   buildHtml,
+  buildMapHtml,
+  buildMimicHtml,
+  buildBadgeHtml,
   buildHelp,
+  buildHelpHtml,
   findSimilar,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-dwrgbwiki",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "第五人格BWIKI编辑组测试用组件，纯AI生成喵",
   "main": "index.js",
   "files": [

package/readme.md

@@ -2,16 +2,24 @@
 
 第五人格BWIKI编辑组测试用组件，纯AI生成喵。
 
-查询第五人格角色胜率，返回一张图片（样式参考 胜率数据站 animationshow.html 的角色卡片）。
+查询第五人格角色胜率、地图胜率、模仿者游戏数据、勋章分数线，返回一张图片（样式参考 胜率数据站 animationshow.html 的角色卡片）。
 
 需要安装 [koishi-plugin-puppeteer](https://www.npmjs.com/package/koishi-plugin-puppeteer) 用于截图。
 
 ## 用法
 
 ```
+BWIKI机器人
 胜率 <角色名> [赛季] [周数] [排序要素] [段位]
+地图 <地图名> [赛季] [周数] [段位] [阵营]
+模仿者 <角色名> [日期] [模式]
+勋章 <角色名> [日期] [模式]
 ```
 
+发送 `BWIKI机器人` 可查看当前支持的指令列表图片；发送 `胜率` 等单独指令可查看对应完整帮助。
+
+### 胜率（角色胜率）
+
 示例：
 
 | 指令 | 含义 |
@@ -26,6 +34,48 @@
 - 排序要素默认 `去平胜率`，可选：胜率、平率、负率、使用率、禁用率、S1/S10/A11/A100/B101/B300/C301/C500 勋章分
 - 段位默认 `巅七`，可选：七阶、六阶、五阶、四阶、三阶、二阶、一阶、全段位
 
+### 地图（地图胜率）
+
+示例：
+
+| 指令 | 含义 |
+| --- | --- |
+| `地图 军工厂` | 最新赛季最新周，监管者视角 |
+| `地图 红教堂 S44 3 求生者` | 指定赛季、周数与阵营 |
+| `地图 月亮河公园 全赛季 全段位` | 赛季累计与全段位 |
+| `地图 湖景` | 支持模糊匹配地图名 |
+
+- 阵营默认 `监管者`，可选：求生者；赛季：S44 / 第44赛季；周数：第3周 / 3
+- 段位默认 `巅七`，可选：七阶、六阶、五阶、四阶、三阶、二阶、一阶、全段位
+- 显示胜率/平率/负率/去平胜率，以及对比上赛季同周的变化
+
+### 模仿者（模仿者游戏数据）
+
+示例：
+
+| 指令 | 含义 |
+| --- | --- |
+| `模仿者 侦探` | 最新日期，所有模式 |
+| `模仿者 药剂师 260531 12人高级场` | 指定日期与模式 |
+
+- 日期：YYMMDD（如 260531），不填默认最新日期
+- 模式：低级场、10人高级场、12人高级场、所有模式（默认）
+- 显示胜率/出场率/投票正确率/被杀率，以及各模式胜率对比；角色阵营分为侦探团/模仿者/中立
+
+### 勋章（角色勋章分数线）
+
+示例：
+
+| 指令 | 含义 |
+| --- | --- |
+| `勋章 小女孩` | 最新日期，勋章分数 |
+| `勋章 小女孩 20250917 7日增长率` | 指定日期与模式 |
+| `勋章 小女孩 赛季同比增长率` | 对比上赛季同日 |
+
+- 日期：YYYYMMDD（如 20250917），不填默认最新日期
+- 模式：勋章分数（默认）、距平百分比、1/3/7/15/30日增长率、赛季同比增长率
+- 显示 S1/S10/A11/A100/B101/B300/C301/C500 八档勋章分数线
+
 ## 配置
 
 | 配置项 | 说明 | 默认值 |
@@ -33,9 +83,13 @@
 | `dataSource` | 数据源地址，可在两个镜像站点间切换 | `https://website.homeworkkun.top` |
 | `tryAlternate` | 主数据源失败时自动尝试备用数据源 | `true` |
 | `defaultPart` | 默认段位（8=巅七，-127=全段位） | `8` |
+| `mapDefaultCamp` | 地图查询默认阵营（1=监管者，2=求生者） | `1` |
 | `showBadge` | 显示勋章分数据 | `true` |
 | `badgeDays` | 勋章日增长率天数 | `7` |
-| `width` | 图片宽度（px） | `1000` |
+| `width` | 图片宽度（px），其他指令未单独设置时使用该值 | `1000` |
+| `mapWidth` | 地图指令图片宽度（px），0=使用默认宽度 | `0` |
+| `mimicWidth` | 模仿者指令图片宽度（px），0=使用默认宽度 | `0` |
+| `badgeWidth` | 勋章指令图片宽度（px），0=使用默认宽度 | `0` |
 | `scale` | 截图倍率 | `2` |
 | `timeout` | 网络请求超时（毫秒） | `15000` |
 
@@ -43,9 +97,29 @@
 
 ## 图片内容
 
+### 胜率
+
 - 标题栏：赛季 · 周数 · 段位 · 排序要素
 - 中央：角色头像、名称、定位/阵营、排序要素数值（含本阵营排名）、要素名
 - 左侧：六项数据（去平胜率/胜率/平率/负率/使用率/禁用率）及阵营排名、对比上赛季变化值与变化排名、各段位去平胜率（距平均）
 - 右侧：勋章分数（S1~C500）、赛季同比增长、日增长率、距阵营平均值
 
+### 地图
+
+- 标题栏：赛季 · 周数 · 段位 · 阵营
+- 中央：地图名、地图编号
+- 数据：胜率/平率/负率/去平胜率，及对比上赛季同周变化
+
+### 模仿者
+
+- 标题栏：日期 · 模式 · 阵营
+- 中央：角色名、阵营
+- 数据：胜率/出场率/投票正确率/被杀率，及各模式胜率对比
+
+### 勋章
+
+- 标题栏：日期 · 模式 · 阵营
+- 中央：角色名
+- 数据：S1~C500 八档勋章分数线，及所选模式（增长率/距平）计算值
+
 数据均根据第五人格官方小程序数据计算。