koishi-plugin-dwrgbwiki 2.1.3 → 2.2.1

package/index.js

@@ -117,36 +117,20 @@ module.exports = {
     width: Schema.number().min(400).max(4000)
       .description('图片宽度（px），其他指令未单独设置时使用该值')
       .default(1300),
-    winrateWidth: Schema.number().min(0).max(4000)
-      .description('胜率指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    mapWidth: Schema.number().min(0).max(4000)
-      .description('地图指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    mimicWidth: Schema.number().min(0).max(4000)
-      .description('模仿者指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    matchWidth: Schema.number().min(0).max(4000)
-      .description('赛事指令图片宽度（px），0=使用默认宽度')
-      .default(0),
+    commandWidths: Schema.array(Schema.object({
+      command: Schema.union(['胜率', '地图', '模仿者', '赛事', '勋章', '基础数据', '抽卡', '图鉴', 'WIKI'])
+        .required()
+        .description('指令名称'),
+      width: Schema.number().min(0).max(4000)
+        .description('该指令图片宽度（px），0=使用默认宽度')
+        .default(0),
+    }))
+      .role('table')
+      .description('各指令图片宽度设置（px），以表格形式通过「添加项目」新增；0=使用默认宽度')
+      .default([]),
     matchMerge: Schema.union(['team', 'player', 'all', 'none'])
       .description('赛事指令默认合并模式：team=合并队伍前身，player=合并选手多个id，all=两者都合并，none=完全不合并')
       .default('team'),
-    badgeWidth: Schema.number().min(0).max(4000)
-      .description('勋章指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    basicWidth: Schema.number().min(0).max(4000)
-      .description('基础数据指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    gachaWidth: Schema.number().min(0).max(4000)
-      .description('抽卡指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    codexWidth: Schema.number().min(0).max(4000)
-      .description('图鉴指令图片宽度（px），0=使用默认宽度')
-      .default(0),
-    wikiWidth: Schema.number().min(400).max(4000)
-      .description('WIKI页面指令截图宽度（px）')
-      .default(1300),
     wikiMaxHeight: Schema.number().min(200).max(12000)
       .description('WIKI页面指令截图最大高度（px）')
       .default(5000),
@@ -204,18 +188,25 @@ module.exports = {
     feedbackChannelId: Schema.string()
       .description('接收反馈的群/频道 id（推送反馈到该群，QQ 平台推荐使用群推送以避免私聊限制），优先于私聊推送')
       .default(''),
+    feedbackAdminIds: Schema.array(Schema.string())
+      .description('反馈管理账号 id 列表（可回复反馈 / 拉黑 / 解封 / 查看黑名单）。koishi 默认新用户权限只有 1 级，不满足回复所需的 2 级，请在这里填入你自己的用户 id（如 QQ 号）；留空则仅允许 koishi 权限 ≥2 的账号')
+      .default([]),
     noticeEnable: Schema.boolean()
       .description('启用网易公告变动监听（正式服+共研服）')
       .default(false),
     noticePlatform: Schema.string()
       .description('公告推送的平台（如 qq），留空禁用公告推送')
       .default('qq'),
-    noticeChannelType: Schema.union(['channel', 'private'])
-      .description('公告推送目标类型：channel=群/频道，private=私聊')
-      .default('channel'),
-    noticeChannelId: Schema.string()
-      .description('公告推送目标：群/频道 id（channel 类型）或用户 id（private 类型）')
-      .default(''),
+    noticeTargets: 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('公告推送目标列表，以表格形式通过「添加项目」新增推送目标（每行一个目标），可添加多个，群/频道与私聊可同时推送')
+      .default([]),
     noticeInterval: Schema.number().min(1).max(1440)
       .description('公告检查间隔（分钟）')
       .default(10),
@@ -233,10 +224,10 @@ module.exports = {
           key: Schema.string().required()
             .description('模板参数名'),
           label: Schema.string()
-            .description('显示名，留空用参数名')
-            .default(''),
+            .description('显示名，留空则显示参数名'),
         }))
-          .description('要解析展示的参数，可增减')
+          .role('table')
+          .description('要解析展示的参数，以表格形式通过「添加项目」新增（每行一个参数）；新增时默认只填 key，label 可留空或按需填写')
           .default([]),
         image: Schema.string()
           .description('配图文件名模板（用 {{参数名}} 占位，如 {{角色}}{{品质}}品质时装_{{名称}}.png），留空不显示图片')
@@ -253,17 +244,17 @@ module.exports = {
             templates: ['单时装', '商城信息'],
             image: '{{角色}}{{品质}}品质时装_{{名称}}.png',
             fields: [
-              { key: '名称', label: '名称' },
-              { key: '角色', label: '角色' },
-              { key: '品质', label: '品质' },
-              { key: '获取方式', label: '获取方式' },
-              { key: '价格', label: '价格' },
-              { key: '上架时间', label: '上架时间' },
-              { key: '下架时间', label: '下架时间' },
-              { key: '具体描述', label: '具体描述' },
-              { key: '备注', label: '备注' },
-              { key: '限时限定', label: '限时限定' },
-              { key: '英文名称', label: '英文名称' },
+              { key: '名称' },
+              { key: '角色' },
+              { key: '品质' },
+              { key: '获取方式' },
+              { key: '价格' },
+              { key: '上架时间' },
+              { key: '下架时间' },
+              { key: '具体描述' },
+              { key: '备注' },
+              { key: '限时限定' },
+              { key: '英文名称' },
             ],
           },
         ]),
@@ -588,20 +579,71 @@ module.exports = {
       .example('反馈 抽卡图片显示异常')
       .example('反馈 问题已处理 -i 12')
       .check(async ({ session }) => {
-        // 含 -i 的回复操作需权限 2 级（管理员）
+        // 含 -i 的回复操作以及 拉黑/解封/黑名单 管理操作需管理员权限
+        // （feedbackAdminIds 中配置的用户 id，或 koishi 权限 ≥2；koishi 新用户默认权限只有 1）
         const body = session.content ? String(session.content).replace(/^反馈\s*/, '') : ''
-        if (/\s+-i\s+\d+\s*$/.test(body.trim()) || /^-i\s+\d+/.test(body.trim())) {
+        const clean = body.trim()
+        const isAdminOp = /^(拉黑|解封|黑名单)\b/.test(clean) || /\s+-i\s+\d+\s*$/.test(clean) || /^-i\s+\d+/.test(clean)
+        if (isAdminOp) {
           const user = await session.observeUser(['authority']).catch(() => null)
-          if (!user || (user.authority || 0) < 2) return '权限不足：回复反馈需要权限 2 级（管理员）'
+          const adminIds = Array.isArray(config.feedbackAdminIds) ? config.feedbackAdminIds : []
+          const isAdmin = (user && (user.authority || 0) >= 2) || adminIds.includes(String(session.userId))
+          if (!isAdmin) return '权限不足：回复反馈/拉黑/解封/黑名单需要管理员权限。请在插件配置「feedbackAdminIds」中添加你的用户 id，或设置 koishi 用户权限 ≥2'
         }
       })
       .action(async ({ session, options }, content) => {
         const raw0 = session.content ? String(session.content).trim() : ''
-        const isReply = /\s+-i\s+\d+\s*$/.test(raw0.replace(/^反馈\s*/, '').trim()) || /^-i\s+\d+/.test(raw0.replace(/^反馈\s*/, '').trim())
-        logCmd(ctx, session, '反馈' + (isReply ? '(回复)' : ''), { content })
+        const clean0 = raw0.replace(/^反馈\s*/, '').trim()
+        const isReply = /\s+-i\s+\d+\s*$/.test(clean0) || /^-i\s+\d+/.test(clean0)
+        const adminOp = (clean0.match(/^(拉黑|解封|黑名单)\b/) || [])[1] || ''
+        logCmd(ctx, session, '反馈' + (adminOp ? '(' + adminOp + ')' : (isReply ? '(回复)' : '')), { content })
         // 从原始消息提取完整反馈文字（保留空格；text 类型会去掉空格）
         const raw = session.content ? String(session.content).trim() : ''
         const body = raw.replace(/^反馈\s*/, '').trim()
+        // 黑名单管理（权限已在 check 校验）：反馈 拉黑 <id> [原因] / 反馈 拉黑 -i <编号> [原因] / 反馈 解封 <id> / 反馈 黑名单
+        if (adminOp) {
+          if (adminOp === '黑名单') {
+            const list = await feedbackStore.listBlacklist()
+            if (!list.length) return '反馈黑名单为空'
+            const lines = list.map(e => '· ' + e.platform + ' / ' + e.userId + (e.reason ? '（' + e.reason + '）' : '') + ' — ' + e.time + (e.operator ? '（操作者 ' + e.operator + '）' : ''))
+            return '反馈黑名单（' + list.length + ' 人）：\n' + lines.join('\n')
+          }
+          if (adminOp === '拉黑') {
+            const rest = clean0.replace(/^拉黑\b/, '').trim()
+            if (!rest) return '请指定要拉黑的用户，格式：反馈 拉黑 <用户id> [原因]，或 反馈 拉黑 -i <反馈编号> [原因]'
+            let target = null
+            let reason = ''
+            const viaFeedback = rest.match(/^-i\s+(\d+)(?:[\s　]*(.*))?$/)
+            if (viaFeedback) {
+              const record = await feedbackStore.get(viaFeedback[1])
+              if (!record) return '未找到编号 ' + viaFeedback[1] + ' 的反馈'
+              target = { platform: record.platform, userId: record.userId }
+              reason = (viaFeedback[2] || '').trim()
+            } else {
+              const direct = rest.match(/^(\S+)(?:[\s　]*(.*))?$/)
+              if (!direct) return '无法识别的拉黑目标'
+              target = { platform: session.platform, userId: direct[1] }
+              reason = (direct[2] || '').trim()
+            }
+            // 防止误拉管理员：检查被拉黑目标的 koishi 权限与反馈管理员配置
+            const adminIds = Array.isArray(config.feedbackAdminIds) ? config.feedbackAdminIds : []
+            if (adminIds.includes(String(target.userId))) return '不能拉黑反馈管理员账号'
+            if (ctx.database) {
+              const targetUser = await ctx.database.getUser(target.platform, target.userId, ['authority']).catch(() => null)
+              if (targetUser && (targetUser.authority || 0) >= 2) return '不能拉黑管理员账号'
+            }
+            const ok = await feedbackStore.addBlacklist(target.platform, target.userId, reason, session.userId)
+            if (!ok) return '该用户已在反馈黑名单中'
+            return '已将 ' + target.platform + '/' + target.userId + ' 加入反馈黑名单' + (reason ? '（原因：' + reason + '）' : '')
+          }
+          if (adminOp === '解封') {
+            const id = clean0.replace(/^解封\b/, '').trim()
+            if (!id) return '请指定要解封的用户 id，格式：反馈 解封 <用户id>'
+            const ok = await feedbackStore.removeBlacklist(session.platform, id)
+            if (!ok) return '该用户不在反馈黑名单中'
+            return '已解除 ' + session.platform + '/' + id + ' 的反馈拉黑'
+          }
+        }
         // 解析回复编号：反馈 <回复内容> -i <编号>
         const optMatch = body.match(/\s+-i\s+(\d+)\s*$/)
         const replyId = optMatch ? optMatch[1] : (options && options.i ? String(options.i).trim() : '')
@@ -624,7 +666,7 @@ module.exports = {
               await feedbackStore.markReplied(replyId)
               return '已回复编号 ' + replyId + '（已发到原反馈群）'
             } catch (e) {
-              ctx.logger('dwrgbwiki').warn('回复反馈到原群失败，尝试私聊: ' + (e && e.message ? e.message : e) + ' | channelId=' + record.channelId + ' guildId=' + record.guildId + ' | stack: ' + (e && e.stack ? String(e.stack).slice(0, 200) : ''))
+              ctx.logger('dwrgbwiki').warn('回复反馈到原群失败，尝试私聊: ' + errDetail(e) + ' | channelId=' + record.channelId + ' guildId=' + record.guildId)
             }
           }
           try {
@@ -639,18 +681,24 @@ module.exports = {
                 await feedbackStore.markReplied(replyId)
                 return '已回复编号 ' + replyId + '（私聊失败，已转发到反馈群）'
               } catch (e2) {
-                ctx.logger('dwrgbwiki').warn('回复反馈失败: ' + (e2 && e2.message ? e2.message : e2))
-                return '回复失败：' + (e2 && e2.message ? e2.message : e2)
+                ctx.logger('dwrgbwiki').warn('回复反馈兜底转发失败: ' + errDetail(e2))
+                return '回复失败：' + errDetail(e2)
               }
             }
-            ctx.logger('dwrgbwiki').warn('回复反馈失败: ' + (e && e.message ? e.message : e) + ' | stack: ' + (e && e.stack ? String(e.stack).slice(0, 300) : '') + ' | target: ' + record.platform + '/' + record.userId + ' | bot: ' + (bot.platform || '?') + ':' + (bot.selfId || bot.sid) + ' status=' + bot.status)
-            return '回复失败：' + (e && e.message ? e.message : e)
+            ctx.logger('dwrgbwiki').warn('回复反馈失败: ' + errDetail(e) + ' | target: ' + record.platform + '/' + record.userId + ' | bot: ' + (bot.platform || '?') + ':' + (bot.selfId || bot.sid) + ' status=' + bot.status)
+            return '回复失败：' + errDetail(e)
           }
         }
         // 提交反馈模式
         let text = body
         if (!text && content) text = String(content).trim()
         if (!text) return '请发送要反馈的内容，格式：反馈 <内容>'
+        // 黑名单拦截：被拉黑用户提交时直接告知并拒绝（不记录、不推送）
+        const banned = await feedbackStore.isBlacklisted(session.platform, session.userId)
+        if (banned) {
+          ctx.logger('dwrgbwiki').warn('反馈拦截: 黑名单用户 ' + session.platform + '/' + session.userId + ' 尝试提交反馈: ' + String(text).slice(0, 200))
+          return '你已被加入反馈黑名单，无法使用反馈功能' + (banned.reason ? '（原因：' + banned.reason + '）' : '')
+        }
         const time = new Date().toLocaleString('zh-CN', { hour12: false })
         const senderName = session.username || session.user?.name || session.userId || '未知用户'
         const record = await feedbackStore.create({
@@ -677,15 +725,15 @@ module.exports = {
               } else {
                 await bot.sendPrivateMessage(config.feedbackUserId, feedbackMsg)
               }
-              return '已收到反馈（编号 #' + record.id + '）。本机器人由玩家制作，并非网易第五人格官方机器人，请勿反馈第五人格相关问题。'
+              return '已收到反馈（编号 #' + record.id + '）。如需收到回复，请联系群主打开机器人主动在群聊发言功能。本机器人由玩家制作，并非网易第五人格官方机器人，请勿反馈第五人格相关问题。'
             } catch (e) {
-              ctx.logger('dwrgbwiki').warn('反馈推送失败: ' + (e && e.message ? e.message : e) + ' | stack: ' + (e && e.stack ? String(e.stack).slice(0, 300) : '') + ' | target: ' + config.feedbackPlatform + '/' + (config.feedbackChannelId || config.feedbackUserId) + ' | bot: ' + (bot.platform || '?') + ':' + (bot.selfId || bot.sid) + ' status=' + bot.status)
+              ctx.logger('dwrgbwiki').warn('反馈推送失败: ' + errDetail(e) + ' | target: ' + config.feedbackPlatform + '/' + (config.feedbackChannelId || config.feedbackUserId) + ' | bot: ' + (bot.platform || '?') + ':' + (bot.selfId || bot.sid) + ' status=' + bot.status)
               return '已收到反馈（编号 #' + record.id + '，但推送给管理员失败，请稍后重试）'
             }
           }
           return '已收到反馈（编号 #' + record.id + '，但未找到可用的推送机器人，请稍后重试）'
         }
-        return '已收到反馈（编号 #' + record.id + '）。本机器人由玩家制作，并非网易第五人格官方机器人，请勿反馈第五人格相关问题。'
+        return '已收到反馈（编号 #' + record.id + '）。如需收到回复，请联系群主打开机器人主动在群聊发言功能。本机器人由玩家制作，并非网易第五人格官方机器人，请勿反馈第五人格相关问题。'
       })
   },
 }
