@wenbin_wb/dsh-bridge 2.1.2 → 2.2.2

package/lib/qq/gateway.js

@@ -5,7 +5,7 @@ import { Service } from '@deepseek-ai/cordis'
 import WebSocket from 'ws'
 
 const TOKEN_URL = 'https://bots.qq.com/app/getAppAccessToken'
-const API_BASE = 'https://api.sgroup.qq.com'
+const API_BASE = 'https://api.bot.qq.com'
 const DEFAULT_GATEWAY = 'wss://api.sgroup.qq.com/websocket/'
 const MAX_MESSAGE_CHARS = 2000
 const TOKEN_MARGIN_MS = 5 * 60_000
@@ -323,6 +323,7 @@ export class QqGateway extends Service {
       method: 'POST',
       body: {
         markdown: typeof markdown === 'string' ? { content: markdown } : markdown,
+        keyboard: opts.keyboard,
         msg_type: 2,
         msg_id: opts.msgId,
         event_id: opts.eventId,
@@ -331,12 +332,14 @@ export class QqGateway extends Service {
   }
 
   async sendKeyboard(peerId, content, keyboard, opts = {}) {
+    // 官方文档：keyboard 为附加字段，配合 msg_type=0(content) 或 msg_type=2(markdown) 使用
+    // 纯文本 + 键盘时使用 msg_type=0
     return this.api(this.endpoint(peerId, opts.scope), {
       method: 'POST',
       body: {
         content: stringValue(content),
         keyboard,
-        msg_type: 2,
+        msg_type: 0,
         msg_id: opts.msgId,
         event_id: opts.eventId,
       },
@@ -355,15 +358,19 @@ export class QqGateway extends Service {
   }
 
   async sendStream(peerId, content, opts = {}) {
-    const endpoint = this.endpoint(peerId, opts.scope, 'stream-messages')
+    const endpoint = this.endpoint(peerId, opts.scope, 'stream_messages')
     return this.api(endpoint, {
       method: 'POST',
       body: {
-        content: stringValue(content).slice(0, MAX_MESSAGE_CHARS),
-        msg_type: 0,
+        content_type: opts.contentType || 'text',
+        content_raw: stringValue(content).slice(0, MAX_MESSAGE_CHARS),
+        input_mode: opts.inputMode || 'replace',
+        input_state: opts.inputState, // 1=生成中, 10=生成结束
+        index: opts.index, // 分片序号，从0递增
+        stream_msg_id: opts.streamMsgId, // 第一片由服务端返回，后续片需携带
         msg_id: opts.msgId,
         event_id: opts.eventId,
-        input_state: opts.inputState, // 0=结束输入, 1=输入中
+        msg_seq: opts.msgSeq,
       },
     })
   }
@@ -376,22 +383,83 @@ export class QqGateway extends Service {
   }
 
   async sendTyping(peerId, opts = {}) {
-    // QQ Bot API v2 通过流式消息的 input_state 参数控制输入状态
-    // input_state: 0=结束输入, 1=输入中
-    // 参考：https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_users_user_openid_stream_messages.post.html
-    const endpoint = this.endpoint(peerId, opts.scope, 'stream-messages')
+    // QQ Bot API v2 使用 msg_type: 6 发送输入状态通知
+    // 参考：https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_users_user_openid_messages.post.html
+    const endpoint = this.endpoint(peerId, opts.scope)
     return this.api(endpoint, {
       method: 'POST',
       body: {
-        content: '', // 仅设置输入状态，不发送内容
-        msg_type: 0,
-        input_state: 1, // 1=输入中
+        msg_type: 6,
+        input_notify: {
+          input_type: 1,
+          input_second: Math.min(opts.durationSeconds || 5, 60), // 最长60秒
+        },
         msg_id: opts.msgId,
         event_id: opts.eventId,
       },
     })
   }
 
+  // ---- 自定义菜单（单聊底部菜单，全局生效）----
+  // 参考：https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_menu.get.html
+  //       https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_menu.put.html
+
+  /** 查询全局自定义菜单 */
+  async getMenu() {
+    return this.api('/v2/menu', { method: 'GET' })
+  }
+
+  /**
+   * 修改全局自定义菜单（覆盖式）
+   * @param {Array} items 菜单项，最多 10 个
+   *   { name, type: 'switch'|'send_message'|'link'|'menu', sub_menu_items?, send_message?, link?, switch? }
+   */
+  async setMenu(items) {
+    return this.api('/v2/menu', {
+      method: 'PUT',
+      body: { menu: { items } },
+    })
+  }
+
+  // ---- 指令面板（c2c/group/channel/dm 场景）----
+  // 参考：https://bot.q.qq.com/wiki/develop/api-v2/server-inter/menu-panel/
+  //       https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_panels.post.html
+
+  /** 查询指令面板列表（按场景筛选） */
+  async listPanels(scope) {
+    const query = scope ? `?scope=${encodeURIComponent(scope)}` : ''
+    return this.api(`/v2/panels${query}`, { method: 'GET' })
+  }
+
+  /**
+   * 创建指令面板
+   * @param {object} body { scope, target_type?, user_openids?, group_openids?, panel: { items, remark?, version? } }
+   * @returns {Promise<{panel_id: string}>}
+   */
+  async createPanel(body) {
+    return this.api('/v2/panels', { method: 'POST', body })
+  }
+
+  /** 查询指令面板详情 */
+  async getPanel(panelId) {
+    return this.api(`/v2/panels/${encodeURIComponent(panelId)}`, { method: 'GET' })
+  }
+
+  /** 修改指令面板 */
+  async updatePanel(panelId, body) {
+    return this.api(`/v2/panels/${encodeURIComponent(panelId)}`, { method: 'PUT', body })
+  }
+
+  /** 删除指令面板 */
+  async deletePanel(panelId) {
+    return this.api(`/v2/panels/${encodeURIComponent(panelId)}`, { method: 'DELETE' })
+  }
+
+  /** 修改指令面板关联对象（增删指定用户/群） */
+  async updatePanelTarget(panelId, body) {
+    return this.api(`/v2/panels/${encodeURIComponent(panelId)}/target`, { method: 'PUT', body })
+  }
+
   setCredentials(values = {}) {
     for (const key of ['appId', 'clientSecret', 'accessToken', 'accessTokenExpiresAt', 'gatewayUrl', 'intents']) {
       if (values[key] !== undefined) this.config[key] = values[key]

package/lib/qq/index.js

@@ -42,6 +42,16 @@ export class QqService extends Platform {
     // 挂到 ctx 供会话节点读取
     try { ctx.qq = this.gateway } catch { /* 挂载失败不致命 */ }
 
+    // 网关连接成功后自动配置指令面板与自定义菜单（一次性）
+    this._panelSetupDone = false
+    try {
+      ctx.on?.('qq/status', (status) => {
+        if (status === 'connected') {
+          void this._ensurePanelSetup().catch(() => {})
+        }
+      })
+    } catch { /* 忽略事件订阅失败 */ }
+
     this.node = new QqConversationNode(ctx, {
       allowFrom: Array.isArray(config.allowFrom) ? config.allowFrom : [],
       digestIntervalSec: config.digestIntervalSec,
@@ -79,8 +89,10 @@ export class QqService extends Platform {
     return this.gateway.sendText(peerId, text, opts)
   }
 
-  async sendTyping(peerId, state) {
-    return this.gateway.sendTyping(peerId, state)
+  async sendTyping(peerId, opts = {}) {
+    // 兼容旧调用：sendTyping(peerId, durationSeconds)
+    const normalized = typeof opts === 'number' ? { durationSeconds: opts } : opts
+    return this.gateway.sendTyping(peerId, normalized)
   }
 
   async sendMedia(peerId, media, opts = {}) {
@@ -91,8 +103,8 @@ export class QqService extends Platform {
     return this.gateway.sendMarkdown(peerId, markdown, opts)
   }
 
-  async sendKeyboard(peerId, keyboard, opts = {}) {
-    return this.gateway.sendKeyboard(peerId, keyboard, opts)
+  async sendKeyboard(peerId, content, keyboard, opts = {}) {
+    return this.gateway.sendKeyboard(peerId, content, keyboard, opts)
   }
 
   /** 合并展示状态给浏览器 UI。 */
@@ -189,6 +201,58 @@ export class QqService extends Platform {
     await this.persist({ allowFrom: clean })
   }
 
+  // ---- 指令面板 / 自定义菜单（一次性自动配置）----
+
+  /**
+   * 连接成功后自动创建 c2c + group 指令面板，并配置单聊自定义菜单。
+   * 幂等：已存在 remark 匹配的面板时跳过创建；失败仅记日志，不影响连接。
+   */
+  async _ensurePanelSetup() {
+    if (this._panelSetupDone) return
+    this._panelSetupDone = true // 防并发重复执行
+
+    const gate = this.gateway
+    const remark = PANEL_REMARK
+    const items = [
+      { name: '/new', desc: '新建对话', type: 'command' },
+      { name: '/list', desc: '查看会话列表', type: 'command' },
+      { name: '/resume', desc: '恢复会话', type: 'command' },
+      { name: '/sessions', desc: '切换会话', type: 'command' },
+      { name: '/help', desc: '命令帮助', type: 'command' },
+    ]
+
+    // 指令面板：c2c（单聊）与 group（群聊）各建一个全局面板
+    for (const scope of ['c2c', 'group']) {
+      try {
+        const list = await gate.listPanels(scope)
+        const exists = (list?.records || []).some((r) => r?.panel?.remark === remark)
+        if (!exists) {
+          const res = await gate.createPanel({
+            scope,
+            target_type: 'all',
+            panel: { items, remark, version: 1 },
+          })
+          this.logger.info('[dsh-bridge qq] created %s command panel: %s', scope, res?.panel_id ?? '(no id)')
+        }
+      } catch (err) {
+        this.logger.warn('[dsh-bridge qq] command panel setup for %s skipped: %s', scope, err?.message ?? err)
+      }
+    }
+
+    // 自定义菜单：单聊底部菜单（send_message 类型，点击自动填入命令）
+    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')
+    } catch (err) {
+      this.logger.warn('[dsh-bridge qq] custom menu setup skipped: %s', err?.message ?? err)
+    }
+  }
+
   /** 更新运行时配置并持久化。 */
   async setConfig({ digestIntervalSec, approvalTimeoutSec, maxMessageChars, sendChunkDelayMs, appId, clientSecret } = {}) {
     if (digestIntervalSec != null)   this.node.config.digestIntervalSec   = Number(digestIntervalSec)
@@ -226,3 +290,6 @@ export class QqService extends Platform {
 function gatewayMaxChars() {
   return 2000
 }
+
+// 指令面板 remark 标识，用于幂等判断（区分本插件创建的面板）
+const PANEL_REMARK = 'dsh-bridge 常用命令'

package/lib/qq/node.js

@@ -10,6 +10,73 @@ import { ConversationBridge, conversationBridgeHelpers } from '../platform/conve
 import { gatewayConstants } from './gateway.js'
 
 const MAX_MESSAGE_CHARS = gatewayConstants.MAX_MESSAGE_CHARS
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+
+// QQ 流式消息：markdown 内容每片最大长度（append 模式下每片为追加片段）
+const STREAM_CHUNK_SIZE = 400
+
+/**
+ * 将文本转成 QQ 安全 Markdown：
+ *  - 表格（| a | b | / |---|）降级为纯文本（QQ Markdown 不支持表格，会截断/报错）
+ *  - markdown 图片语法 ![alt](url) 转为链接 [alt](url)（避免图片转存失败导致整条失败）
+ *  - 代码块内容原样保留
+ */
+function sanitizeQQMarkdown(text) {
+  if (!text) return ''
+  const lines = String(text).split('\n')
+  const out = []
+  let inFence = false
+  let inTable = false
+  const isSep = (l) => /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/.test(l) && l.includes('-')
+  const isTableRow = (l) => /^\s*\|.*\|\s*$/.test(l)
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]
+    if (/^\s*```/.test(line)) {
+      inFence = !inFence
+      out.push(line)
+      continue
+    }
+    if (inFence) { out.push(line); continue }
+    const nextIsSep = i + 1 < lines.length && isSep(lines[i + 1])
+    if (isTableRow(line) && (inTable || nextIsSep)) {
+      inTable = true
+      if (!isSep(line)) {
+        // 去掉首尾 |，内部 | 转空格
+        out.push(line.replace(/^\s*\|\s*/, '').replace(/\s*\|\s*$/, '').replace(/\s*\|\s*/g, '  '))
+      }
+      continue
+    }
+    inTable = false
+    out.push(line.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '[$1]($2)'))
+  }
+  return out.join('\n')
+}
+
+/**
+ * 按段落边界切分内容（避免切断行内内容），单块时拆两片保证流式过渡
+ * @param {string} content - 要分片的内容
+ * @param {number} maxChunk - 单片最大字符数（用户配置的 maxMessageChars）
+ */
+function splitIntoChunks(content, maxChunk) {
+  const chunks = []
+  let start = 0
+  while (start < content.length) {
+    if (content.length - start <= maxChunk) { chunks.push(content.slice(start)); break }
+    const windowStart = start + Math.floor(maxChunk * 0.6)
+    const windowEnd = start + maxChunk
+    let cut = content.lastIndexOf('\n', windowEnd)
+    if (cut <= windowStart || cut === -1) cut = windowEnd
+    chunks.push(content.slice(start, cut))
+    start = cut
+  }
+  // 单块时拆两片，保证「生成中 → 生成结束」的流式过渡
+  if (chunks.length === 1 && content.length > 0) {
+    const half = Math.ceil(content.length / 2)
+    chunks.length = 0
+    chunks.push(content.slice(0, half), content.slice(half))
+  }
+  return chunks
+}
 
 // 把 QqGateway 适配为 ConversationBridge 需要的 Platform 消息接口
 function makePlatform(gateway) {
@@ -18,8 +85,9 @@ function makePlatform(gateway) {
     name: 'QQ',
     get accountId() { return gateway.accountId ?? '' },
     get capabilities() { return gateway.capabilities },
+    // sendText / sendTyping 由 QqConversationNode 覆盖，这里仅提供兜底
     sendText: (peer, text) => gateway.sendText(peer, text, {}),
-    sendTyping: (peer, opts) => gateway.sendTyping(peer, opts),
+    sendTyping: () => Promise.resolve({ ok: true }),
     sendKeyboard: (peer, content, keyboard) => gateway.sendKeyboard(peer, content, keyboard, {}),
   }
 }
@@ -44,6 +112,9 @@ export class QqConversationNode extends ConversationBridge {
     })
     this.gateway = ctx.qq
     this.lastMessageId = null // 存储最后发送的消息 ID，用于消息引用
+    // 当前对话 peer 信息（由 _handleInbound 在每次收到消息时刷新）
+    this._lastPeer = null // { peerId, scope: 'c2c'|'group' }
+    this._replyMsgId = null // 被动回复用的用户消息 ID（事件 d.id）
 
     // 订阅网关入站事件
     this.ctx.on('qq/message', (event) => {
@@ -54,15 +125,22 @@ export class QqConversationNode extends ConversationBridge {
     })
   }
 
-  // ---- 出站：覆盖 sendText，在提示消息中添加按钮 ----
+  // ---- 出站：覆盖 sendText / sendTyping，正确处理 scope 与被动回复 ----
+
+  /** 解析当前对话 peer 信息；无活动 peer 时返回 null */
+  _currentPeer() {
+    return this._lastPeer
+  }
 
   async sendText(text) {
-    const peer = this.peerId
-    if (!peer) return
-    
+    const peerInfo = this._currentPeer()
+    if (!peerInfo) return
+    const { peerId, scope } = peerInfo
+    const replyMsgId = this._replyMsgId || undefined
+
     // 检测是否是提示用户开始新会话的消息
     const isPromptMessage = text.includes('没有活动会话') || text.includes('恢复会话失败')
-    
+
     if (isPromptMessage) {
       // 发送带按钮的消息，方便用户快速操作
       const keyboard = {
@@ -80,57 +158,81 @@ export class QqConversationNode extends ConversationBridge {
           },
         ],
       }
-      const result = await this.platform.sendKeyboard(peer, text, keyboard)
-      // 保存消息 ID
-      if (result?.data?.message_id) {
-        this.lastMessageId = result.data.message_id
-      }
-      return result
+      return this.gateway.sendKeyboard(peerId, text, keyboard, { scope, msgId: replyMsgId })
     }
-    
-    // 其他消息使用流式发送
+
+    // 其他回复统一走「流式 Markdown」：content_type=markdown 让手机端渲染，append 模式逐段追加
     const content = String(text || '').trim()
     if (content.length === 0) return { success: true }
-    
-    const STREAM_CHUNK_SIZE = 200
-    
-    // 如果消息较短，直接发送普通消息
-    if (content.length <= STREAM_CHUNK_SIZE) {
-      const result = await this.gateway.sendText(peer, content, {})
-      // 保存消息 ID
-      if (result?.data?.message_id) {
-        this.lastMessageId = result.data.message_id
-      }
-      return result
-    }
-    
-    // 流式发送：把内容切分成多段
-    const chunks = []
-    for (let i = 0; i < content.length; i += STREAM_CHUNK_SIZE) {
-      chunks.push(content.slice(i, i + STREAM_CHUNK_SIZE))
-    }
-    
-    // 逐段发送流式消息
-    let firstMsgId = null
-    for (let i = 0; i < chunks.length; i++) {
-      const chunk = chunks[i]
-      const isLast = i === chunks.length - 1
-      const result = await this.gateway.sendStream(peer, chunk, {
-        msgId: firstMsgId, // 后续段关联到第一段
-        inputState: isLast ? 0 : 1, // 最后一段结束输入状态，其他段显示输入中
-      })
-      if (!firstMsgId && result?.data?.message_id) {
-        firstMsgId = result.data.message_id
-        this.lastMessageId = firstMsgId // 保存第一段消息 ID
+
+    const md = sanitizeQQMarkdown(content)
+    // 使用用户配置的 maxMessageChars（默认 2000），而非硬编码 200
+    const maxChars = this.config.maxMessageChars || 2000
+    const chunks = splitIntoChunks(md, maxChars)
+
+    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
+          streamMsgId, // 后续片携带服务端返回的 stream_msg_id
+          index: i, // 分片序号从 0 递增
+          inputState: isLast ? 10 : 1, // 1=生成中, 10=生成结束
+          inputMode: 'append', // 追加模式：服务端拼接到同一条消息
+        })
+
+        // 首片返回 stream_msg_id，后续片需携带
+        if (i === 0 && result?.id) {
+          streamMsgId = result.id
+          this.lastMessageId = result.id // 保存消息 ID 用于消息引用
+        }
+
+        if (result?.code !== undefined && result.code !== 0) {
+          throw new Error(result.message || `QQ API error ${result.code}`)
+        }
+
+        // 使用用户配置的 sendChunkDelayMs（默认 1500ms），而非硬编码 120ms
+        if (!isLast) {
+          const delayMs = this.config.sendChunkDelayMs ?? 1500
+          if (delayMs > 0) await sleep(delayMs)
+        }
       }
-      if (result?.error) {
-        return { success: false, error: result.error }
+      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)
+      try {
+        const result = await this.gateway.sendMarkdown(peerId, md, { scope, msgId: replyMsgId })
+        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) }
+        }
       }
-      // 流式发送间隔稍短，避免刷屏
-      await new Promise(resolve => setTimeout(resolve, 100))
     }
-    
-    return { success: true }
+  }
+
+  /** 发送"正在输入"状态（QQ 通过 msg_type=6 + input_notify 显示 N 秒） */
+  async sendTyping(state) {
+    const peerInfo = this._currentPeer()
+    if (!peerInfo) return
+    // state=2（停止）时无需显式结束——input_second 到期自动消失
+    if (Number(state) === 2) return { ok: true }
+    return this.gateway.sendTyping(peerInfo.peerId, {
+      scope: peerInfo.scope,
+      durationSeconds: 8,
+      msgId: this._replyMsgId || undefined,
+    })
   }
 
   // ---- 入站 ----
@@ -154,6 +256,13 @@ export class QqConversationNode extends ConversationBridge {
     // 群聊：仅在群聊 @ 机器人事件中处理（GROUP_AT_MESSAGE_CREATE 已由网关归一化）
     const isGroup = event.scope === 'group' || event.scope === 'guild'
 
+    // 记录当前 peer 信息与被动回复消息 ID（事件 d.id），供出站使用
+    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)
+    }
+
     // 检测消息引用（文本交互）：如果用户回复了机器人的消息，且当前没有活动会话或消息以 /new 开头，
     // 则自动创建新会话并发送消息
     const messageReference = event.messageReference
@@ -181,6 +290,14 @@ export class QqConversationNode extends ConversationBridge {
       return
     }
 
+    // 记录 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
+    }
+
     const data = event.data || {}
     const resolved = data.resolved || {}
     const buttonId = resolved.button_id || ''
@@ -210,4 +327,7 @@ export const qqNodeHelpers = {
   textOfAssistantMessage: conversationBridgeHelpers.textOfAssistantMessage,
   listSessions: conversationBridgeHelpers.listSessions,
   sessionsInDisplayOrder: conversationBridgeHelpers.sessionsInDisplayOrder,
+  sanitizeQQMarkdown,
+  splitIntoChunks,
+  STREAM_CHUNK_SIZE,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenbin_wb/dsh-bridge",
-  "version": "2.1.2",
+  "version": "2.2.2",
   "description": "手机扫码即可在移动端/公网继续用 DeepSeek Harness，人不在电脑前也能接着干。一键局域网二维码、Cloudflare 公网隧道、自建隧道与微信 Bot（多工作区/会话持久化/媒体/审批），无需自己搭公网服务器。",
   "type": "module",
   "main": "lib/index.js",