koishi-plugin-dwrgbwiki 2.2.3 → 2.4.0

package/index.js

@@ -9,6 +9,7 @@ const wiki = require('./wiki')
 const cangtou = require('./cangtou')
 const match = require('./match')
 const notice = require('./notice')
+const wikiwatch = require('./wikiwatch')
 
 const HELP = lib.buildHelp()
 
@@ -54,6 +55,8 @@ const MAIN_HELP = [
   '    反馈问题或建议（私聊推送给管理员）',
   '  公告 [源]',
   '    查看最新完整公告图片，源可选 正式/共研/全部，例：公告',
+  '  BWIKI更新监控 [检查]',
+  '    查看/触发 BWIKI 页面更新监控，例：BWIKI更新监控 检查',
   '',
   '发送“胜率”“抽卡”等单独指令可查看对应完整帮助',
   '数据均根据第五人格官方小程序数据计算',
@@ -212,6 +215,34 @@ module.exports = {
     noticeInterval: Schema.number().min(1).max(1440)
       .description('公告检查间隔（分钟）')
       .default(10),
+    wikiWatchEnable: Schema.boolean()
+      .description('启用 BWIKI 页面更新监听（定期检查页面更新并推送变更内容到目标群聊）')
+      .default(false),
+    wikiWatchPlatform: Schema.string()
+      .description('BWIKI 更新推送的平台（如 qq），留空禁用推送')
+      .default('qq'),
+    wikiWatchTargets: Schema.array(Schema.object({
+      type: Schema.union(['channel', 'private'])
+        .description('目标类型：channel=群/频道，private=私聊')
+        .default('channel'),
+      id: Schema.string().required()
+        .description('群/频道 id（channel 类型）或用户 id（private 类型）'),
+    }))
+      .role('table')
+      .description('BWIKI 更新推送目标列表，以表格形式通过「添加项目」新增推送目标（每行一个目标），可添加多个，群/频道与私聊可同时推送')
+      .default([]),
+    wikiWatchInterval: Schema.number().min(1).max(1440)
+      .description('BWIKI 更新检查间隔（分钟）')
+      .default(10),
+    wikiWatchLimit: Schema.number().min(1).max(100)
+      .description('每次拉取的最近变更条数（同时决定每次推送最多列出的页面变更数）')
+      .default(50),
+    wikiWatchMaxChars: Schema.number().min(100).max(3000)
+      .description('单页更新内容摘要最大字符数')
+      .default(500),
+    wikiWatchNamespaces: Schema.array(Schema.number())
+      .description('监听的命名空间 id 列表（主命名空间=0；留空仅监听主命名空间）')
+      .default([0]),
     进阶设置: Schema.object({
       codexCommands: Schema.array(Schema.object({
         name: Schema.string().required()
@@ -300,6 +331,10 @@ module.exports = {
     if (config.noticeEnable) {
       startNoticeMonitor(ctx, config)
     }
+    let watchApi = null
+    if (config.wikiWatchEnable) {
+      watchApi = wikiwatch.startWikiWatchMonitor(ctx, config)
+    }
 
     ctx.command('公告 [源:text]', '查看最新完整公告（渲染为图片发送）')
       .alias('最新公告')
@@ -344,6 +379,46 @@ module.exports = {
         return helpImage(ctx, config, MAIN_HELP)
       })
 
+    ctx.command('BWIKI更新监控 [操作:text]', '查看 BWIKI 页面更新监控状态，或立即检查一次')
+      .usage('BWIKI更新监控           查看监控状态（启用/间隔/推送目标/上次检查）')
+      .usage('BWIKI更新监控 检查      立即执行一次检查')
+      .example('BWIKI更新监控')
+      .example('BWIKI更新监控 检查')
+      .action(async ({ session }, op) => {
+        logCmd(ctx, session, 'BWIKI更新监控', { op })
+        const opTxt = String(op || '').trim().toLowerCase()
+        if (opTxt && opTxt !== '检查' && opTxt !== '测试' && opTxt !== 'check' && opTxt !== 'test') {
+          return '未知操作，可用：BWIKI更新监控（查看状态）、BWIKI更新监控 检查（立即检查一次）'
+        }
+        if (!config.wikiWatchEnable) {
+          return 'BWIKI 更新监控未启用：请在插件配置中开启「wikiWatchEnable」，并在「wikiWatchTargets」中添加推送目标（群/频道或私聊）'
+        }
+        if (opTxt) {
+          const r = await watchApi.check()
+          if (r.error) return '检查失败：' + r.error
+          if (r.first) return '首次检查：已记录当前更新位置（本次不推送），之后的页面更新会自动推送到配置的目标'
+          if (r.pushed) {
+            const msg = Array.isArray(r.message) ? r.message.slice() : [String(r.message || '检查完成')]
+            if (r.sent === false) msg.push('\n（未推送：未配置目标或对应平台机器人不可用，以下仅展示）')
+            return msg
+          }
+          return '检查完成：没有新的页面变更'
+        }
+        const targets = wikiwatch.buildWatchTargets(config)
+        const s = watchApi.state
+        return [
+          'BWIKI 页面更新监控状态：',
+          '  启用：是',
+          '  检查间隔：' + (config.wikiWatchInterval || 10) + ' 分钟',
+          '  推送平台：' + (config.wikiWatchPlatform || '未设置'),
+          '  推送目标：' + (targets.length ? targets.map(t => t.type + ':' + t.id).join('、') : '未设置（仅记录位置，不推送）'),
+          '  已记录最新变更 id：' + (s && s.lastRcid != null ? s.lastRcid : '无'),
+          '  上次检查：' + (s && s.lastCheck ? s.lastCheck : '尚未检查'),
+          (s && s.lastError ? '  上次错误：' + s.lastError : ''),
+          '发送「BWIKI更新监控 检查」可立即执行一次检查',
+        ].filter(Boolean).join('\n')
+      })
+
     ctx.command('胜率 <角色名> [条件:text]', '查询角色胜率并生成图片')
       .usage(HELP)
       .example('胜率 小女孩')

package/package.json

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

package/readme.md

@@ -27,6 +27,7 @@ WIKI页面 <页面名>
 抽卡资源
 抽卡重置 <用户>（需权限 2 级）
 反馈 <内容> [-i 编号]
+BWIKI更新监控 [检查]
 ```
 
 发送 `BWIKI机器人` 可查看当前支持的指令列表图片；发送 `胜率` 等单独指令可查看对应完整帮助。
@@ -304,6 +305,13 @@ WIKI页面 <页面名>
 | `noticePlatform` | 公告推送的平台（如 `qq`），留空禁用公告推送 | `qq` |
 | `noticeTargets` | 公告推送目标列表，以表格形式通过「添加项目」新增（每行一个目标：类型 channel=群/频道 或 private=私聊、目标 id），可添加多个，群/频道与私聊可同时推送 | 空 |
 | `noticeInterval` | 公告检查间隔（分钟） | `10` |
+| `wikiWatchEnable` | 启用 BWIKI 页面更新监听（定期检查页面更新并推送变更内容到目标群聊） | `false` |
+| `wikiWatchPlatform` | BWIKI 更新推送的平台（如 `qq`），留空禁用推送 | `qq` |
+| `wikiWatchTargets` | BWIKI 更新推送目标列表（与 `noticeTargets` 同构：每行一个目标，类型 channel=群/频道 或 private=私聊、目标 id），可添加多个 | 空 |
+| `wikiWatchInterval` | BWIKI 更新检查间隔（分钟） | `10` |
+| `wikiWatchLimit` | 每次拉取的最近变更条数（同时决定每次推送最多列出的页面变更数） | `50` |
+| `wikiWatchMaxChars` | 单页更新内容摘要最大字符数 | `500` |
+| `wikiWatchNamespaces` | 监听的命名空间 id 列表（主命名空间=0；留空仅监听主命名空间） | `[0]` |
 
 数据源两个镜像：`https://website.homeworkkun.top` 与 `https://web.homeworkkun.top`，可直接在配置中切换。
 
@@ -328,6 +336,22 @@ WIKI页面 <页面名>
 
 变更推送优先渲染为图片（仅包含发生变化的部分）：当「致诸位尊敬的访客」等引言段落没有变动时，不再将其渲染进图中，避免每次推送都带上固定引言；若引言本身有变动则会正常展示。图片渲染失败时自动回退为纯文本摘要推送。
 
+## BWIKI 页面更新推送
+
+启用 `wikiWatchEnable` 后，插件会定时（`wikiWatchInterval` 分钟）调用第五人格 BWIKI 的 MediaWiki API（`https://wiki.biligame.com/dwrg/api.php`）：
+
+1. `action=query&list=recentchanges` 获取最近更新的页面（默认只监听主命名空间，可配置 `wikiWatchNamespaces`；**不过滤机器人编辑**）
+2. 对每个新变更调用 `action=compare` 拉取该次编辑的差异（纯文本 unified diff）作为「最后更新内容」；新创建的页面则拉取最新内容前段
+3. 编辑者的 bilibili 数字 uid 通过 bilibili 空间接口解析为真实用户名（如 `2086555` → 摸鱼达人作业君），解析失败时回退显示 uid
+
+汇总后渲染为一张图片（每轮最多 `wikiWatchLimit` 个页面，全部附更新内容），通过 `wikiWatchPlatform` 平台的机器人推送到 `wikiWatchTargets` 列表中的全部目标（每行一个目标，可混用 `channel` 群/频道与 `private` 私聊）。图片内容为：页面标题（新页面标 🆕）、编辑者昵称、时间、编辑摘要、大小变化、更新内容（diff 的 `+` 行绿、`-` 行红）；不包含页面链接。
+
+- 首次启动只记录基线（当前最新变更位置），不推送；之后检测到新变更才推送
+- 已处理的最新变更 id 持久化到数据库（`wiki_data` 表），机器人重启后从上次位置继续，不会重复推送
+- 渲染失败或没有 puppeteer 时自动回退为纯文本推送
+- 任何成员可发送 `BWIKI更新监控` 查看监控状态，发送 `BWIKI更新监控 检查` 立即执行一次检查（返回图片，首次检查只记录基线）
+- 请求带浏览器 User-Agent，遇到 BWIKI 限流（HTTP 567/429/503）自动重试，检查失败只记录日志，不影响下次轮询
+
 ## 图片内容
 
 ### 胜率

package/wikiwatch.js

@@ -0,0 +1,514 @@
+'use strict'
+
+// ===== 第五人格 BWIKI 页面更新监听 =====
+// 定时调用 MediaWiki API（wiki.biligame.com/dwrg/api.php）：
+//   1. list=recentchanges 获取最近更新的页面（默认主命名空间，不过滤机器人编辑）
+//   2. 对每个新变更 action=compare 拉取该次编辑的差异（difftype=unified 纯文本 diff）；
+//      新页面则拉取最新版本内容的前段
+//   3. 编辑者的 bilibili 数字 uid 通过 bilibili 空间接口解析为真实用户名
+// 汇总后渲染为一张图片推送到配置的目标群聊/私聊列表（wikiWatchTargets）。
+// 首次启动只记录基线不推送；已处理的最新 rcid 持久化到数据库（wiki_data 表），
+// 重启后从上次位置继续，不会重复推送。
+
+const { h } = require('koishi')
+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）时的重试间隔
+
+// 读取 recentchanges 记录字段：兼容 formatversion=2（rcid/revid/old_revid…）与
+// formatversion=1（rc_rcid/rc_this_oldid/rc_last_oldid…）两种命名
+function rcField(c, v2, v1) {
+  return c[v2] !== undefined ? c[v2] : c[v1]
+}
+
+function clamp(v, min, max, def) {
+  const n = Number(v)
+  return isNaN(n) ? def : Math.min(max, Math.max(min, n))
+}
+
+// 带 UA / 限流退避的 JSON 请求（与 codex.js 同一策略）
+async function fetchJson(url, timeout) {
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), timeout)
+  const doFetch = () => fetch(url, {
+    signal: ctrl.signal,
+    headers: { 'User-Agent': UA, 'Accept-Language': 'zh-CN,zh;q=0.9' },
+  })
+  try {
+    let res = await doFetch()
+    for (const wait of RETRY_WAIT) {
+      if (res.status !== 567 && res.status !== 429 && res.status !== 503) break
+      await new Promise(r => setTimeout(r, wait))
+      res = await doFetch()
+    }
+    if (!res.ok) throw new Error('HTTP ' + res.status)
+    return await res.json()
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+// 命名空间列表参数：留空默认只监听主命名空间（0）
+function buildNamespaceParam(config) {
+  const list = Array.isArray(config.wikiWatchNamespaces) && config.wikiWatchNamespaces.length
+    ? config.wikiWatchNamespaces.map(Number).filter(n => !isNaN(n))
+    : [0]
+  return encodeURIComponent(list.join('|'))
+}
+
+// 拉取最近变更（返回 recentchanges 记录数组，按时间倒序；不过滤机器人编辑）
+async function fetchRecentChanges(config) {
+  const timeout = Math.max(config.timeout || 15000, 20000)
+  const limit = clamp(config.wikiWatchLimit, 1, 100, 50)
+  const ns = buildNamespaceParam(config)
+  const url = API_BASE + '/api.php?action=query&list=recentchanges&rcnamespace=' + ns +
+    '&rclimit=' + limit +
+    '&rcprop=' + encodeURIComponent('title|ids|timestamp|user|comment|flags|sizes') +
+    '&rctype=' + encodeURIComponent('edit|new') +
+    '&format=json&formatversion=2'
+  const data = await fetchJson(url, timeout)
+  return (data.query && data.query.recentchanges) || []
+}
+
+// 清洗 wikitext：去掉注释/模板/表格/链接语法/HTML 标签，便于阅读
+function stripWikitext(s) {
+  return String(s || '')
+    .replace(/<!--[\s\S]*?-->/g, '')
+    .replace(/\{\{[^{}]*\}\}/g, '')
+    .replace(/\{\{[\s\S]*?\}\}/g, '')
+    .replace(/\[\[(?:[^\]|]*\|)?([^\]]*)\]\]/g, '$1')
+    .replace(/\[(?:https?:)?[^\s\]]+\s+([^\]]*)\]/g, '$1')
+    .replace(/<[^>]+>/g, '')
+    .split('\n')
+    .map(l => l.trim())
+    .filter(l => l && !/^(\{\||\|\}|\|-|\||!)/.test(l))
+    .join('\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim()
+}
+
+// unified diff → 只保留 + / - 变更行（去掉 @@ 上下文头与 ---/+++ 标题行）
+function diffToExcerpt(body) {
+  const lines = String(body || '').split('\n')
+  const out = []
+  for (const line of lines) {
+    if (out.length >= 30) break
+    if (/^(---|\+\+\+)/.test(line)) continue
+    if (/^@@/.test(line)) continue
+    if (/^[+-]/.test(line) && line.length > 1) out.push(line.trimEnd())
+  }
+  return out.join('\n')
+}
+
+// 拉取单个变更的“最后更新内容”：老版本 → 新版本的差异；新页面拉取内容前段
+// 失败返回 null，由调用方降级为仅摘要
+async function fetchDiffDetail(config, change) {
+  const timeout = Math.max(config.timeout || 15000, 20000)
+  const newRev = Number(rcField(change, 'revid', 'rc_this_oldid')) || 0
+  const oldRev = Number(rcField(change, 'old_revid', 'rc_last_oldid')) || 0
+  const isNew = change.type === 'new' || !!change.new || !oldRev
+  if (isNew || !newRev) {
+    if (!newRev) return null
+    const url = API_BASE + '/api.php?action=query&prop=revisions&revids=' + newRev +
+      '&rvprop=content&rvslots=main&format=json&formatversion=2'
+    const data = await fetchJson(url, timeout)
+    const pages = (data.query && data.query.pages) || []
+    const rev = pages.length && pages[0].revisions ? pages[0].revisions[0] : null
+    let content = ''
+    if (rev && rev.slots && rev.slots.main) content = rev.slots.main.content || ''
+    else if (rev && rev.content !== undefined) content = rev.content || ''
+    return { kind: 'new', text: stripWikitext(content) }
+  }
+  const url = API_BASE + '/api.php?action=compare&fromrev=' + oldRev + '&torev=' + newRev +
+    '&prop=diff&difftype=unified&format=json&formatversion=2'
+  const data = await fetchJson(url, timeout)
+  const body = (data.compare && data.compare.body) || ''
+  return { kind: 'diff', text: diffToExcerpt(body) }
+}
+
+function fmtTime(ts) {
+  const d = new Date(ts)
+  if (isNaN(d.getTime())) return String(ts == null ? '' : ts)
+  try {
+    return d.toLocaleString('zh-CN', { hour12: false, timeZone: 'Asia/Shanghai' })
+  } catch (e) {
+    return d.toLocaleString('zh-CN', { hour12: false })
+  }
+}
+
+// ===== bilibili uid → 用户名解析 =====
+// BWIKI 账号绑定 bilibili，MediaWiki 返回的 user 是数字 uid。通过 bilibili 空间接口
+// 解析真实用户名；失败时回退显示 uid。结果在进程内缓存，避免频繁请求。
+const NAME_CACHE = new Map()
+
+async function resolveUserName(logger, uid) {
+  const key = String(uid == null ? '' : uid).trim()
+  if (!/^\d+$/.test(key)) return key || '' // 非数字 uid 原样返回
+  if (NAME_CACHE.has(key)) return NAME_CACHE.get(key)
+  const timeout = 10000
+  let name = null
+  // 依次尝试两个公开接口
+  const apis = [
+    'https://api.bilibili.com/x/space/acc/info?mid=' + key,
+    'https://api.bilibili.com/x/web-interface/card?mid=' + key,
+  ]
+  for (const url of apis) {
+    if (name) break
+    const ctrl = new AbortController()
+    const timer = setTimeout(() => ctrl.abort(), timeout)
+    try {
+      const res = await fetch(url, {
+        signal: ctrl.signal,
+        headers: {
+          'User-Agent': UA,
+          'Accept-Language': 'zh-CN,zh;q=0.9',
+          'Referer': 'https://space.bilibili.com/' + key,
+        },
+      })
+      if (res.ok) {
+        const data = await res.json()
+        if (data && data.code === 0 && data.data && data.data.name) name = String(data.data.name).trim()
+      }
+    } catch (e) { /* 尝试下一个 */ }
+    finally { clearTimeout(timer) }
+  }
+  // 接口失败则解析空间页标题
+  if (!name) {
+    const ctrl = new AbortController()
+    const timer = setTimeout(() => ctrl.abort(), timeout)
+    try {
+      const res = await fetch('https://space.bilibili.com/' + key, {
+        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]) name = String(m[1]).replace(/[_\-]\s*哔哩哔哩.*$/i, '').trim()
+      }
+    } catch (e) { /* 忽略 */ }
+    finally { clearTimeout(timer) }
+  }
+  const result = name || key
+  NAME_CACHE.set(key, result)
+  return result
+}
+
+// ===== 文本渲染为图片 =====
+
+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('<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('（小编辑）')
+    b.push('  ' + meta.join(' · '))
+    if (it.sizeDelta != null) b.push('  大小：' + (it.sizeDelta >= 0 ? '+' : '') + it.sizeDelta + ' 字节')
+    if (it.detail && it.detail.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, '    '))
+    }
+    blocks.push(b.join('\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 : []
+  const targets = []
+  const seen = new Set()
+  for (const t of list) {
+    const id = String(t && t.id ? t.id : '').trim()
+    if (!id) continue
+    const type = t.type === 'private' ? 'private' : 'channel'
+    const key = type + ':' + id
+    if (seen.has(key)) continue
+    seen.add(key)
+    targets.push({ type, id })
+  }
+  return targets
+}
+
+// 推送到全部目标，任一目标成功即视为成功（其余目标失败仅记录日志）。content 为元素数组或字符串。
+async function sendWatchMessage(ctx, config, content, logger) {
+  const targets = buildWatchTargets(config)
+  if (!config.wikiWatchPlatform || !targets.length) return false
+  const bot = ctx.bots && ctx.bots.find(b => b.platform === config.wikiWatchPlatform && b.status === 1)
+  if (!bot) return false
+  let ok = false
+  for (const t of targets) {
+    try {
+      if (t.type === 'private') {
+        await bot.sendPrivateMessage(t.id, content)
+      } else {
+        await bot.sendMessage(t.id, content)
+      }
+      ok = true
+    } catch (e) {
+      logger.warn('BWIKI更新推送失败(' + t.type + ':' + t.id + '): ' + (e && e.message ? e.message : e))
+    }
+  }
+  return ok
+}
+
+// 启动定时监听。返回 { state, check }，供「BWIKI更新监控」指令查看状态/手动检查。
+function startWikiWatchMonitor(ctx, config) {
+  const logger = ctx.logger('dwrgbwiki')
+  const state = {
+    lastRcid: null, // 已处理的最新变更 id（内存 + 数据库持久化）
+    loaded: false,
+    running: false,
+    lastCheck: null, // 上次检查时间
+    lastError: null, // 上次错误信息
+  }
+
+  const loadState = async () => {
+    if (state.loaded) return
+    state.loaded = true
+    if (!ctx.database) return
+    try {
+      const rows = await ctx.database.get('wiki_data', { id: '_watch_state' })
+      if (rows && rows.length && rows[0].data) {
+        const d = JSON.parse(rows[0].data)
+        if (d && typeof d.rcid === 'number') state.lastRcid = d.rcid
+      }
+    } catch (e) { /* 数据库不可用时退化为内存状态 */ }
+  }
+
+  const saveState = async () => {
+    if (!ctx.database) return
+    try {
+      await ctx.database.upsert('wiki_data', [{
+        id: '_watch_state',
+        data: JSON.stringify({ rcid: state.lastRcid, time: new Date().toISOString() }),
+      }])
+    } catch (e) { /* 忽略 */ }
+  }
+
+  // 执行一次检查。返回 { pushed, first, sent, message } 或 { error }
+  const check = async () => {
+    if (state.running) return { error: '正在检查中，请稍后再试' }
+    state.running = true
+    try {
+      await loadState()
+      state.lastCheck = fmtTime(new Date().toISOString())
+      state.lastError = null
+      const changes = await fetchRecentChanges(config)
+      if (!changes.length) return { pushed: 0, first: state.lastRcid == null, message: null }
+
+      const firstRun = state.lastRcid == null
+      const fresh = [] // 相对上次位置新增的变更（倒序）
+      let newest = null
+      for (const c of changes) {
+        const rcid = Number(rcField(c, 'rcid', 'rc_rcid')) || 0
+        if (!rcid) continue
+        if (newest === null || rcid > newest) newest = rcid
+        if (firstRun) break // 首次只记录最新位置，不推送
+        if (rcid <= state.lastRcid) break // 记录按时间倒序，遇到已处理的即停止
+        fresh.push(c)
+      }
+      if (newest !== null && (state.lastRcid === null || newest > state.lastRcid)) {
+        state.lastRcid = newest
+        await saveState()
+      }
+      if (firstRun || !fresh.length) return { pushed: 0, first: firstRun, message: null }
+
+      fresh.reverse() // 转为时间正序（旧 → 新）
+
+      const items = []
+      for (let i = 0; i < fresh.length; i++) {
+        const c = fresh[i]
+        const nl = Number(rcField(c, 'newlen', 'rc_new_len'))
+        const ol = Number(rcField(c, 'oldlen', 'rc_old_len'))
+        const item = {
+          title: c.title || '',
+          user: rcField(c, 'user', 'rc_user') || '',
+          time: rcField(c, 'timestamp', 'rc_timestamp') || '',
+          comment: rcField(c, 'comment', 'rc_comment') || '',
+          minor: !!(rcField(c, 'minor', 'rc_minor')),
+          isNew: c.type === 'new' || !!c.new,
+          sizeDelta: !isNaN(nl) && !isNaN(ol) && nl !== undefined && ol !== undefined ? nl - ol : null,
+        }
+        try {
+          item.detail = await fetchDiffDetail(config, c)
+        } catch (e) {
+          logger.warn('BWIKI更新详情获取失败(' + item.title + '): ' + (e && e.message ? e.message : e))
+        }
+        items.push(item)
+      }
+
+      // 解析编辑者昵称：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)
+      return { error: state.lastError }
+    } finally {
+      state.running = false
+    }
+  }
+
+  // 启动延迟 5 秒（等数据库就绪），之后按 wikiWatchInterval 周期轮询
+  setTimeout(() => { check().catch(() => {}) }, 5000)
+  const interval = Math.max(1, config.wikiWatchInterval || 10) * 60 * 1000
+  const timer = setInterval(() => { check().catch(() => {}) }, interval)
+  ctx.on('dispose', () => clearInterval(timer))
+
+  if (!buildWatchTargets(config).length) {
+    logger.info('BWIKI更新监控已启用，但未配置推送目标（wikiWatchTargets），将仅记录更新位置不推送')
+  }
+
+  return { state, check }
+}
+
+module.exports = {
+  startWikiWatchMonitor,
+  buildWatchTargets,
+  fetchRecentChanges,
+  fetchDiffDetail,
+  buildWatchHtml,
+  buildWatchText,
+  resolveUserName,
+}