@wenbin_wb/dsh-bridge 2.2.3 → 2.2.5

package/lib/qq/index.js

@@ -60,7 +60,7 @@ export class QqService extends Platform {
       sendChunkDelayMs: config.sendChunkDelayMs,
       activeSessionId: config.activeSessionId,
     }, logger, {
-      onFirstSender: (senderId) => this.persist({ allowFrom: [senderId] }),
+      onFirstSender: () => this.persist({ allowFrom: [...(this.node?.config?.allowFrom ?? [])] }),
       onActiveSessionChange: (sessionId) => this.persist({ activeSessionId: sessionId }),
     })
     this.bridge = this.node
@@ -141,6 +141,8 @@ export class QqService extends Platform {
       approvalTimeoutSec: this.node.config.approvalTimeoutSec,
       maxMessageChars: this.node.config.maxMessageChars,
       sendChunkDelayMs: this.node.config.sendChunkDelayMs,
+      appId: this.gateway.config.appId,
+      clientSecret: '',
     }
   }
 
@@ -240,14 +242,23 @@ export class QqService extends Platform {
     }
 
     // 自定义菜单：单聊底部菜单（send_message 类型，点击自动填入命令）
+    // 幂等：先查询，内容一致则跳过 PUT，避免每次重启都覆盖（version 递增）
     try {
       const menuItems = [
         { name: '新建', type: 'send_message', send_message: '/new' },
         { name: '列表', type: 'send_message', send_message: '/list' },
         { name: '帮助', type: 'send_message', send_message: '/help' },
       ]
-      await gate.setMenu(menuItems)
-      this.logger.info('[dsh-bridge qq] custom menu configured')
+      const existing = await gate.getMenu()
+      const existingItems = existing?.menu?.items || []
+      const same = existingItems.length === menuItems.length &&
+        menuItems.every((item, i) => existingItems[i]?.name === item.name && existingItems[i]?.send_message === item.send_message)
+      if (!same) {
+        await gate.setMenu(menuItems)
+        this.logger.info('[dsh-bridge qq] custom menu configured')
+      } else {
+        this.logger.info('[dsh-bridge qq] custom menu already configured')
+      }
     } catch (err) {
       this.logger.warn('[dsh-bridge qq] custom menu setup skipped: %s', err?.message ?? err)
     }

package/lib/qq/node.js

@@ -52,6 +52,25 @@ function sanitizeQQMarkdown(text) {
   return out.join('\n')
 }
 
