koishi-plugin-dwrgbwiki 2.2.2 → 2.3.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()
 
@@ -52,6 +53,10 @@ const MAIN_HELP = [
   '    查询自己的抽卡资源量',
   '  反馈 <内容>',
   '    反馈问题或建议（私聊推送给管理员）',
+  '  公告 [源]',
+  '    查看最新完整公告图片，源可选 正式/共研/全部，例：公告',
+  '  BWIKI更新监控 [检查]',
+  '    查看/触发 BWIKI 页面更新监控，例：BWIKI更新监控 检查',
   '',
   '发送“胜率”“抽卡”等单独指令可查看对应完整帮助',
   '数据均根据第五人格官方小程序数据计算',
@@ -210,6 +215,43 @@ 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),
+    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]),
     进阶设置: Schema.object({
       codexCommands: Schema.array(Schema.object({
         name: Schema.string().required()
@@ -298,6 +340,47 @@ module.exports = {
     if (config.noticeEnable) {
       startNoticeMonitor(ctx, config)
     }
+    let watchApi = null
+    if (config.wikiWatchEnable) {
+      watchApi = wikiwatch.startWikiWatchMonitor(ctx, config)
+    }
+
+    ctx.command('公告 [源:text]', '查看最新完整公告（渲染为图片发送）')
+      .alias('最新公告')
+      .example('公告')
+      .example('公告 共研')
+      .example('公告 全部')
+      .action(async ({ session }, source) => {
+        logCmd(ctx, session, '公告', { source })
+        const q = String(source || '').trim()
+        const wantAll = /^(全部|所有|both|all)$/i.test(q)
+        const wantGongyan = /^(共研|共研服|gongyan)$/i.test(q)
+        // 不指定时默认正式服；共研/全部 可切换
+        const items = wantAll ? NOTICE_URLS : (wantGongyan ? [NOTICE_URLS[1]] : [NOTICE_URLS[0]])
+        const logger = ctx.logger('dwrgbwiki')
+        const parts = []
+        const errors = []
+        for (const item of items) {
+          try {
+            const text = await fetchNotice(item.url, Math.max(config.timeout || 15000, 20000))
+            const parsed = notice.parseNoticeCached(text)
+            const title = parsed.title || '公告'
+            const image = await renderNoticeFull(ctx, config, parsed, item.name, logger)
+            if (image) {
+              parts.push('【' + item.name + ' · ' + title + '】')
+              parts.push(h.image(image, 'image/png'))
+            } else {
+              // 无 puppeteer 时回退完整文本
+              parts.push('【' + item.name + ' · ' + title + '】\n' + noticeToText(parsed))
+            }
+          } catch (e) {
+            errors.push('「' + item.name + '」获取失败：' + (e && e.message ? e.message : e))
+          }
+        }
+        if (!parts.length) return errors.join('\n') || '公告获取失败，请稍后再试'
+        if (errors.length) parts.push('', errors.join('\n'))
+        return parts
+      })
 
     ctx.command('BWIKI机器人', '显示当前支持的指令列表')
       .action(async ({ session }) => {
@@ -305,6 +388,44 @@ 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) {
+            return '检查完成：检测到 ' + r.pushed + ' 个页面变更' + (r.sent === false ? '（但未推送：未配置目标或对应平台机器人不可用）' : '，已推送')
+          }
+          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('胜率 小女孩')
@@ -637,7 +758,7 @@ module.exports = {
             }
             const ok = await feedbackStore.addBlacklist(target.platform, target.userId, reason, session.userId)
             if (!ok) return '该用户已在反馈黑名单中'
-            return '已将 ' + target.platform + '/' + target.userId + ' 加入反馈黑名单' + (reason ? '（原因：' + reason + '）' : '')
+            return '已将 ' + target.platform + '/' + target.userId + ' 加入反馈黑名单' + (reason ? '（原因：' + reason + '）。反馈 解封 [id]可解封' : '')
           }
           if (adminOp === '解封') {
             const id = clean0.replace(/^解封\s*/, '').trim()
@@ -1480,16 +1601,34 @@ function parseNotice(text) {
   return { title, body }
 }
 
+// 获取公告文本：带浏览器 UA 与退避重试，抵御偶发网络抖动 / CDN 限流导致的单次失败
 async function fetchNotice(url, timeout) {
-  const ctrl = new AbortController()
-  const timer = setTimeout(() => ctrl.abort(), timeout)
-  try {
-    const res = await fetch(url, { signal: ctrl.signal })
-    if (!res.ok) throw new Error('HTTP ' + res.status)
-    return await res.text()
-  } finally {
-    clearTimeout(timer)
+  const headers = {
+    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36',
+    'Accept': 'text/plain,text/*;q=0.9,*/*;q=0.8',
   }
+  const MAX_ATTEMPTS = 3
+  const DELAYS = [1000, 3000] // 重试间隔：1s、3s（远小于公告检查间隔，不影响整体节奏）
+  let lastErr = null
+  for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+    const ctrl = new AbortController()
+    const timer = setTimeout(() => ctrl.abort(), timeout)
+    try {
+      const res = await fetch(url, { signal: ctrl.signal, headers, redirect: 'follow' })
+      if (!res.ok) throw new Error('HTTP ' + res.status)
+      return await res.text()
+    } catch (e) {
+      lastErr = e
+      if (attempt < MAX_ATTEMPTS) await new Promise(r => setTimeout(r, DELAYS[attempt - 1]))
+    } finally {
+      clearTimeout(timer)
+    }
+  }
+  // 解出最里层原因（Node undici 的 fetch 失败原因在 e.cause，如 ECONNRESET / ETIMEDOUT / TLS 握手失败等）
+  let cause = lastErr && lastErr.cause
+  while (cause && cause.cause) cause = cause.cause
+  const detail = cause ? String(cause.message || cause) : (lastErr && lastErr.message) || String(lastErr)
+  throw new Error('fetch failed after ' + MAX_ATTEMPTS + ' attempts: ' + detail)
 }
 
 // 汇总公告推送目标列表（noticeTargets：多目标，群/频道与私聊可混用）
@@ -1546,43 +1685,97 @@ async function sendNoticeImage(ctx, config, parsed, header, logger, sourceName,
   }
 }
 
+// 将解析后的公告渲染为完整图片（changed 传 null 即完整渲染，供「公告」指令使用）
+// 渲染失败或没有 puppeteer 时返回 null，由调用方回退文本
+async function renderNoticeFull(ctx, config, parsed, sourceName, logger) {
+  if (!ctx.puppeteer) return null
+  try {
+    const width = config.width || 1300
+    const html = notice.buildNoticeHtml(parsed, { ...config, width, sourceName }, null)
+    return await capture(ctx, html, { ...config, width })
+  } catch (e) {
+    logger.warn('公告图片渲染失败: ' + (e && e.message ? e.message : e))
+    return null
+  }
+}
+
+// 公告结构化对象 → 完整纯文本（无 puppeteer 时的回退，去色码并限制长度防刷屏）
+function noticeToText(parsed) {
+  const clean = s => String(s == null ? '' : s)
+    .replace(/#c[0-9a-fA-F]{6}/g, '')
+    .replace(/#n|#r/g, ' ')
+    .replace(/\s+/g, ' ').trim()
+  const lines = []
+  if (parsed.title) lines.push('『' + clean(parsed.title) + '』')
+  if (parsed.intro) lines.push('', clean(parsed.intro))
+  parsed.sections.forEach((sec, i) => {
+    lines.push('', '【' + (i + 1) + '. ' + clean(sec.title) + '】')
+    sec.items.forEach(it => {
+      if (it.type === 'sub') lines.push('▪ ' + clean(it.text))
+      else if (it.type === 'h3') lines.push('▪ ' + clean(it.text))
+      else if (it.type === 'table') {
+        if (it.title) lines.push('▪ ' + clean(it.title))
+        if (it.headers && it.headers.length) lines.push('  ' + it.headers.join(' | '))
+        it.rows.forEach(r => lines.push('  ' + r.join(' | ')))
+      } else {
+        lines.push('▪ ' + clean(it.text))
+      }
+    })
+  })
+  if (parsed.endTitle) lines.push('', '『' + clean(parsed.endTitle) + '』')
+  if (parsed.endBody) lines.push(clean(parsed.endBody))
+  let text = lines.filter(l => l !== '').join('\n')
+  if (text.length > 3000) text = text.slice(0, 3000) + '\n…（内容过长已截断）'
+  return text
+}
+
+// 检查单个公告源（自动轮询共用）：更新哈希/解析缓存，有变动则推送
+// 返回 { ok, changed, first, title, error, name, key }
+async function checkNoticeItem(ctx, config, item, state, logger) {
+  const timeout = Math.max(config.timeout || 15000, 20000)
+  try {
+    const text = await fetchNotice(item.url, timeout)
+    const hash = require('crypto').createHash('sha256').update(text).digest('hex')
+    const prev = state.lastHash[item.key]
+    state.lastHash[item.key] = hash
+    const parsed = notice.parseNoticeCached(text)
+    const prevParsed = state.lastParsed[item.key] || null
+    state.lastParsed[item.key] = parsed
+    const { title, body } = parseNotice(text)
+    // 首次运行只记录，不推送；之后变动才推送
+    if (prev !== undefined && prev !== hash) {
+      const header = '【' + item.name + '公告更新】' + (title ? '「' + title + '」' : '')
+      // 优先渲染为图片推送（仅变化部分），失败时回退纯文本摘要
+      const changed = prevParsed ? notice.diffNotice(prevParsed, parsed) : null
+      const sent = await sendNoticeImage(ctx, config, parsed, header, logger, item.name, changed && changed.hasChange ? changed : null)
+      if (!sent) {
+        const content = [header, '', body].join('\n')
+        await sendNoticeMessage(ctx, config, content, logger)
+      }
+      return { ok: true, changed: true, title, name: item.name, key: item.key }
+    }
+    return { ok: true, changed: false, first: prev === undefined, title, name: item.name, key: item.key }
+  } catch (e) {
+    logger.warn('公告检查失败(' + item.key + '): ' + (e && e.message ? e.message : e) + ' | ' + item.url)
+    return { ok: false, error: (e && e.message ? e.message : e), name: item.name, key: item.key }
+  }
+}
+
 function startNoticeMonitor(ctx, config) {
   const logger = ctx.logger('dwrgbwiki')
-  const timeout = Math.max(config.timeout || 15000, 20000)
   // 上次内容哈希：key -> hash；上次解析结果：key -> parsed（用于增量 diff）
-  let lastHash = {}
-  let lastParsed = {}
+  const state = { lastHash: {}, lastParsed: {} }
   let running = false
 
   const check = async () => {
-    if (running) return
+    if (running) return []
     running = true
     try {
+      const results = []
       for (const item of NOTICE_URLS) {
-        try {
-          const text = await fetchNotice(item.url, timeout)
-          const hash = require('crypto').createHash('sha256').update(text).digest('hex')
-          const prev = lastHash[item.key]
-          lastHash[item.key] = hash
-          const parsed = notice.parseNoticeCached(text)
-          const prevParsed = lastParsed[item.key] || null
-          lastParsed[item.key] = parsed
-          // 首次运行只记录，不推送；之后变动才推送
-          if (prev !== undefined && prev !== hash) {
-            const { title, body } = parseNotice(text)
-            const header = '【' + item.name + '公告更新】' + (title ? '「' + title + '」' : '')
-            // 优先渲染为图片推送（仅变化部分），失败时回退纯文本摘要
-            const changed = prevParsed ? notice.diffNotice(prevParsed, parsed) : null
-            const sent = await sendNoticeImage(ctx, config, parsed, header, logger, item.name, changed && changed.hasChange ? changed : null)
-            if (!sent) {
-              const content = [header, '', body].join('\n')
-              await sendNoticeMessage(ctx, config, content, logger)
-            }
-          }
-        } catch (e) {
-          logger.warn('公告检查失败(' + item.key + '): ' + (e && e.message ? e.message : e))
-        }
+        results.push(await checkNoticeItem(ctx, config, item, state, logger))
       }
+      return results
     } finally {
       running = false
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-dwrgbwiki",
-  "version": "2.2.2",
-  "description": "第五人格BWIKI编辑组开发，所有代码由DeepSeek V4 Flash 0731编写。支持胜率/地图/模仿者/勋章/基础数据查询、图鉴查询、wiki页面截图、藏头诗、抽卡模拟、加页手记探索、赛事数据（选手/对决）、公告变动推送、反馈系统等功能。",
+  "version": "2.3.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,16 @@ 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` |
+| `wikiWatchDetailLimit` | 每次推送中获取详细更新内容（diff/新页面内容）的最大页面数，其余只推送标题与编辑摘要 | `5` |
+| `wikiWatchMaxItems` | 每次推送最多列出的页面变更数（超出部分仅提示数量） | `15` |
+| `wikiWatchMaxChars` | 单页更新内容摘要最大字符数 | `500` |
+| `wikiWatchSkipBots` | 过滤机器人编辑（`rcshow=!bot`） | `true` |
+| `wikiWatchNamespaces` | 监听的命名空间 id 列表（主命名空间=0；留空仅监听主命名空间） | `[0]` |
 
 数据源两个镜像：`https://website.homeworkkun.top` 与 `https://web.homeworkkun.top`，可直接在配置中切换。
 
@@ -322,8 +333,27 @@ WIKI页面 <页面名>
 
 每次内容变动（以内容哈希判断）时，通过 `noticePlatform` 平台的机器人推送到 `noticeTargets` 列表中的全部目标（每条目标可单独指定 `channel` 群/频道或 `private` 私聊，可同时推送）。推送内容为「公告标题」+ 正文摘要（去除 HTML 标签与颜色代码，截断 500 字）。首次启动只记录基线，不推送。
 
+检查请求带浏览器 User-Agent，并在网络抖动时自动重试 3 次（间隔 1s、3s），连续失败才会记录「公告检查失败」日志（日志会附上公告地址与真实原因）。
+
+任何成员可发送 `公告`（或 `最新公告`）查看最新完整公告：默认渲染并发送正式服完整公告图片，可加参数切换来源——`公告 共研`（共研服）、`公告 全部`（两个都发）；无 puppeteer 环境时自动回退为完整文本。
+
 变更推送优先渲染为图片（仅包含发生变化的部分）：当「致诸位尊敬的访客」等引言段落没有变动时，不再将其渲染进图中，避免每次推送都带上固定引言；若引言本身有变动则会正常展示。图片渲染失败时自动回退为纯文本摘要推送。
 
+## BWIKI 页面更新推送
+
+启用 `wikiWatchEnable` 后，插件会定时（`wikiWatchInterval` 分钟）调用第五人格 BWIKI 的 MediaWiki API（`https://wiki.biligame.com/dwrg/api.php`）：
+
+1. `action=query&list=recentchanges` 获取最近更新的页面（默认只监听主命名空间，可配置 `wikiWatchNamespaces`；`wikiWatchSkipBots` 可过滤机器人编辑）
+2. 对每个新变更调用 `action=compare` 拉取该次编辑的差异（纯文本 unified diff）作为「最后更新内容」；新创建的页面则拉取最新内容前段
+
+汇总为一条文字消息，通过 `wikiWatchPlatform` 平台的机器人推送到 `wikiWatchTargets` 列表中的全部目标（每行一个目标，可混用 `channel` 群/频道与 `private` 私聊），格式为：页面标题（新页面标 🆕）、编辑者、时间、编辑摘要、大小变化、更新内容摘要（`wikiWatchMaxChars` 截断）、页面链接。
+
+- 首次启动只记录基线（当前最新变更位置），不推送；之后检测到新变更才推送
+- 已处理的最新变更 id 持久化到数据库（`wiki_data` 表），机器人重启后从上次位置继续，不会重复推送
+- 每次推送最多列出 `wikiWatchMaxItems` 个变更，其中最新的 `wikiWatchDetailLimit` 个会附详细更新内容，其余仅标题与摘要
+- 任何成员可发送 `BWIKI更新监控` 查看监控状态，发送 `BWIKI更新监控 检查` 立即执行一次检查（首次检查只记录基线）
+- 请求带浏览器 User-Agent，遇到 BWIKI 限流（HTTP 567/429/503）自动重试，检查失败只记录日志，不影响下次轮询
+
 ## 图片内容
 
 ### 胜率

package/wikiwatch.js

@@ -0,0 +1,337 @@
+'use strict'
+
+// ===== 第五人格 BWIKI 页面更新监听 =====
+// 定时调用 MediaWiki API（wiki.biligame.com/dwrg/api.php）：
+//   1. list=recentchanges 获取最近更新的页面（默认主命名空间，可过滤机器人编辑）
+//   2. 对每个新变更 action=compare 拉取该次编辑的差异（difftype=unified 纯文本 diff）；
+//      新页面则拉取最新版本内容的前段
+// 汇总成文字消息，通过配置的机器人平台（wikiWatchPlatform）推送到目标群聊/私聊列表
+// （wikiWatchTargets，与公告推送同构，每行一个目标：类型 + id）。
+// 首次启动只记录基线不推送；已处理的最新 rcid 持久化到数据库（wiki_data 表），
+// 重启后从上次位置继续，不会重复推送。
+
+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') +
+    (config.wikiWatchSkipBots === false ? '' : '&rcshow=!bot') +
+    '&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 })
+  }
+}
+
+function indentText(text, prefix) {
+  return String(text).split('\n').map(l => prefix + l).join('\n')
+}
+
+// 汇总推送消息（单页内容摘要按 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)
+    const meta = []
+    if (it.user) meta.push(it.user)
+    meta.push(fmtTime(it.time))
+    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 + ' 字节')
+    }
+    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, '    '))
+    }
+    lines.push('  🔗 https://wiki.biligame.com/dwrg/' + encodeURIComponent(it.title))
+  }
+  let msg = lines.join('\n')
+  const MAX_TOTAL = 4000
+  if (msg.length > MAX_TOTAL) msg = msg.slice(0, MAX_TOTAL) + '\n…（内容过长已截断）'
+  return msg
+}
+
+// 汇总推送目标列表（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
+}
+
+// 推送到全部目标，任一目标成功即视为成功（其余目标失败仅记录日志）
+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 } 或 { 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 }
+
+      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 }
+
+      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]
+        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,
+        }
+        // 只对最新的 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))
+          }
+        }
+        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 }
+    } 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,
+  buildWatchMessage,
+}