koishi-plugin-dwrgbwiki 2.2.0 → 2.2.2

package/index.js

@@ -188,6 +188,9 @@ 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),
@@ -573,23 +576,77 @@ module.exports = {
 
     ctx.command('反馈 <内容:text>', '反馈问题或建议（会私聊推送给管理员）')
       .usage('反馈 <内容>')
+      .usage('反馈 <回复内容> -i <编号>（管理员：回复该反馈）')
+      .usage('反馈 拉黑 <用户id> [原因] / 反馈 拉黑 -i <编号> [原因]（管理员：拉黑用户）')
+      .usage('反馈 解封 <用户id> / 反馈 黑名单（管理员）')
       .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 = /^(拉黑|解封|黑名单)(?=\s|$)/.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(/^(拉黑|解封|黑名单)(?=\s|$)/) || [])[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(/^拉黑\s*/, '').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(/^解封\s*/, '').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() : '')
@@ -612,7 +669,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 {
@@ -627,18 +684,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({
@@ -665,15 +728,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 + '）。如需收到回复，请联系群主打开机器人主动在群聊发言功能。本机器人由玩家制作，并非网易第五人格官方机器人，请勿反馈第五人格相关问题。'
       })
   },
 }
@@ -692,6 +755,29 @@ 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: '胜率',
@@ -1242,6 +1328,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() {
@@ -1264,6 +1352,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)

package/package.json

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

package/readme.md

@@ -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` 表）
 
 ## 配置
@@ -291,6 +298,8 @@ WIKI页面 <页面名>
 | `wecomPushDelay` | 断连宽限期（秒）：断开不超过该时长不会推送，期间恢复则静默 | `60` |
 | `feedbackPlatform` | 接收反馈的平台（如 `qq`），留空禁用反馈推送 | 空 |
 | `feedbackUserId` | 接收反馈的账号 id | 空 |
+| `feedbackChannelId` | 接收反馈的群/频道 id（优先于私聊推送） | 空 |
+| `feedbackAdminIds` | 反馈管理账号 id 列表（可回复/拉黑/解封/查看黑名单）。koishi 新用户默认权限只有 1 级，达不到回复要求的 2 级，请在此填入你自己的用户 id；留空则仅允许 koishi 权限 ≥2 的账号 | 空 |
 | `noticeEnable` | 启用网易公告变动监听 | `false` |
 | `noticePlatform` | 公告推送的平台（如 `qq`），留空禁用公告推送 | `qq` |
 | `noticeTargets` | 公告推送目标列表，以表格形式通过「添加项目」新增（每行一个目标：类型 channel=群/频道 或 private=私聊、目标 id），可添加多个，群/频道与私聊可同时推送 | 空 |