@@ -704,7 +752,48 @@ function logCmd(ctx, session, name, args, extra) {
   } catch (e) { /* 日志失败不影响主流程 */ }
 }
 
+// 提取错误详情（解包 AggregateError 与 HTTP 响应体，便于定位 QQ 等平台 API 报错）
+function errDetail(e) {
+  try {
+    if (!e) return 'unknown'
+    const parts = []
+    const msg = e.message ? String(e.message) : ''
+    if (msg) parts.push(msg)
+    if (e.errors && e.errors.length) {
+      parts.push('inner[' + e.errors.length + ']: ' + e.errors.map(er => {
+        let s = (er && er.message) ? String(er.message) : String(er)
+        const body = er && er.response && er.response.data ? JSON.stringify(er.response.data) : ''
+        if (body) s += ' [' + body.slice(0, 400) + ']'
+        return s
+      }).join(' || '))
+    }
+    const resp = e.response && e.response.data ? JSON.stringify(e.response.data).slice(0, 400) : ''
+    if (resp) parts.push('resp: ' + resp)
+    return parts.join(' | ') || 'Error'
+  } catch (_) {
+    return 'Error'
+  }
+}
+
+// 指令宽度表：旧配置键 -> 表格中的指令名（commandWidths）
+const WIDTH_COMMANDS = {
+  winrateWidth: '胜率',
+  mapWidth: '地图',
+  mimicWidth: '模仿者',
+  matchWidth: '赛事',
+  badgeWidth: '勋章',
+  basicWidth: '基础数据',
+  gachaWidth: '抽卡',
+  codexWidth: '图鉴',
+  wikiWidth: 'WIKI',
+}
+
+// 读取指令图片宽度：优先 commandWidths 表格，其次回退旧版独立配置键，最后使用默认宽度
 function cmdWidth(config, key) {
+  const command = WIDTH_COMMANDS[key]
+  const list = Array.isArray(config.commandWidths) ? config.commandWidths : []
+  const row = command && list.find(t => t && t.command === command)
+  if (row && row.width > 0) return row.width
   const v = config[key]
   return (v && v > 0) ? v : (config.width || 1300)
 }
