koishi-plugin-dwrgbwiki 2.3.0 → 2.4.1

package/index.js

@@ -235,20 +235,11 @@ module.exports = {
       .description('BWIKI 更新检查间隔（分钟）')
       .default(10),
     wikiWatchLimit: Schema.number().min(1).max(100)
-      .description('每次拉取的最近变更条数（用于发现新变更）')
+      .description('每次拉取的最近变更条数（同时决定每次推送最多列出的页面变更数）')
       .default(50),
-    wikiWatchDetailLimit: Schema.number().min(0).max(20)
-      .description('每次推送中获取详细更新内容（diff/新页面内容）的最大页面数，其余只推送标题与编辑摘要')
-      .default(5),
-    wikiWatchMaxItems: Schema.number().min(1).max(30)
-      .description('每次推送最多列出的页面变更数（超出部分仅提示数量）')
-      .default(15),
     wikiWatchMaxChars: Schema.number().min(100).max(3000)
       .description('单页更新内容摘要最大字符数')
       .default(500),
-    wikiWatchSkipBots: Schema.boolean()
-      .description('过滤机器人编辑（rcshow=!bot）')
-      .default(true),
     wikiWatchNamespaces: Schema.array(Schema.number())
       .description('监听的命名空间 id 列表（主命名空间=0；留空仅监听主命名空间）')
       .default([0]),
@@ -407,7 +398,9 @@ module.exports = {
           if (r.error) return '检查失败：' + r.error
           if (r.first) return '首次检查：已记录当前更新位置（本次不推送），之后的页面更新会自动推送到配置的目标'
           if (r.pushed) {
-            return '检查完成：检测到 ' + r.pushed + ' 个页面变更' + (r.sent === false ? '（但未推送：未配置目标或对应平台机器人不可用）' : '，已推送')
+            const msg = Array.isArray(r.message) ? r.message.slice() : [String(r.message || '检查完成')]
+            if (r.sent === false) msg.push('\n（未推送：未配置目标或对应平台机器人不可用，以下仅展示）')
+            return msg
           }
           return '检查完成：没有新的页面变更'
         }
@@ -532,10 +525,11 @@ module.exports = {
         if (subFn === '选手') {
           if (!p1 || !String(p1).trim()) return '请提供选手 id，格式：赛事 选手 <选手id>'
           const target = String(p1).trim()
+          const notFoundText = '当前赛事数据系统未收录【' + target + '】相关数据，请检查选手id是否输入正确。目前仅支持使用选手英文id进行查询。'
           try {
             const result = await match.loadPlayerData(config, target, mode)
             if (!result.data || (!result.data.hunter && !result.data.survivor)) {
-              return errorImage(ctx, config, '未找到选手「' + target + '」的数据，请检查 id 是否正确', '赛事')
+              return notFoundText
             }
             const width = cmdWidth(config, 'matchWidth')
             const updateTime = await match.loadAnnounceTime(config)
@@ -544,6 +538,7 @@ module.exports = {
             return updateTime ? [h.image(image, 'image/png'), '本页面数据上次更新时间：' + updateTime] : [h.image(image, 'image/png')]
           } catch (e) {
             ctx.logger('dwrgbwiki').warn('赛事查询失败: ' + (e && e.message ? e.message : e))
+            if (e && e.code === 'PLAYER_NOT_FOUND') return notFoundText
             const msg = (e && e.message || '').includes('404')
               ? '未找到选手「' + target + '」的数据，请检查 id 是否正确（大小写、别名）'
               : '赛事查询失败：' + (e && e.message ? e.message : e)

package/match.js

@@ -76,6 +76,13 @@ async function loadPlayerData(config, playerId, mergeMode) {
       if (key.toLowerCase() === lower) { mainId = key; break }
     }
   }
+  // 选手未收录：index 中不存在该 id（大小写不敏感）时直接抛专用错误，
+  // 避免对不存在的文件发起请求而报出「Unexpected token '<'」之类的晦涩 JSON 解析错误
+  if (!index[mainId]) {
+    const err = new Error('PLAYER_NOT_FOUND:' + String(playerId))
+    err.code = 'PLAYER_NOT_FOUND'
+    throw err
+  }
   // 收集候选文件：精确匹配 + 所有大小写变体
   const candidates = new Set()
   if (index[mainId]) candidates.add(index[mainId].file)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-dwrgbwiki",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "第五人格BWIKI编辑组开发，所有代码由DeepSeek V4 Flash 0731编写。支持胜率/地图/模仿者/勋章/基础数据查询、图鉴查询、wiki页面截图、藏头诗、抽卡模拟、加页手记探索、赛事数据（选手/对决）、公告变动推送、BWIKI页面更新推送、反馈系统等功能。",
   "main": "index.js",
   "files": [

package/readme.md

@@ -309,11 +309,8 @@ BWIKI更新监控 [检查]
 | `wikiWatchPlatform` | BWIKI 更新推送的平台（如 `qq`），留空禁用推送 | `qq` |
 | `wikiWatchTargets` | BWIKI 更新推送目标列表（与 `noticeTargets` 同构：每行一个目标，类型 channel=群/频道 或 private=私聊、目标 id），可添加多个 | 空 |
 | `wikiWatchInterval` | BWIKI 更新检查间隔（分钟） | `10` |
-| `wikiWatchLimit` | 每次拉取的最近变更条数（用于发现新变更） | `50` |
-| `wikiWatchDetailLimit` | 每次推送中获取详细更新内容（diff/新页面内容）的最大页面数，其余只推送标题与编辑摘要 | `5` |
-| `wikiWatchMaxItems` | 每次推送最多列出的页面变更数（超出部分仅提示数量） | `15` |
+| `wikiWatchLimit` | 每次拉取的最近变更条数（同时决定每次推送最多列出的页面变更数） | `50` |
 | `wikiWatchMaxChars` | 单页更新内容摘要最大字符数 | `500` |
-| `wikiWatchSkipBots` | 过滤机器人编辑（`rcshow=!bot`） | `true` |
 | `wikiWatchNamespaces` | 监听的命名空间 id 列表（主命名空间=0；留空仅监听主命名空间） | `[0]` |
 
 数据源两个镜像：`https://website.homeworkkun.top` 与 `https://web.homeworkkun.top`，可直接在配置中切换。
@@ -343,15 +340,16 @@ BWIKI更新监控 [检查]
 
 启用 `wikiWatchEnable` 后，插件会定时（`wikiWatchInterval` 分钟）调用第五人格 BWIKI 的 MediaWiki API（`https://wiki.biligame.com/dwrg/api.php`）：
 
-1. `action=query&list=recentchanges` 获取最近更新的页面（默认只监听主命名空间，可配置 `wikiWatchNamespaces`；`wikiWatchSkipBots` 可过滤机器人编辑）
+1. `action=query&list=recentchanges` 获取最近更新的页面（默认只监听主命名空间，可配置 `wikiWatchNamespaces`；**不过滤机器人编辑**）
 2. 对每个新变更调用 `action=compare` 拉取该次编辑的差异（纯文本 unified diff）作为「最后更新内容」；新创建的页面则拉取最新内容前段
+3. 编辑者的 bilibili 数字 uid 通过 bilibili 空间接口解析为真实用户名（如 `2086555` → 摸鱼达人作业君），解析失败时回退显示 uid
 
-汇总为一条文字消息，通过 `wikiWatchPlatform` 平台的机器人推送到 `wikiWatchTargets` 列表中的全部目标（每行一个目标，可混用 `channel` 群/频道与 `private` 私聊），格式为：页面标题（新页面标 🆕）、编辑者、时间、编辑摘要、大小变化、更新内容摘要（`wikiWatchMaxChars` 截断）、页面链接。
+汇总后渲染为一张图片（每轮最多 `wikiWatchLimit` 个页面，全部附更新内容），通过 `wikiWatchPlatform` 平台的机器人推送到 `wikiWatchTargets` 列表中的全部目标（每行一个目标，可混用 `channel` 群/频道与 `private` 私聊）。图片内容为：页面标题（新页面标 🆕）、编辑者昵称、时间、编辑摘要、大小变化、更新内容（diff 的 `+` 行绿、`-` 行红）；不包含页面链接。
 
 - 首次启动只记录基线（当前最新变更位置），不推送；之后检测到新变更才推送
 - 已处理的最新变更 id 持久化到数据库（`wiki_data` 表），机器人重启后从上次位置继续，不会重复推送
-- 每次推送最多列出 `wikiWatchMaxItems` 个变更，其中最新的 `wikiWatchDetailLimit` 个会附详细更新内容，其余仅标题与摘要
-- 任何成员可发送 `BWIKI更新监控` 查看监控状态，发送 `BWIKI更新监控 检查` 立即执行一次检查（首次检查只记录基线）
+- 渲染失败或没有 puppeteer 时自动回退为纯文本推送
+- 任何成员可发送 `BWIKI更新监控` 查看监控状态，发送 `BWIKI更新监控 检查` 立即执行一次检查（返回图片，首次检查只记录基线）
 - 请求带浏览器 User-Agent，遇到 BWIKI 限流（HTTP 567/429/503）自动重试，检查失败只记录日志，不影响下次轮询
 
 ## 图片内容

package/wikiwatch.js

@@ -2,14 +2,16 @@
 
 // ===== 第五人格 BWIKI 页面更新监听 =====
 // 定时调用 MediaWiki API（wiki.biligame.com/dwrg/api.php）：
-//   1. list=recentchanges 获取最近更新的页面（默认主命名空间，可过滤机器人编辑）
+//   1. list=recentchanges 获取最近更新的页面（默认主命名空间，不过滤机器人编辑）
 //   2. 对每个新变更 action=compare 拉取该次编辑的差异（difftype=unified 纯文本 diff）；
 //      新页面则拉取最新版本内容的前段
-// 汇总成文字消息，通过配置的机器人平台（wikiWatchPlatform）推送到目标群聊/私聊列表
-// （wikiWatchTargets，与公告推送同构，每行一个目标：类型 + id）。
+//   3. 编辑者的 bilibili 数字 uid 通过 bilibili 空间接口解析为真实用户名
+// 汇总后渲染为一张图片推送到配置的目标群聊/私聊列表（wikiWatchTargets）。
 // 首次启动只记录基线不推送；已处理的最新 rcid 持久化到数据库（wiki_data 表），
 // 重启后从上次位置继续，不会重复推送。
 
+const { h } = require('koishi')
+const crypto = require('crypto')
 const API_BASE = 'https://wiki.biligame.com/dwrg'
 const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36'
 const RETRY_WAIT = [3000, 8000] // BWIKI 限流/安全策略（567/429/503）时的重试间隔
@@ -55,7 +57,7 @@ function buildNamespaceParam(config) {
   return encodeURIComponent(list.join('|'))
 }
 
-// 拉取最近变更（返回 recentchanges 记录数组，按时间倒序）
+// 拉取最近变更（返回 recentchanges 记录数组，按时间倒序；不过滤机器人编辑）
 async function fetchRecentChanges(config) {
   const timeout = Math.max(config.timeout || 15000, 20000)
   const limit = clamp(config.wikiWatchLimit, 1, 100, 50)
@@ -64,7 +66,6 @@ async function fetchRecentChanges(config) {
     '&rclimit=' + limit +
     '&rcprop=' + encodeURIComponent('title|ids|timestamp|user|comment|flags|sizes') +
     '&rctype=' + encodeURIComponent('edit|new') +
-    (config.wikiWatchSkipBots === false ? '' : '&rcshow=!bot') +
     '&format=json&formatversion=2'
   const data = await fetchJson(url, timeout)
   return (data.query && data.query.recentchanges) || []
@@ -136,40 +137,296 @@ function fmtTime(ts) {
   }
 }
 
-function indentText(text, prefix) {
-  return String(text).split('\n').map(l => prefix + l).join('\n')
+// ===== bilibili uid → 用户名解析 =====
+// BWIKI 账号绑定 bilibili，MediaWiki 返回的 user 是数字 uid。通过 bilibili 多个来源
+// 解析真实用户名：
+//   1. WBI 签名后的 x/space/wbi/acc/info（官方推荐，需动态取 wbi 密钥）
+//   2. 未签名 x/space/acc/info、x/web-interface/card（部分环境仍可用）
+//   3. 空间页 <title>（服务端渲染，含用户名）
+// 全部失败时回退显示 uid。
+// 成功结果永久缓存；失败结果缓存 10 分钟后自动重试（避免首轮风控导致一直显示 uid）。
+// 每个 uid 首次失败会打一条 warn 日志，便于排查具体原因。
+
+const NAME_CACHE = new Map()
+
+// wbi 签名混盐索引表（bilibili 官方 hash 算法，公开常量）
+const MIXIN_KEY_ENC_TAB = [46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35, 27, 43, 5, 49, 33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13, 37, 48, 7, 16, 24, 55, 40, 61, 26, 17, 0, 1, 60, 51, 30, 4, 22, 25, 54, 21, 56, 59, 6, 63, 57, 62, 11, 36, 20, 34, 44, 52]
+
+const NEG_CACHE_TTL = 10 * 60 * 1000 // 失败缓存有效期 10 分钟
+const BILI_TIMEOUT = 6000
+
+let biliMixinKey = null
+let biliMixinTs = 0
+
+async function fetchBiliJson(url, timeout) {
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), timeout)
+  try {
+    const headers = {
+      'User-Agent': UA,
+      'Accept-Language': 'zh-CN,zh;q=0.9',
+      'Accept': 'application/json, text/plain, */*',
+      'Referer': 'https://space.bilibili.com/',
+    }
+    const res = await fetch(url, { signal: ctrl.signal, headers })
+    if (!res.ok) return { __status: res.status }
+    return await res.json()
+  } catch (e) {
+    return { __error: e && e.message ? e.message : String(e) }
+  } finally {
+    clearTimeout(timer)
+  }
 }
 
-// 汇总推送消息（单页内容摘要按 wikiWatchMaxChars 截断，总长度 4000 字符防刷屏）
-function buildWatchMessage(items, maxChars) {
-  const cap = clamp(maxChars, 100, 3000, 500)
-  const lines = []
-  lines.push('【第五人格 BWIKI 更新】检测到 ' + items.length + ' 个页面变更')
-  for (const it of items) {
-    lines.push('')
-    lines.push((it.isNew ? '🆕 ' : '📄 ') + it.title)
+// 动态获取 wbi 混盐密钥（48 位原始 key → 32 位 mixin key），缓存 4 小时
+async function ensureBiliMixinKey() {
+  if (biliMixinKey && Date.now() - biliMixinTs < 4 * 60 * 60 * 1000) return biliMixinKey
+  const data = await fetchBiliJson('https://api.bilibili.com/x/web-interface/nav', BILI_TIMEOUT)
+  const img = data && data.data && data.data.wbi_img && data.data.wbi_img.img_url
+  const sub = data && data.data && data.data.wbi_img && data.data.wbi_img.sub_url
+  if (!img || !sub) return null
+  const raw = (String(img).split('/').pop() + String(sub).split('/').pop()).replace(/\.\w+$/, '')
+  if (raw.length < 64) return null
+  let mixin = ''
+  for (const i of MIXIN_KEY_ENC_TAB) mixin += raw[i]
+  biliMixinKey = mixin.slice(0, 32)
+  biliMixinTs = Date.now()
+  return biliMixinKey
+}
+
+// 生成 wbi 签名后的完整接口 URL
+function wbiSignUrl(endpoint, params, mixinKey) {
+  const p = Object.assign({}, params)
+  p.wts = Math.round(Date.now() / 1000)
+  const query = Object.keys(p).sort().map(k => k + '=' + encodeURIComponent(p[k])).join('&')
+  const wRid = crypto.createHash('md5').update(query + mixinKey).digest('hex')
+  return endpoint + '?' + query + '&w_rid=' + wRid
+}
+
+// 从 bilibili 返回体提取用户名：acc/info 是 data.name，card 是 data.card.name
+function extractBiliName(d) {
+  if (!d || d.code !== 0 || !d.data) return null
+  if (d.data.name && String(d.data.name).trim()) return String(d.data.name).trim()
+  if (d.data.card && d.data.card.name && String(d.data.card.name).trim()) return String(d.data.card.name).trim()
+  return null
+}
+
+// 尝试解析 uid 对应的用户名；失败返回 null
+async function tryResolveName(uid) {
+  // 1) WBI 签名接口（最可靠）
+  const mixinKey = await ensureBiliMixinKey()
+  if (mixinKey) {
+    const url = wbiSignUrl('https://api.bilibili.com/x/space/wbi/acc/info', { mid: uid }, mixinKey)
+    const d = await fetchBiliJson(url, BILI_TIMEOUT)
+    const n = extractBiliName(d)
+    if (n) return n
+  }
+  // 2) 未签名接口（部分环境仍可用，card 结构为 data.card.name）
+  for (const ep of [
+    'https://api.bilibili.com/x/space/acc/info?mid=' + uid,
+    'https://api.bilibili.com/x/web-interface/card?mid=' + uid,
+  ]) {
+    const d = await fetchBiliJson(ep, BILI_TIMEOUT)
+    const n = extractBiliName(d)
+    if (n) return n
+  }
+  // 3) 空间页 <title>（服务端渲染，含用户名）
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), BILI_TIMEOUT)
+  try {
+    const res = await fetch('https://space.bilibili.com/' + uid, {
+      signal: ctrl.signal,
+      headers: { 'User-Agent': UA, 'Accept-Language': 'zh-CN,zh;q=0.9' },
+    })
+    if (res.ok) {
+      const t = await res.text()
+      const m = t.match(/<title>([^<]+)<\/title>/)
+      if (m && m[1]) {
+        let s = String(m[1]).replace(/[_\-　]\s*哔哩哔哩.*$/i, '').replace(/\s*[-_]\s*bilibili.*$/i, '').trim()
+        // 过滤占位/错误标题，避免把无意义文本当用户名
+        if (s && !/^[\d\s]+$/.test(s) && !/^(加载中|请稍候|没有找到|错误|验证|访问|403|404|412|哔哩哔哩)/.test(s)) return s
+      }
+    }
+  } catch (e) { /* 忽略 */ }
+  finally { clearTimeout(timer) }
+  return null
+}
+
+async function resolveUserName(logger, uid) {
+  const key = String(uid == null ? '' : uid).trim()
+  if (!/^\d+$/.test(key)) return key || '' // 非数字 uid（普通用户名）原样返回
+  const cached = NAME_CACHE.get(key)
+  if (cached) {
+    if (cached.name) return cached.name // 已解析成功
+    if (Date.now() - cached.ts < NEG_CACHE_TTL) return key // 失败缓存期内
+  }
+  const found = await tryResolveName(key)
+  if (found) {
+    NAME_CACHE.set(key, { name: found, ts: Date.now() })
+    return found
+  }
+  // 解析失败：短时缓存（10 分钟）以便自动重试；每个 uid 每进程只打一次日志
+  NAME_CACHE.set(key, { name: null, ts: Date.now(), logged: true })
+  if (!cached || !cached.logged) {
+    logger.warn('BWIKI更新昵称解析失败（显示 uid），请检查 bilibili 接口可达性: ' + key)
+  }
+  return key
+}
+
+// ===== 文本渲染为图片 =====
+
+function escHtml(s) {
+  return String(s == null ? '' : s)
+    .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;').replace(/'/g, '&#39;')
+}
+
+// 更新内容块：diff 的 + 行标绿、- 行标红；普通行中性色
+function renderContentHtml(text, maxChars) {
+  let t = String(text || '').replace(/\n{2,}/g, '\n').trim()
+  if (t.length > maxChars) t = t.slice(0, maxChars) + '…'
+  const lines = t.split('\n').map(l => {
+    const esc = escHtml(l)
+    if (l.charAt(0) === '+') return '<div class="ln add">' + esc + '</div>'
+    if (l.charAt(0) === '-') return '<div class="ln del">' + esc + '</div>'
+    return '<div class="ln">' + esc + '</div>'
+  }).join('')
+  return '<div class="content">' + lines + '</div>'
+}
+
+function buildWatchHtml(items, config) {
+  const width = config.width || 1300
+  const title = escHtml(config.summaryTitle || ('检测到 ' + items.length + ' 个页面变更'))
+  const cards = items.map(it => {
+    const tag = it.isNew ? '<span class="tag-new">🆕 新页面</span>' : '<span class="tag-edit">✏️ 编辑</span>'
     const meta = []
-    if (it.user) meta.push(it.user)
-    meta.push(fmtTime(it.time))
+    if (it.user) meta.push('<span class="m-user">👤 ' + escHtml(it.user) + '</span>')
+    meta.push('<span>🕒 ' + escHtml(fmtTime(it.time)) + '</span>')
+    if (it.comment) meta.push('<span class="m-comment">💬 “' + escHtml(it.comment) + '”</span>')
+    if (it.minor) meta.push('<span class="m-minor">（小编辑）</span>')
+    const size = it.sizeDelta != null
+      ? '<div class="size">大小：' + (it.sizeDelta >= 0 ? '+' : '') + it.sizeDelta + ' 字节</div>'
+      : ''
+    const content = it.detail && it.detail.text
+      ? renderContentHtml(it.detail.text, clamp(config.wikiWatchMaxChars, 100, 3000, 500))
+      : ''
+    return '<div class="card">' +
+      '<div class="c-head">' + tag + '<span class="c-title">' + escHtml(it.title) + '</span></div>' +
+      '<div class="c-meta">' + meta.join('<span class="sep">·</span>') + '</div>' +
+      size +
+      content +
+      '</div>'
+  }).join('')
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<style>
+* { margin:0; padding:0; box-sizing:border-box; }
+body { font-family:-apple-system,BlinkMacSystemFont,'Segoe UI','Microsoft YaHei',sans-serif; color:#e6edf3;
+  background:radial-gradient(1400px 700px at 50% -10%, #1b2a4a 0%, #10182b 45%, #0a0e17 100%); padding:24px 20px; }
+.page { max-width:${width}px; margin:0 auto; }
+.hero { text-align:center; padding:24px 22px 20px; border-radius:18px; margin-bottom:18px;
+  background:linear-gradient(135deg, #667eea 0%, #764ba2 55%, #a4508b 100%); box-shadow:0 8px 28px rgba(0,0,0,.4); position:relative; overflow:hidden; }
+.hero::after { content:''; position:absolute; inset:0; background:radial-gradient(600px 200px at 80% -20%, rgba(255,255,255,.18), transparent 60%); }
+.badge { display:inline-flex; font-size:22px; font-weight:700; color:#ffd76d; background:rgba(0,0,0,.28);
+  border:1px solid rgba(255,215,109,.4); border-radius:999px; padding:4px 14px; margin-bottom:10px; letter-spacing:1px; }
+.title { font-size:32px; font-weight:800; color:#fff; letter-spacing:2px; text-shadow:0 2px 10px rgba(0,0,0,.35); }
+.sub { font-size:22px; color:rgba(255,255,255,.8); margin-top:8px; letter-spacing:.5px; }
+.card { background:rgba(22,27,34,.8); border:1px solid rgba(255,255,255,.09); border-radius:16px; padding:16px 18px; margin-bottom:14px; }
+.c-head { display:flex; align-items:center; gap:10px; font-size:24px; margin-bottom:8px; }
+.tag-new { flex-shrink:0; font-size:20px; font-weight:700; color:#0d1117; background:linear-gradient(135deg,#3fb950,#2ea043); border-radius:999px; padding:2px 10px; }
+.tag-edit { flex-shrink:0; font-size:20px; font-weight:700; color:#0d1117; background:linear-gradient(135deg,#58a6ff,#4c8dff); border-radius:999px; padding:2px 10px; }
+.c-title { font-weight:800; color:#fff; letter-spacing:.5px; word-break:break-all; }
+.c-meta { display:flex; align-items:center; flex-wrap:wrap; gap:10px; font-size:21px; color:#79c0ff; margin-bottom:6px; }
+.c-meta .sep { color:rgba(255,255,255,.3); }
+.m-user { color:#ffd76d; font-weight:700; }
+.m-comment { color:#c9d1d9; }
+.m-minor { color:#8b949e; font-size:19px; }
+.size { font-size:20px; color:#8b949e; margin-bottom:6px; }
+.content { background:rgba(0,0,0,.25); border:1px solid rgba(255,255,255,.07); border-radius:10px; padding:10px 12px; }
+.ln { font-size:21px; line-height:1.7; color:#c9d1d9; white-space:pre-wrap; word-break:break-all; font-family:'SFMono-Regular',Consolas,'Liberation Mono',Menlo,monospace; }
+.ln.add { color:#3fb950; }
+.ln.del { color:#f85149; }
+.foot { text-align:center; color:#8b949e; font-size:20px; margin-top:12px; opacity:.75; letter-spacing:.5px; }
+</style>
+</head>
+<body>
+<div class="page">
+  <div class="hero">
+    <div class="badge">🛰️ 第五人格 BWIKI 更新</div>
+    <div class="title">${title}</div>
+    <div class="sub">数据来源：第五人格 BWIKI · 最近更改</div>
+  </div>
+  ${cards}
+  <div class="foot">数据来源：第五人格 BWIKI</div>
+</div>
+</body>
+</html>`
+}
+
+// 通过 puppeteer 把 HTML 渲染为 PNG；无 puppeteer / 渲染失败返回 null（调用方回退文本）
+async function renderWatchHtml(ctx, html, config) {
+  if (!ctx.puppeteer) return null
+  try {
+    const width = config.width || 1300
+    const page = await ctx.puppeteer.page()
+    try {
+      await page.setViewport({ width, height: 400, deviceScaleFactor: config.scale || 2 })
+      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(() => {})
+    }
+  } catch (e) {
+    return null
+  }
+}
+
+// 纯文本回退（无 puppeteer / 渲染失败时使用；不含标题行，标题由 buildWatchOutput 统一给出）
+function buildWatchText(items, maxChars) {
+  const blocks = []
+  for (const it of items) {
+    const b = []
+    b.push((it.isNew ? '🆕 ' : '📄 ') + it.title)
+    const meta = [it.user, fmtTime(it.time)].filter(Boolean)
     if (it.comment) meta.push('“' + it.comment + '”')
     if (it.minor) meta.push('（小编辑）')
-    lines.push('  ' + meta.join(' · '))
-    if (it.sizeDelta != null) {
-      lines.push('  大小：' + (it.sizeDelta >= 0 ? '+' : '') + it.sizeDelta + ' 字节')
-    }
+    b.push('  ' + meta.join(' · '))
+    if (it.sizeDelta != null) b.push('  大小：' + (it.sizeDelta >= 0 ? '+' : '') + it.sizeDelta + ' 字节')
     if (it.detail && it.detail.text) {
-      let text = String(it.detail.text).replace(/\n{2,}/g, '\n').trim()
-      if (text.length > cap) text = text.slice(0, cap) + '…'
-      if (text) lines.push('  更新内容：\n' + indentText(text, '    '))
+      let t = String(it.detail.text).replace(/\n{2,}/g, '\n').trim()
+      if (t.length > maxChars) t = t.slice(0, maxChars) + '…'
+      if (t) b.push('  更新内容：\n' + indentText(t, '    '))
     }
-    lines.push('  🔗 https://wiki.biligame.com/dwrg/' + encodeURIComponent(it.title))
+    blocks.push(b.join('\n'))
   }
-  let msg = lines.join('\n')
-  const MAX_TOTAL = 4000
-  if (msg.length > MAX_TOTAL) msg = msg.slice(0, MAX_TOTAL) + '\n…（内容过长已截断）'
+  let msg = blocks.join('\n\n')
+  if (msg.length > 4000) msg = msg.slice(0, 4000) + '\n…（内容过长已截断）'
   return msg
 }
 
+function indentText(text, prefix) {
+  return String(text).split('\n').map(l => prefix + l).join('\n')
+}
+
+// 汇总输出：优先渲染为图片，失败回退纯文本。返回 koishi 元素数组
+async function buildWatchOutput(ctx, config, items, logger) {
+  const summary = '检测到 ' + items.length + ' 个页面变更'
+  try {
+    const html = buildWatchHtml(items, { ...config, summaryTitle: summary })
+    const img = await renderWatchHtml(ctx, html, config)
+    if (img) return [h.image(img, 'image/png')]
+  } catch (e) {
+    logger.warn('BWIKI更新图片渲染失败，回退纯文本: ' + (e && e.message ? e.message : e))
+  }
+  return ['【第五人格 BWIKI 更新】' + summary, '\n' + buildWatchText(items, clamp(config.wikiWatchMaxChars, 100, 3000, 500))]
+}
+
 // 汇总推送目标列表（wikiWatchTargets：多目标，群/频道与私聊可混用；与公告推送一致）
 function buildWatchTargets(config) {
   const list = Array.isArray(config.wikiWatchTargets) ? config.wikiWatchTargets : []
@@ -187,7 +444,7 @@ function buildWatchTargets(config) {
   return targets
 }
 
-// 推送到全部目标，任一目标成功即视为成功（其余目标失败仅记录日志）
+// 推送到全部目标，任一目标成功即视为成功（其余目标失败仅记录日志）。content 为元素数组或字符串。
 async function sendWatchMessage(ctx, config, content, logger) {
   const targets = buildWatchTargets(config)
   if (!config.wikiWatchPlatform || !targets.length) return false
@@ -243,7 +500,7 @@ function startWikiWatchMonitor(ctx, config) {
     } catch (e) { /* 忽略 */ }
   }
 
-  // 执行一次检查。返回 { pushed, first, sent } 或 { error }
+  // 执行一次检查。返回 { pushed, first, sent, message } 或 { error }
   const check = async () => {
     if (state.running) return { error: '正在检查中，请稍后再试' }
     state.running = true
@@ -252,7 +509,7 @@ function startWikiWatchMonitor(ctx, config) {
       state.lastCheck = fmtTime(new Date().toISOString())
       state.lastError = null
       const changes = await fetchRecentChanges(config)
-      if (!changes.length) return { pushed: 0, first: state.lastRcid == null }
+      if (!changes.length) return { pushed: 0, first: state.lastRcid == null, message: null }
 
       const firstRun = state.lastRcid == null
       const fresh = [] // 相对上次位置新增的变更（倒序）
@@ -269,12 +526,10 @@ function startWikiWatchMonitor(ctx, config) {
         state.lastRcid = newest
         await saveState()
       }
-      if (firstRun || !fresh.length) return { pushed: 0, first: firstRun }
+      if (firstRun || !fresh.length) return { pushed: 0, first: firstRun, message: null }
 
       fresh.reverse() // 转为时间正序（旧 → 新）
 
-      const maxItems = clamp(config.wikiWatchMaxItems, 1, 30, 15)
-      const detailLimit = clamp(config.wikiWatchDetailLimit, 0, 20, 5)
       const items = []
       for (let i = 0; i < fresh.length; i++) {
         const c = fresh[i]
@@ -289,23 +544,22 @@ function startWikiWatchMonitor(ctx, config) {
           isNew: c.type === 'new' || !!c.new,
           sizeDelta: !isNaN(nl) && !isNaN(ol) && nl !== undefined && ol !== undefined ? nl - ol : null,
         }
-        // 只对最新的 detailLimit 条拉取详细内容（其余仅摘要），控制 API 请求量
-        if (i >= fresh.length - detailLimit) {
-          try {
-            item.detail = await fetchDiffDetail(config, c)
-          } catch (e) {
-            logger.warn('BWIKI更新详情获取失败(' + item.title + '): ' + (e && e.message ? e.message : e))
-          }
+        try {
+          item.detail = await fetchDiffDetail(config, c)
+        } catch (e) {
+          logger.warn('BWIKI更新详情获取失败(' + item.title + '): ' + (e && e.message ? e.message : e))
         }
         items.push(item)
       }
 
-      const shown = items.slice(-maxItems) // 保留最新的 maxItems 条
-      const omitted = items.length - shown.length
-      let msg = buildWatchMessage(shown, config.wikiWatchMaxChars)
-      if (omitted > 0) msg += '\n…另有 ' + omitted + ' 个变更未列出（可调大 wikiWatchMaxItems）'
-      const sent = await sendWatchMessage(ctx, config, msg, logger)
-      return { pushed: shown.length, first: false, sent }
+      // 解析编辑者昵称：bilibili 数字 uid → 真实用户名
+      for (const it of items) {
+        if (it.user) it.user = await resolveUserName(logger, it.user)
+      }
+
+      const message = await buildWatchOutput(ctx, config, items, logger)
+      const sent = await sendWatchMessage(ctx, config, message, logger)
+      return { pushed: items.length, first: false, sent, message }
     } catch (e) {
       state.lastError = (e && e.message ? e.message : String(e))
       logger.warn('BWIKI更新检查失败: ' + state.lastError)
@@ -333,5 +587,7 @@ module.exports = {
   buildWatchTargets,
   fetchRecentChanges,
   fetchDiffDetail,
-  buildWatchMessage,
+  buildWatchHtml,
+  buildWatchText,
+  resolveUserName,
 }