+/**
+ * replace 模式流式分片：把完整内容切成「递增前缀」序列。
+ * 官方要求 replace 模式下每片 content_raw 为当前全量正文，
+ * 且须以上游已下发内容开头；服务端逐片覆盖显示 → 手机端看到一条消息逐渐变长。
+ * @param {string} content
+ * @param {number} maxChunk - 单片最大字符数（用户配置的 maxMessageChars）
+ * @returns {string[]} 递增前缀数组，最后一片为完整内容
+ */
+function splitIntoIncremental(content, maxChunk) {
+  const segs = splitIntoChunks(content, maxChunk)
+  const slices = []
+  let acc = ''
+  for (const s of segs) {
+    acc += s
+    slices.push(acc)
+  }
+  return slices
+}
+
 /**
  * 按段落边界切分内容（避免切断行内内容），单块时拆两片保证流式过渡
  * @param {string} content - 要分片的内容
@@ -143,54 +162,83 @@ export class QqConversationNode extends ConversationBridge {
 
     if (isPromptMessage) {
       // 发送带按钮的消息，方便用户快速操作
+      // 官方键盘结构：keyboard.content.rows；action.type=1（回调按钮，触发 INTERACTION_CREATE）
+      // 参考：https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/trans/msg-btn.html
       const keyboard = {
-        rows: [
-          {
-            buttons: [
-              { id: 'new_conversation', render_data: { label: '🆕 新建会话', visited_label: '新建会话' }, action: { type: 2, permission: { type: 2 } } },
-              { id: 'list_sessions', render_data: { label: '📋 会话列表', visited_label: '会话列表' }, action: { type: 2, permission: { type: 2 } } },
-            ],
-          },
-          {
-            buttons: [
-              { id: 'help', render_data: { label: '❓ 帮助', visited_label: '帮助' }, action: { type: 2, permission: { type: 2 } } },
-            ],
-          },
-        ],
+        content: {
+          rows: [
+            {
+              buttons: [
+                {
+                  id: 'new_conversation',
+                  render_data: { label: '🆕 新建会话', visited_label: '新建会话', style: 1 },
+                  action: { type: 1, permission: { type: 2 }, data: 'new', unsupport_tips: '请升级QQ客户端后使用' },
+                },
+                {
+                  id: 'list_sessions',
+                  render_data: { label: '📋 会话列表', visited_label: '会话列表', style: 1 },
+                  action: { type: 1, permission: { type: 2 }, data: 'list', unsupport_tips: '请升级QQ客户端后使用' },
+                },
+              ],
+            },
+            {
+              buttons: [
+                {
+                  id: 'help',
+                  render_data: { label: '❓ 帮助', visited_label: '帮助', style: 1 },
+                  action: { type: 1, permission: { type: 2 }, data: 'help', unsupport_tips: '请升级QQ客户端后使用' },
+                },
+              ],
+            },
+          ],
+        },
       }
-      return this.gateway.sendKeyboard(peerId, text, keyboard, { scope, msgId: replyMsgId })
+      // 官方按钮基于 markdown 消息（msg_type=2）挂载
+      return this._sendMarkdown(peerId, text, { scope, msgId: replyMsgId, keyboard })
     }
 
-    // 其他回复统一走「流式 Markdown」：content_type=markdown 让手机端渲染，append 模式逐段追加
+    // 其他回复统一走「流式 Markdown」：content_type=markdown 让手机端渲染
     const content = String(text || '').trim()
     if (content.length === 0) return { success: true }
-
     const md = sanitizeQQMarkdown(content)
-    // 使用用户配置的 maxMessageChars（默认 2000），而非硬编码 200
+
+    // 群消息不支持流式参数（官方文档明确说明），直接发送 Markdown
+    // 参考：https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_groups_group_openid_messages.post.html
+    if (scope === 'group') {
+      return this._sendMarkdown(peerId, md, { scope, msgId: replyMsgId })
+    }
+
+    // 单聊：replace 模式（每片是全量前缀），服务端逐片覆盖 → 一条消息逐渐变长
     const maxChars = this.config.maxMessageChars || 2000
-    const chunks = splitIntoChunks(md, maxChars)
+    const slices = splitIntoIncremental(md, maxChars)
+
+    // 被动回复的 msg_id 每片都带（官方示例如此）；主动消息（digest 等）无 msg_id 则不传
+    const baseSeq = Number(this._msgSeq) || 0
+    const streamCommon = {
+      scope,
+      contentType: 'markdown',
+      inputMode: 'replace',
+    }
 
     try {
       let streamMsgId = null
-      for (let i = 0; i < chunks.length; i++) {
-        const isLast = i === chunks.length - 1
-        const result = await this.gateway.sendStream(peerId, chunks[i], {
-          scope,
-          contentType: 'markdown', // 流式 Markdown，手机端正常渲染
-          msgId: i === 0 ? replyMsgId : undefined, // 首片带被动回复 msg_id
+      for (let i = 0; i < slices.length; i++) {
+        const isLast = i === slices.length - 1
+        const result = await this.gateway.sendStream(peerId, slices[i], {
+          ...streamCommon,
+          msgId: replyMsgId, // 每片都带被动回复 msg_id（官方示例如此）
+          msgSeq: replyMsgId ? baseSeq + 1 + i : undefined, // 递增避免去重（40054005）
           streamMsgId, // 后续片携带服务端返回的 stream_msg_id
           index: i, // 分片序号从 0 递增
           inputState: isLast ? 10 : 1, // 1=生成中, 10=生成结束
-          inputMode: 'append', // 追加模式：服务端拼接到同一条消息
         })
 
         // 首片返回 stream_msg_id，后续片需携带
         if (i === 0) {
-          // 尝试多个可能的字段名
           streamMsgId = result?.id || result?.message_id || result?.stream_msg_id
           if (streamMsgId) {
             this.lastMessageId = streamMsgId
-            this.logger?.info?.('[dsh-bridge qq] stream started, stream_msg_id=%s, chunks=%d', streamMsgId, chunks.length)
+            this.logger?.info?.('[dsh-bridge qq] stream started, stream_msg_id=%s, slices=%d', streamMsgId, slices.length)
           } else {
             this.logger?.warn?.('[dsh-bridge qq] stream first chunk returned no id: %o', result)
           }
@@ -208,34 +256,52 @@ export class QqConversationNode extends ConversationBridge {
       }
       return { success: true }
     } catch (err) {
-      // 流式失败（如被动回复 msg_id 过期）→ 依次回退：带 msg_id 的 Markdown → 主动 Markdown
-      this.logger?.warn?.('[dsh-bridge qq] stream send failed, fallback to markdown: %s', err?.message ?? err)
+      // 流式失败 → 补发完整内容 replace 收尾（input_state=10），尽量合并成一条
+      this.logger?.warn?.('[dsh-bridge qq] stream send failed, patch final replace: %s', err?.message ?? err)
       try {
-        const result = await this.gateway.sendMarkdown(peerId, md, { 
-          scope, 
+        const result = await this.gateway.sendStream(peerId, md, {
+          ...streamCommon,
           msgId: replyMsgId,
-          msgSeq: this._msgSeq !== undefined ? this._msgSeq + 1 : undefined, // 使用递增的 msg_seq 避免去重
+          msgSeq: replyMsgId ? baseSeq + slices.length + 1 : undefined,
+          streamMsgId,
+          index: slices.length,
+          inputState: 10,
         })
         if (result?.id) this.lastMessageId = result.id
         return result
       } catch (fallbackErr1) {
-        try {
-          // 主动消息兜底（digest 心跳等非回复场景，msg_id 已过期或无）
-          const result = await this.gateway.sendMarkdown(peerId, md, { scope })
-          if (result?.id) this.lastMessageId = result.id
-          return result
-        } catch (fallbackErr2) {
-          this.logger?.error?.('[dsh-bridge qq] markdown send failed: %s', fallbackErr2?.message ?? fallbackErr2)
-          return { success: false, error: fallbackErr2?.message ?? String(fallbackErr2) }
-        }
+        // 主动消息兜底（digest 心跳等非回复场景，msg_id 已过期或无）
+        return this._sendMarkdown(peerId, md, { scope })
       }
     }
   }
 
-  /** 发送"正在输入"状态（QQ 通过 msg_type=6 + input_notify 显示 N 秒） */
+  /** 发送 Markdown 消息：先带被动回复 msg_id，失败则降级为主动消息。 */
+  async _sendMarkdown(peerId, md, { scope, msgId, keyboard } = {}) {
+    try {
+      const result = await this.gateway.sendMarkdown(peerId, md, { scope, msgId, keyboard })
+      if (result?.id) this.lastMessageId = result.id
+      return result
+    } catch (fallbackErr1) {
+      // 被动回复失败（msg_id 过期等）→ 主动消息兜底
+      this.logger?.warn?.('[dsh-bridge qq] markdown send failed with msg_id, retry as active: %s', fallbackErr1?.message ?? fallbackErr1)
+      try {
+        const result = await this.gateway.sendMarkdown(peerId, md, { scope, keyboard })
+        if (result?.id) this.lastMessageId = result.id
+        return result
+      } catch (fallbackErr2) {
+        this.logger?.error?.('[dsh-bridge qq] markdown send failed: %s', fallbackErr2?.message ?? fallbackErr2)
+        return { success: false, error: fallbackErr2?.message ?? String(fallbackErr2) }
+      }
+    }
+  }
+
+  /** 发送"正在输入"状态（QQ 通过 msg_type=6 + input_notify 显示 N 秒；群聊不支持） */
   async sendTyping(state) {
     const peerInfo = this._currentPeer()
     if (!peerInfo) return
+    // 群聊消息类型列表不含 msg_type=6（输入状态），跳过
+    if (peerInfo.scope === 'group') return { ok: true }
     // state=2（停止）时无需显式结束——input_second 到期自动消失
     if (Number(state) === 2) return { ok: true }
     return this.gateway.sendTyping(peerInfo.peerId, {
@@ -251,9 +317,18 @@ export class QqConversationNode extends ConversationBridge {
     const sender = String(event.senderId ?? '').trim()
     if (!sender) return
 
-    // 快速预检查：白名单非空时，未授权发件人直接忽略
-    if (!this.isAllowed(sender) && this.config.allowFrom.length > 0) {
-      this.logger?.info?.(`[dsh-bridge qq] ignore message from non-allowlisted sender ${sender}`)
+    // 群聊：仅在群聊 @ 机器人事件中处理（GROUP_AT_MESSAGE_CREATE 已由网关归一化）
+    const isGroup = event.scope === 'group' || event.scope === 'guild'
+
+    // 记录当前 peer 信息与被动回复消息 ID（事件 d.id）、msg_seq，供出站使用
+    const peerId = isGroup ? event.groupId || event.peerId : event.peerId || event.senderId
+    // 授权主体：群聊按群维度（group_openid），单聊按用户（user_openid）
+    const authId = isGroup ? (event.groupId || peerId || sender) : sender
+
+    // 快速预检查：白名单非空时，未授权单聊发件人直接忽略；
+    // 群聊不在此拦截——交给 handleInbound 自动授权（首次 @机器人 即授权该群）
+    if (!isGroup && !this.isAllowed(authId) && this.config.allowFrom.length > 0) {
+      this.logger?.info?.(`[dsh-bridge qq] ignore message from non-allowlisted sender ${authId}`)
       return
     }
 
@@ -263,11 +338,6 @@ export class QqConversationNode extends ConversationBridge {
       return
     }
 
-    // 群聊：仅在群聊 @ 机器人事件中处理（GROUP_AT_MESSAGE_CREATE 已由网关归一化）
-    const isGroup = event.scope === 'group' || event.scope === 'guild'
-
-    // 记录当前 peer 信息与被动回复消息 ID（事件 d.id）、msg_seq，供出站使用
-    const peerId = isGroup ? event.groupId || event.peerId : event.peerId || event.senderId
     if (peerId) {
       this._lastPeer = { peerId: String(peerId), scope: isGroup ? 'group' : 'c2c' }
       if (event.id) this._replyMsgId = String(event.id)
@@ -280,13 +350,13 @@ export class QqConversationNode extends ConversationBridge {
     if (messageReference && !this.activeSessionId && !text.startsWith('/')) {
       this.logger?.info?.(`[dsh-bridge qq] detected message reference from ${sender}, auto-starting conversation`)
       // 先创建新会话，再处理消息
-      await this.handleInbound({ senderId: sender, text: '/new', isGroup })
+      await this.handleInbound({ senderId: authId, text: '/new', isGroup })
       // 等待一小段时间确保会话创建完成
       await new Promise(resolve => setTimeout(resolve, 100))
     }
 
     // 交给平台无关核心：白名单/群消息/命令路由/agent 分发
-    await this.handleInbound({ senderId: sender, text, isGroup })
+    await this.handleInbound({ senderId: authId, text, isGroup })
   }
 
   // ---- 互动事件 ----
@@ -295,36 +365,54 @@ export class QqConversationNode extends ConversationBridge {
     const sender = String(event.senderId ?? '').trim()
     if (!sender) return
 
-    // 快速预检查：白名单非空时，未授权发件人直接忽略
-    if (!this.isAllowed(sender) && this.config.allowFrom.length > 0) {
-      this.logger?.info?.(`[dsh-bridge qq] ignore interaction from non-allowlisted sender ${sender}`)
+    // 群聊按钮点击：授权主体按群维度（group_openid），与消息处理一致
+    const isGroup = event.scope === 'group'
+    const peerId = isGroup ? event.groupId || event.peerId : event.peerId || sender
+    const authId = isGroup ? (event.groupId || peerId || sender) : sender
+
+    // 快速预检查：白名单非空时，未授权单聊发件人直接忽略；
+    // 群聊不在此拦截——handleInbound 会按群自动授权
+    if (!isGroup && !this.isAllowed(authId) && this.config.allowFrom.length > 0) {
+      this.logger?.info?.(`[dsh-bridge qq] ignore interaction from non-allowlisted sender ${authId}`)
       return
     }
 
+    const type = Number(event.interactionType ?? event?.data?.type ?? 0)
+    // 仅消息按钮(11)与快捷菜单(12)需要回应；其他类型（反馈/清空会话/故事集/授权等）无需回应
+    const needsRespond = type === 11 || type === 12
+
     // 记录 peer 信息，供命令回复使用
-    const isGroup = event.scope === 'group'
-    const peerId = isGroup ? event.groupId || event.peerId : event.peerId || sender
     if (peerId) {
       this._lastPeer = { peerId: String(peerId), scope: isGroup ? 'group' : 'c2c' }
       this._replyMsgId = null
     }
 
+    // 回应互动：告知后台已收到，避免客户端一直 loading（同一 interaction_id 只能回应一次）
+    if (needsRespond && event.interactionId) {
+      try {
+        await this.gateway.respondInteraction(event.interactionId, { code: 0 })
+      } catch (err) {
+        this.logger?.warn?.('[dsh-bridge qq] respond interaction failed: %s', err?.message ?? err)
+      }
+    }
+
+    if (!needsRespond) {
+      this.logger?.info?.(`[dsh-bridge qq] skip non-button interaction type=${type} from ${authId}`)
+      return
+    }
+
     const data = event.data || {}
     const resolved = data.resolved || {}
     const buttonId = resolved.button_id || ''
 
-    // 响应互动
-    await this.gateway.respondInteraction(event.interactionId, {
-      code: 0,
-    })
-
-    // 根据按钮 ID 执行对应操作
+    // 根据按钮 ID 执行对应操作（消息按钮 11 与快捷菜单 12 都映射到命令）
+    this.logger?.info?.('[dsh-bridge qq] button interaction type=%s button_id=%s from %s', type, buttonId, authId)
     if (buttonId === 'new_conversation') {
-      await this.handleInbound({ senderId: sender, text: '/new', isGroup: event.scope === 'group' })
+      await this.handleInbound({ senderId: authId, text: '/new', isGroup })
     } else if (buttonId === 'list_sessions') {
-      await this.handleInbound({ senderId: sender, text: '/list', isGroup: event.scope === 'group' })
+      await this.handleInbound({ senderId: authId, text: '/list', isGroup })
     } else if (buttonId === 'help') {
-      await this.handleInbound({ senderId: sender, text: '/help', isGroup: event.scope === 'group' })
+      await this.handleInbound({ senderId: authId, text: '/help', isGroup })
     } else {
       this.logger?.info?.(`[dsh-bridge qq] unknown button interaction: ${buttonId}`)
     }
@@ -340,5 +428,6 @@ export const qqNodeHelpers = {
   sessionsInDisplayOrder: conversationBridgeHelpers.sessionsInDisplayOrder,
   sanitizeQQMarkdown,
   splitIntoChunks,
+  splitIntoIncremental,
   STREAM_CHUNK_SIZE,
 }

package/lib/tunnel-client.mjs

@@ -22,7 +22,6 @@ export class CustomTunnelClient {
     this.reconnectAttempts = 0;
     this.reconnectTimer = null;
     this.heartbeatTimer = null;
-    this.pendingRequests = new Map();
     this.localWsSockets = new Map(); // wsId -> net.Socket
   }
 
@@ -276,8 +275,6 @@ export class CustomTunnelClient {
     if (this.ws) { this.ws.close(); this.ws = null; }
     this.connected = false;
     this.publicUrl = null;
-    for (const [, p] of this.pendingRequests) p.reject(new Error('Disconnected'));
-    this.pendingRequests.clear();
     this.logger?.info('Tunnel disconnected');
   }
 }

package/lib/wechat/index.js

@@ -44,7 +44,7 @@ export class WechatService extends Platform {
       sendChunkDelayMs: config.sendChunkDelayMs,
       activeSessionId: config.activeSessionId, // v0.2.1：恢复活动会话
     }, logger, {
-      onFirstSender: (senderId) => this.persist({ allowFrom: [senderId] }),
+      onFirstSender: () => this.persist({ allowFrom: [...(this.node?.config?.allowFrom ?? [])] }),
       onActiveSessionChange: (sessionId) => this.persist({ activeSessionId: sessionId }), // v0.2.1：持久化活动会话
     })
     this.bridge = this.node

package/lib/wechat/node.js

@@ -147,7 +147,7 @@ export class WechatConversationNode extends ConversationBridge {
             continue
           }
 
-          const aesKey = img.aeskey || img.aes_key || img.media?.aes_key
+          const aesKey = img.aeskey || img.aes_key || img.media?.aes_key || img.media?.aeskey
           if (!aesKey) {
             const fields = Object.keys(img).join(', ')
             const msg = `图片缺 aes_key，字段: ${fields}`
@@ -156,14 +156,20 @@ export class WechatConversationNode extends ConversationBridge {
             continue
           }
 
-          // 从 image_item.media 对象提取 CDN 下载参数
+          // 从 image_item 或 image_item.media 对象提取 CDN 下载参数
           const mediaObj = img.media
-          const encryptedParam = mediaObj?.encrypt_query_param || mediaObj?.encrypted_query_param || mediaObj?.encrypt_query_param_full || mediaObj
-          debugInfo.push(`media 类型: ${typeof mediaObj}, param=${!!encryptedParam && typeof mediaObj === 'object'}${typeof mediaObj === 'string' ? ' (字符串)' : ''}`)
+          const encryptedParam = img.encrypt_query_param
+            || img.encrypted_query_param
+            || mediaObj?.encrypt_query_param
+            || mediaObj?.encrypted_query_param
+            || mediaObj?.encrypt_query_param_full
+            || (typeof mediaObj === 'string' ? mediaObj : undefined)
+          const fullUrl = img.full_url || img.url || mediaObj?.full_url || mediaObj?.url
+          debugInfo.push(`media 类型: ${typeof mediaObj}, param=${!!encryptedParam}`)
 
           const file = await this._downloadMediaItem({
-            encryptedQueryParam: mediaObj?.encrypt_query_param || (typeof mediaObj === 'string' ? mediaObj : undefined),
-            fullUrl: mediaObj?.full_url || mediaObj?.url,
+            encryptedQueryParam: encryptedParam,
+            fullUrl,
             aesKeyBase64: aesKey,
             sender,
             mediaType: 'image',
@@ -181,15 +187,25 @@ export class WechatConversationNode extends ConversationBridge {
             debugInfo.push(`文件项缺少 file_item`)
             continue
           }
-          const aesKey = fileItem.aes_key || fileItem.media?.aes_key
-          const encryptedParam = fileItem.media?.encrypt_query_param || (typeof fileItem.media === 'string' ? fileItem.media : undefined)
-          if (!encryptedParam || !aesKey) {
-            debugInfo.push(`文件缺 media/aes_key，字段: ${Object.keys(fileItem).join(', ')}`)
+          const aesKey = fileItem.aes_key || fileItem.aeskey || fileItem.media?.aes_key || fileItem.media?.aeskey
+          const encryptedParam = fileItem.encrypt_query_param
+            || fileItem.encrypted_query_param
+            || fileItem.media?.encrypt_query_param
+            || fileItem.media?.encrypted_query_param
+            || (typeof fileItem.media === 'string' ? fileItem.media : undefined)
+          const fullUrl = fileItem.full_url || fileItem.url || fileItem.media?.full_url || fileItem.media?.url
+
+          if (!encryptedParam && !fullUrl) {
+            debugInfo.push(`文件缺 media/encrypt_query_param，字段: ${Object.keys(fileItem).join(', ')}`)
+            continue
+          }
+          if (!aesKey) {
+            debugInfo.push(`文件缺 aes_key，字段: ${Object.keys(fileItem).join(', ')}`)
             continue
           }
           const file = await this._downloadMediaItem({
             encryptedQueryParam: encryptedParam,
-            fullUrl: fileItem.media?.full_url || fileItem.full_url,
+            fullUrl,
             aesKeyBase64: aesKey,
             sender,
             mediaType: 'file',
@@ -210,15 +226,25 @@ export class WechatConversationNode extends ConversationBridge {
             debugInfo.push(`视频项缺少 video_item`)
             continue
           }
-          const aesKey = video.aes_key || video.media?.aes_key
-          const encryptedParam = video.media?.encrypt_query_param || (typeof video.media === 'string' ? video.media : undefined)
-          if (!encryptedParam || !aesKey) {
-            debugInfo.push(`视频缺 media/aes_key，字段: ${Object.keys(video).join(', ')}`)
+          const aesKey = video.aes_key || video.aeskey || video.media?.aes_key || video.media?.aeskey
+          const encryptedParam = video.encrypt_query_param
+            || video.encrypted_query_param
+            || video.media?.encrypt_query_param
+            || video.media?.encrypted_query_param
+            || (typeof video.media === 'string' ? video.media : undefined)
+          const fullUrl = video.full_url || video.url || video.media?.full_url || video.media?.url
+
+          if (!encryptedParam && !fullUrl) {
+            debugInfo.push(`视频缺 media/encrypt_query_param，字段: ${Object.keys(video).join(', ')}`)
+            continue
+          }
+          if (!aesKey) {
+            debugInfo.push(`视频缺 aes_key，字段: ${Object.keys(video).join(', ')}`)
             continue
           }
           const file = await this._downloadMediaItem({
             encryptedQueryParam: encryptedParam,
-            fullUrl: video.media?.full_url || video.full_url,
+            fullUrl,
             aesKeyBase64: aesKey,
             sender,
             mediaType: 'video',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenbin_wb/dsh-bridge",
-  "version": "2.2.3",
+  "version": "2.2.5",
   "description": "手机扫码即可在移动端/公网继续用 DeepSeek Harness，人不在电脑前也能接着干。一键局域网二维码、Cloudflare 公网隧道、自建隧道与微信 Bot（多工作区/会话持久化/媒体/审批），无需自己搭公网服务器。",
   "type": "module",
   "main": "lib/index.js",
@@ -20,7 +20,8 @@
     "LICENSE",
     "docs/banner.jpg",
     "docs/custom-tunnel.md",
-    "docs/wechat-usage.md"
+    "docs/wechat-usage.md",
+    "docs/qq-usage.md"
   ],
   "scripts": {
     "build:client": "node client/build.mjs",