@@ -881,6 +970,7 @@ async function codexImage(ctx, config, rest) {
     ctx.logger('dwrgbwiki').warn(e)
     const msg = e && e.message ? e.message : String(e)
     if (String(msg).includes('页面不存在')) {
+      await new Promise(r => setTimeout(r, 2000))
       try {
         const results = await codex.searchPages(q, config)
         if (results.length) {
@@ -974,7 +1064,7 @@ async function wikiPageImage(ctx, config, wikiStore, userId, name) {
     } catch (e) {
       ctx.logger('dwrgbwiki').warn('WIKI页面解析标题失败，按原样截图: ' + (e && e.message ? e.message : e))
     }
-    const width = config.wikiWidth || 1300
+    const width = cmdWidth(config, 'wikiWidth')
     const maxHeight = config.wikiMaxHeight || 5000
     const image = await wiki.screenshot(ctx, target, {
       width,
@@ -1235,6 +1325,8 @@ class FeedbackStore {
     this.ctx = ctx || null
     this.cache = new Map() // id -> 反馈记录
     this.next = null
+    this.blacklist = [] // 黑名单：[{ platform, userId, reason, time, operator }]
+    this.blacklistLoaded = false
   }
 
   async loadNext() {
@@ -1257,6 +1349,69 @@ class FeedbackStore {
     } catch (e) { /* 忽略 */ }
   }
 
+  // ===== 黑名单（持久化在 feedback_data 表的 _blacklist 记录中） =====
+
+  async loadBlacklist() {
+    if (this.blacklistLoaded) return
+    this.blacklist = []
+    this.blacklistLoaded = true
+    if (this.ctx && this.ctx.database) {
+      try {
+        const rows = await this.ctx.database.get('feedback_data', { id: '_blacklist' })
+        if (rows && rows.length && rows[0].data) {
+          const parsed = JSON.parse(rows[0].data)
+          if (Array.isArray(parsed.entries)) this.blacklist = parsed.entries
+        }
+      } catch (e) { /* 忽略 */ }
+    }
+  }
+
+  async saveBlacklist() {
+    if (!this.ctx || !this.ctx.database) return
+    try {
+      await this.ctx.database.upsert('feedback_data', [{ id: '_blacklist', data: JSON.stringify({ entries: this.blacklist }) }])
+    } catch (e) { /* 忽略 */ }
+  }
+
+  // 返回命中项（含 reason），未命中返回 null
+  async isBlacklisted(platform, userId) {
+    await this.loadBlacklist()
+    const id = String(userId == null ? '' : userId)
+    if (!id) return null
+    return this.blacklist.find(e => e.platform === platform && String(e.userId) === id) || null
+  }
+
+  async addBlacklist(platform, userId, reason, operator) {
+    await this.loadBlacklist()
+    const id = String(userId == null ? '' : userId)
+    if (!id) return false
+    if (this.blacklist.some(e => e.platform === platform && String(e.userId) === id)) return false
+    this.blacklist.push({
+      platform,
+      userId: id,
+      reason: reason || '',
+      time: new Date().toLocaleString('zh-CN', { hour12: false }),
+      operator: operator || '',
+    })
+    await this.saveBlacklist()
+    return true
+  }
+
+  async removeBlacklist(platform, userId) {
+    await this.loadBlacklist()
+    const id = String(userId == null ? '' : userId)
+    const before = this.blacklist.length
+    this.blacklist = this.blacklist.filter(e => !(e.platform === platform && String(e.userId) === id))
+    if (this.blacklist.length === before) return false
+    await this.saveBlacklist()
+    return true
+  }
+
+  async listBlacklist() {
+    await this.loadBlacklist()
+    return this.blacklist.slice()
+  }
+
   async get(id) {
     const key = String(id)
     if (this.cache.has(key)) return this.cache.get(key)
@@ -1334,21 +1489,43 @@ async function fetchNotice(url, timeout) {
   }
 }
 
+// 汇总公告推送目标列表（noticeTargets：多目标，群/频道与私聊可混用）
+function buildNoticeTargets(config) {
+  const list = Array.isArray(config.noticeTargets) ? config.noticeTargets : []
+  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 sendNoticeMessage(ctx, config, content, logger) {
-  if (!config.noticePlatform || !config.noticeChannelId) return false
+  const targets = buildNoticeTargets(config)
+  if (!config.noticePlatform || !targets.length) return false
   const bot = ctx.bots && ctx.bots.find(b => b.platform === config.noticePlatform && b.status === 1)
   if (!bot) return false
-  try {
-    if (config.noticeChannelType === 'private') {
-      await bot.sendPrivateMessage(config.noticeChannelId, content)
-    } else {
-      await bot.sendMessage(config.noticeChannelId, content)
+  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('公告推送失败(' + t.type + ':' + t.id + '): ' + (e && e.message ? e.message : e))
     }
-    return true
-  } catch (e) {
-    logger.warn('公告推送失败: ' + (e && e.message ? e.message : e))
-    return false
   }
+  return ok
 }
 
 // 公告渲染为图片推送；失败（无 puppeteer / 渲染出错）返回 false，由调用方回退文本

package/notice.js

@@ -216,7 +216,10 @@ function buildNoticeHtml(parsed, config, changed) {
   const width = config.width || 1300
   const sourceName = config.sourceName || '官方'
   const title = parsed.title || '更新公告'
-  const introLines = parsed.intro.split('\n').map(l => l.trim()).filter(Boolean)
+  // 增量推送（changed 非空）时，引言（第 1 个板块前的“致诸位尊敬的访客”等段落）未变动则不渲染，
+  // 避免每次推送都把固定引言带进图里；完整渲染（changed 为空）时始终展示
+  const showIntro = !changed || changed.intro
+  const introLines = showIntro ? parsed.intro.split('\n').map(l => l.trim()).filter(Boolean) : []
   const introHtml = introLines.length
     ? '<div class="intro' + (changed ? ' update' : '') + '">' + introLines.map(l => inlineHtml(l)).join('<br>') + '</div>'
     : ''

package/package.json

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

package/readme.md

@@ -115,7 +115,7 @@ WIKI页面 <页面名>
 | `图鉴 时装 招风旗` | 查询时装「招风旗」并生成图片卡片 |
 
 - 数据来自第五人格 BWIKI（`wiki.biligame.com/dwrg`），通过 `query&prop=revisions` 获取页面 wikitext 后按模板解析
-- 二级指令、模板名（前缀匹配，可多个）、解析字段、配图文件名模板与输出宽度均可在插件配置「图鉴二级指令配置」中自定义增减
+- 二级指令、模板名（前缀匹配，可多个）、解析字段、配图文件名模板与输出宽度均可在插件配置「图鉴二级指令配置」中自定义增减；字段以表格形式通过「添加项目」新增（每行一个参数），新增时默认只填 `key`，`label` 留空则显示参数名
 - 配图文件名模板用 `{{参数名}}` 占位，如 `{{角色}}{{品质}}品质时装_{{名称}}.png`，插件会按该文件名在 wiki 上查找图片并显示在卡片左侧（找不到则不显示）；参数值会自动清洗 wiki 语法（`[[链接]]`、`[[File:..]]`、`<br>` 等）
 - 每个二级指令可单独设置 `width`（输出图片宽度，0=使用默认宽度），卡片为左侧图片、右侧字段表格的版式
 - **时装专属**：`图鉴 时装 <名称>` 会额外读取 `/WIKI/时装稀有度/` 的 `latest_price.csv`（最新价格），在卡片底部显示该时装的**占有率**（含数据更新日期，占有率为动态数据）；当品质为「稀世」时额外显示**单金价格**与**多金价格**
@@ -253,10 +253,17 @@ WIKI页面 <页面名>
 | 指令 | 含义 |
 | --- | --- |
 | `反馈 抽卡图片显示异常` | 提交反馈并私聊推送给管理员 |
-| `反馈 问题已处理 -i 12` | 管理员按编号回复反馈者（需权限 2 级） |
+| `反馈 问题已处理 -i 12` | 管理员按编号回复反馈者 |
+| `反馈 拉黑 <用户id> [原因]` | 管理员拉黑用户，被拉黑者提交反馈时会收到拉黑提示 |
+| `反馈 拉黑 -i <编号> [原因]` | 管理员直接拉黑某条反馈的作者 |
+| `反馈 解封 <用户id>` | 管理员解除用户的拉黑 |
+| `反馈 黑名单` | 管理员查看当前反馈黑名单列表 |
 
 - 提交反馈后生成递增编号，回复「已收到反馈（编号 #N）」
+- 管理员判定：用户 id 在配置项 `feedbackAdminIds` 中，或 koishi 权限 ≥2。**注意：koishi 新用户默认权限只有 1 级**，请在插件配置 `feedbackAdminIds` 中填入你自己的用户 id（如 QQ 号），否则回复/拉黑操作会提示权限不足
 - 管理员用 `反馈 <回复内容> -i <编号>` 通过机器人**私聊**回复反馈者，并标记该反馈已回复
+- **QQ 官方机器人注意**：回复/推送属于机器人**主动发消息**，需在 QQ 开放平台的机器人设置中开通「主动消息」能力（群主动消息/私聊主动消息），否则会提示回复失败（日志中的错误码可通过插件日志查看）；若私聊受限，回复会兜底转发到配置的反馈群
+- 被拉黑的用户提交反馈时会被拦截并直接告知「你已被加入反馈黑名单」（不生成记录、不推送给管理员）；黑名单按「平台 + 用户 id」匹配，持久化到数据库（`feedback_data` 表），管理员账号（`feedbackAdminIds` 或权限 ≥2）不能被拉黑
 - 反馈记录持久化到数据库（`feedback_data` 表）
 
 ## 配置
@@ -270,20 +277,12 @@ WIKI页面 <页面名>
 | `showBadge` | 显示勋章分数据 | `true` |
 | `badgeDays` | 勋章日增长率天数 | `7` |
 | `width` | 图片宽度（px），其他指令未单独设置时使用该值 | `1300` |
-| `winrateWidth` | 胜率指令图片宽度（px），0=使用默认宽度 | `0` |
-| `mapWidth` | 地图指令图片宽度（px），0=使用默认宽度 | `0` |
-| `mimicWidth` | 模仿者指令图片宽度（px），0=使用默认宽度 | `0` |
-| `badgeWidth` | 勋章指令图片宽度（px），0=使用默认宽度 | `0` |
-| `basicWidth` | 基础数据指令图片宽度（px），0=使用默认宽度 | `0` |
-| `gachaWidth` | 抽卡/探索/资源指令图片宽度（px），0=使用默认宽度 | `0` |
-| `codexWidth` | 图鉴指令图片宽度（px），0=使用默认宽度 | `0` |
+| `commandWidths` | 各指令图片宽度表（表格形式，每行：指令名 + 宽度，0=使用默认宽度），可配置胜率/地图/模仿者/赛事/勋章/基础数据/抽卡/图鉴/WIKI | 空 |
 | `codexCommands` | 图鉴二级指令配置（名称/说明/模板名/解析字段，可增减） | 预置「时装」 |
-| `wikiWidth` | WIKI页面指令截图宽度（px） | `1300` |
 | `wikiMaxHeight` | WIKI页面指令截图最大高度（px） | `5000` |
 | `wikiDailyLimit` | WIKI页面指令每日使用次数上限 | `5` |
 | `cangtouDefaultMode` | 藏头指令默认模式 | `谐音` |
 | `cangtouDefaultType` | 藏头指令默认物品类型 | `所有` |
-| `matchWidth` | 赛事指令图片宽度（px），0=使用默认宽度 | `0` |
 | `matchMerge` | 赛事指令默认合并模式（team/player/all/none） | `team` |
 | `gachaDailyLimit` | 抽卡/探索每日次数上限 | `2` |
 | `gachaDefaultJinghua` | 抽卡-精华 默认卡池编号 | 空 |
@@ -299,10 +298,11 @@ WIKI页面 <页面名>
 | `wecomPushDelay` | 断连宽限期（秒）：断开不超过该时长不会推送，期间恢复则静默 | `60` |
 | `feedbackPlatform` | 接收反馈的平台（如 `qq`），留空禁用反馈推送 | 空 |
 | `feedbackUserId` | 接收反馈的账号 id | 空 |
+| `feedbackChannelId` | 接收反馈的群/频道 id（优先于私聊推送） | 空 |
+| `feedbackAdminIds` | 反馈管理账号 id 列表（可回复/拉黑/解封/查看黑名单）。koishi 新用户默认权限只有 1 级，达不到回复要求的 2 级，请在此填入你自己的用户 id；留空则仅允许 koishi 权限 ≥2 的账号 | 空 |
 | `noticeEnable` | 启用网易公告变动监听 | `false` |
 | `noticePlatform` | 公告推送的平台（如 `qq`），留空禁用公告推送 | `qq` |
-| `noticeChannelType` | 公告推送目标类型（channel=群/频道，private=私聊） | `channel` |
-| `noticeChannelId` | 公告推送目标：群/频道 id 或用户 id | 空 |
+| `noticeTargets` | 公告推送目标列表，以表格形式通过「添加项目」新增（每行一个目标：类型 channel=群/频道 或 private=私聊、目标 id），可添加多个，群/频道与私聊可同时推送 | 空 |
 | `noticeInterval` | 公告检查间隔（分钟） | `10` |
 
 数据源两个镜像：`https://website.homeworkkun.top` 与 `https://web.homeworkkun.top`，可直接在配置中切换。
@@ -320,7 +320,9 @@ WIKI页面 <页面名>
 - 正式服：`https://h55.update.netease.com/h55_notice_version2.txt`
 - 共研服：`https://h55.update.netease.com/h55_notice_gongyan_version2.txt`
 
-每次内容变动（以内容哈希判断）时，通过 `noticePlatform` 平台的机器人推送到 `noticeChannelId`（`noticeChannelType` 为 `channel` 时是群/频道、`private` 时是私聊）。推送内容为「公告标题」+ 正文摘要（去除 HTML 标签与颜色代码，截断 500 字）。首次启动只记录基线，不推送。
+每次内容变动（以内容哈希判断）时，通过 `noticePlatform` 平台的机器人推送到 `noticeTargets` 列表中的全部目标（每条目标可单独指定 `channel` 群/频道或 `private` 私聊，可同时推送）。推送内容为「公告标题」+ 正文摘要（去除 HTML 标签与颜色代码，截断 500 字）。首次启动只记录基线，不推送。
+
+变更推送优先渲染为图片（仅包含发生变化的部分）：当「致诸位尊敬的访客」等引言段落没有变动时，不再将其渲染进图中，避免每次推送都带上固定引言；若引言本身有变动则会正常展示。图片渲染失败时自动回退为纯文本摘要推送。
 
 ## 图片内容