@wenbin_wb/dsh-bridge 2.2.8 → 2.3.0

package/lib/feishu/node.js

@@ -0,0 +1,351 @@
+// dsh-bridge Feishu / Lark conversation node
+// 把飞书 OpenAPI / WebSocket 长连接入站事件解析后交给平台无关的
+// ConversationBridge 处理，出站通过 FeishuGateway 发送文本 / 卡片。
+
+import { ConversationBridge, conversationBridgeHelpers } from '../platform/conversation-bridge.js'
+
+function makePlatform(gateway) {
+  return {
+    id: 'feishu',
+    name: 'Feishu / Lark',
+    capabilities: { supportsGroup: true, group: true, media: true, approvals: true },
+    async sendText(peerId, text, opts = {}) {
+      return gateway?.sendMarkdownCard(peerId, text, opts)
+    },
+    async sendTyping() {},
+    dispose() {},
+  }
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+function splitIntoIncremental(content, maxChunk = 150) {
+  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 > 30) {
+    const step = Math.max(20, Math.floor(content.length / 4))
+    chunks.length = 0
+    for (let i = 0; i < content.length; i += step) {
+      chunks.push(content.slice(i, Math.min(i + step, content.length)))
+    }
+  }
+  const slices = []
+  let acc = ''
+  for (const s of chunks) {
+    acc += s
+    slices.push(acc)
+  }
+  return slices
+}
+
+export class FeishuConversationNode extends ConversationBridge {
+  constructor(ctx, config, logger, { onFirstSender, onActiveSessionChange } = {}) {
+    super({
+      ctx,
+      logger,
+      config,
+      platform: makePlatform(ctx.feishu),
+      onFirstSender,
+      onActiveSessionChange,
+    })
+    this.gateway = ctx.feishu
+    this._lastPeer = null // { peerId, senderId, isGroup }
+    this._streamCardId = null // 当前轮次的流式卡片 message_id
+    this._streamContent = ''  // 当前轮次流式卡片的内容
+    this._patchTimer = null   // 节流定时器
+    this._inTurn = false
+
+    // 订阅网关入站消息事件
+    this.ctx.on('feishu/message', (event) => {
+      void this._handleInbound(event)
+    })
+
+    // 订阅卡片交互事件（审批按钮点击）
+    this.ctx.on('feishu/action', (event) => {
+      void this._handleAction(event)
+    })
+
+    // 监听轮次事件：turn/start 开启流式会话，turn/end 最终刷新并重置
+    this.ctx.on('session/event', (session, event) => {
+      if (session.id !== this.activeSessionId) return
+      if (event.type === 'turn/start') {
+        this._inTurn = true
+        this._streamCardId = null
+        this._streamContent = ''
+        if (this._patchTimer) {
+          clearTimeout(this._patchTimer)
+          this._patchTimer = null
+        }
+      } else if (event.type === 'turn/end') {
+        this._inTurn = false
+        if (this._patchTimer) {
+          clearTimeout(this._patchTimer)
+          this._patchTimer = null
+        }
+        if (this._streamCardId && this._streamContent) {
+          void this.gateway.patchCard(this._streamCardId, this._streamContent).catch(() => {})
+        }
+        this._streamCardId = null
+        this._streamContent = ''
+      }
+    })
+  }
+
+  async _handleInbound(event) {
+    const { peerId, senderId, isGroup, text } = event
+    this._lastPeer = { peerId, senderId, isGroup }
+
+    this.logger.debug?.(`[dsh-bridge feishu] handling inbound message from ${peerId} (group=${isGroup}): ${text}`)
+
+    // 如果还没有活动会话，且是首条消息，自动尝试选择最新已有会话
+    if (!this.activeSessionId) {
+      await this._pickDefaultSession().catch(() => {})
+    }
+
+    // 转交通用 ConversationBridge 路由
+    return super.handleInbound({
+      senderId: isGroup ? peerId : senderId,
+      peerId,
+      isGroup,
+      text,
+    })
+  }
+
+  async _handleAction(event) {
+    const { operatorId, value } = event
+    const approvalId = Number(value.approvalId)
+    const action = value.action
+
+    if (approvalId && (action === 'approve' || action === 'reject')) {
+      const outcome = action === 'approve' ? 'allowed-once' : 'rejected'
+      const pending = this.pending.get(approvalId)
+      if (pending) {
+        this.clearApproval(approvalId)
+        pending.resolve(outcome)
+      }
+    }
+  }
+
+  async sendText(text) {
+    const peerId = this._lastPeer?.peerId || this.peerId
+    if (!peerId) return
+    const isGroup = this._lastPeer?.isGroup ?? (peerId.startsWith('oc_') || peerId.startsWith('chat_'))
+    const content = String(text || '').trim()
+    if (!content) return
+
+    // 如果处于 Agent 生成轮次中（turn 期间）：流式打字机逐段增量更新
+    if (this._inTurn) {
+      const maxChunk = 150
+      const slices = splitIntoIncremental(content, maxChunk)
+      const delayMs = Math.min(Math.max(this.config.sendChunkDelayMs ?? 200, 100), 1000)
+
+      if (!this._streamCardId) {
+        // 首片：创建卡片并记录 message_id
+        const firstSlice = slices[0] || content
+        try {
+          const res = await this.gateway.sendMarkdownCard(peerId, firstSlice, { isGroup })
+          this._streamCardId = res?.message_id || null
+          this._streamContent = firstSlice
+        } catch (err) {
+          this.logger.warn?.('[dsh-bridge feishu] sendMarkdownCard failed, fallback to sendText:', err?.message ?? err)
+          await this.gateway.sendText(peerId, content, { isGroup })
+          return
+        }
+
+        // 后续片依次 patchCard（间隔 delayMs，呈现真实打字机流式效果）
+        for (let i = 1; i < slices.length; i++) {
+          await sleep(delayMs)
+          this._streamContent = slices[i]
+          if (this._streamCardId) {
+            await this.gateway.patchCard(this._streamCardId, this._streamContent).catch(() => {})
+          }
+        }
+      } else {
+        // 如果卡片已存在（同轮次后续输出）：更新到最终内容
+        this._streamContent = content
+        await this.gateway.patchCard(this._streamCardId, this._streamContent).catch(() => {})
+      }
+      return
+    }
+
+    // 非 turn 期间（指令响应、系统提示、单条通知等）：以完整单张卡片直接发送，杜绝碎片拆分
+    try {
+      if (content.length <= 25000) {
+        await this.gateway.sendMarkdownCard(peerId, content, { isGroup })
+      } else {
+        const chunks = conversationBridgeHelpers.splitForIM(content, 20000)
+        for (const chunk of chunks) {
+          await this.gateway.sendMarkdownCard(peerId, chunk, { isGroup })
+        }
+      }
+    } catch (err) {
+      this.logger.warn?.('[dsh-bridge feishu] sendMarkdownCard failed, fallback to plain text:', err?.message ?? err)
+      await this.gateway.sendText(peerId, content, { isGroup })
+    }
+  }
+
+  // ---- 飞书专属卡片审批桥 ----
+
+  _attachApprovalBridge() {
+    const listener = async (req, next) => {
+      if (!this.ownsAgent(req.agent)) return next?.()
+      const peer = this._lastPeer
+      if (!peer?.peerId) return next?.()
+
+      const number = this.nextApprovalNumber()
+      const timeoutSec = this.config.approvalTimeoutSec || 600
+      const timeoutMin = Math.max(1, Math.round(timeoutSec / 60))
+
+      // 构建飞书原生交互卡片 (JSON 2.0)
+      const card = {
+        schema: '2.0',
+        header: {
+          title: {
+            tag: 'plain_text',
+            content: `⚠️ 操作权限确认 (#${number})`,
+          },
+          template: 'orange',
+        },
+        body: {
+          elements: [
+            {
+              tag: 'markdown',
+              content: [
+                `| 项目 | 详情 |`,
+                `| :--- | :--- |`,
+                `| **调用工具** | \`${req.toolName}\` |`,
+                ...(req.reason ? [`| **申请原因** | ${String(req.reason).replace(/\|/g, '｜')} |`] : []),
+                `| **等待超时** | ${timeoutMin} 分钟 (超时自动拒绝) |`,
+              ].join('\n'),
+            },
+            {
+              tag: 'column_set',
+              flex_mode: 'flow',
+              columns: [
+                {
+                  tag: 'column',
+                  width: 'auto',
+                  elements: [
+                    {
+                      tag: 'button',
+                      text: {
+                        tag: 'plain_text',
+                        content: '✓ 批准执行',
+                      },
+                      type: 'primary',
+                      value: {
+                        action: 'approve',
+                        approvalId: number,
+                      },
+                    },
+                  ],
+                },
+                {
+                  tag: 'column',
+                  width: 'auto',
+                  elements: [
+                    {
+                      tag: 'button',
+                      text: {
+                        tag: 'plain_text',
+                        content: '✕ 拒绝执行',
+                      },
+                      type: 'danger',
+                      value: {
+                        action: 'reject',
+                        approvalId: number,
+                      },
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      }
+
+      // 发送飞书卡片
+      try {
+        await this.gateway.sendCard(peer.peerId, card, { isGroup: peer.isGroup })
+      } catch (err) {
+        // 卡片发送失败降级发送 Markdown
+        const textFallback = [
+          `## ⚠️ 操作权限确认 (#${number})`,
+          '',
+          `| 项目 | 详情 |`,
+          `| :--- | :--- |`,
+          `| **调用工具** | \`${req.toolName}\` |`,
+          ...(req.reason ? [`| **申请原因** | ${String(req.reason).replace(/\|/g, '｜')} |`] : []),
+          `| **等待超时** | ${timeoutMin} 分钟 (超时自动拒绝) |`,
+          '',
+          `> 回复 \`/yes\` (或 \`1\`) 批准执行`,
+          `> 回复 \`/no\` (或 \`2\`) 拒绝执行`,
+        ].join('\n')
+        void this.gateway.sendMarkdownCard(peer.peerId, textFallback, { isGroup: peer.isGroup })
+      }
+
+      // 同时调用 downstream next()，使 Web UI 原生弹窗也能同步显示并支持直接操作
+      let nextPromise = null
+      if (typeof next === 'function') {
+        try {
+          const res = next()
+          if (res && typeof res.then === 'function') {
+            nextPromise = res
+          }
+        } catch {}
+      }
+
+      let timeoutFired = false
+      let winner = 'feishu'
+      const feishuPromise = new Promise((resolve) => {
+        const timer = setTimeout(() => {
+          timeoutFired = true
+          this.clearApproval(number)
+          resolve('rejected')
+        }, timeoutSec * 1000)
+        if (typeof timer.unref === 'function') timer.unref()
+        this.registerApproval(number, { number, request: req, resolve, timer })
+      })
+
+      const outcome = await (nextPromise
+        ? Promise.race([
+            feishuPromise.then(res => { winner = 'feishu'; return res }),
+            nextPromise.then(res => { winner = 'web'; return res }),
+          ])
+        : feishuPromise)
+
+      // 如果 Web 端先决议，清除飞书端 pending 记录
+      if (winner === 'web') {
+        this.clearApproval(number)
+      }
+
+      if (!timeoutFired) {
+        const sourceHint = winner === 'web' ? '（Web 端操作）' : ''
+        const label = outcome === 'allowed-once' ? `✓ **已批准执行**${sourceHint}` : outcome === 'rejected' ? `❌ **已拒绝执行**${sourceHint}` : `**[${outcome}]**`
+        void this.gateway.sendMarkdownCard(peer.peerId, `${label}（#${number}）`, { isGroup: peer.isGroup })
+      }
+      return outcome
+    }
+
+    const disposer = this.ctx.on('approval/request', listener)
+    this.disposers.push(disposer)
+  }
+}
+
+export const feishuNodeHelpers = {
+  makePlatform,
+}

package/lib/index.js

@@ -20,6 +20,7 @@ import { CloudflaredManager } from './cloudflared-manager.mjs';
 import { PlatformManager } from './platform/manager.js';
 import { WechatService } from './wechat/index.js';
 import { QqService } from './qq/index.js';
+import { FeishuService } from './feishu/index.js';
 
 const name = 'dsh-bridge';
 // 微信 Bot 会话桥依赖 DSH 提供的会话/agent/审批/工作区/持久化服务，需显式 inject
@@ -555,6 +556,19 @@ function apply(ctx, config = {}) {
   });
   platformManager.register(qq);
 
+  // 飞书 Bot（官方 OpenAPI / WebSocket 长连接）—— 作为 Platform 子类注册进平台管理器
+  const feishu = new FeishuService({
+    ctx,
+    logger,
+    config: config.feishu ?? {},
+    onPersist: async (patch) => {
+      const stored = await loadConfig();
+      stored.feishu = { ...(stored.feishu ?? {}), ...patch };
+      await saveConfig(stored);
+    },
+  });
+  platformManager.register(feishu);
+
   // 启动时读取已保存的微信 Bot 配置（凭证 + 白名单 + 活动会话）
   loadConfig().then(async (stored) => {
     if (stored?.wechat) {
@@ -632,10 +646,46 @@ function apply(ctx, config = {}) {
     }
   }).catch(() => {});
 
+  // 启动时读取已保存的飞书 Bot 配置（凭证 + 白名单 + 活动会话）
+  loadConfig().then(async (stored) => {
+    if (stored?.feishu) {
+      const cfg = stored.feishu;
+      feishu.node.config.allowFrom = Array.isArray(cfg.allowFrom) ? cfg.allowFrom : [];
+
+      feishu.node._restoringConfig = (async () => {
+        try {
+          if (cfg.activeSessionId) {
+            feishu.node.activeSessionId = cfg.activeSessionId;
+            logger.info('dsh-bridge: restored feishu active session: %s', cfg.activeSessionId);
+          } else {
+            await feishu.node._pickDefaultSession().catch(() => {});
+          }
+        } finally {
+          feishu.node._configRestored = true;
+        }
+      })();
+
+      await feishu.node._restoringConfig;
+
+      if (cfg.appId && cfg.appSecret) {
+        feishu.gateway.updateConfig({
+          appId: cfg.appId,
+          appSecret: cfg.appSecret,
+          domain: cfg.domain || 'feishu',
+        });
+        logger.info('dsh-bridge: loaded saved feishu bot config, starting gateway');
+        await feishu.start().catch((err) => {
+          logger.error('dsh-bridge: feishu auto-start failed: %s', err?.message ?? err);
+        });
+      }
+    }
+  }).catch(() => {});
+
   const disposeRpc = installBridgeRpc(ctx, {
     service,
     wechat,
     qq,
+    feishu,
     platformManager,
     logger,
     saveCustomTunnelConfig: async (serverUrl, accessToken) => {

package/lib/platform/conversation-bridge.js

@@ -626,9 +626,9 @@ export class ConversationBridge {
 
   _attachApprovalBridge() {
     const listener = async (req, next) => {
-      if (!this.ownsAgent(req.agent)) return next()
+      if (!this.ownsAgent(req.agent)) return next?.()
       const peer = this.peerId
-      if (!peer) return next()
+      if (!peer) return next?.()
 
       const number = this.nextApprovalNumber()
       const timeoutSec = this.config.approvalTimeoutSec
@@ -636,9 +636,11 @@ export class ConversationBridge {
       const prompt = [
         `## ⚠️ 操作权限确认 (#${number})`,
         '',
-        `- **调用工具**：\`${req.toolName}\``,
-        ...(req.reason ? [`- **申请原因**：${req.reason}`] : []),
-        `- **等待超时**：${timeoutMin} 分钟内未回复将自动拒绝`,
+        '| 项目 | 详情 |',
+        '| :--- | :--- |',
+        `| **调用工具** | \`${req.toolName}\` |`,
+        ...(req.reason ? [`| **申请原因** | ${String(req.reason).replace(/\|/g, '｜')} |`] : []),
+        `| **等待超时** | ${timeoutMin} 分钟 (超时自动拒绝) |`,
         '',
         `> 回复 \`/yes\` (或 \`1\`) 批准执行`,
         `> 回复 \`/no\` (或 \`2\`) 拒绝执行`,
@@ -646,8 +648,20 @@ export class ConversationBridge {
 
       void this.sendText(prompt)
 
+      // 同时调用 downstream next()，使 Web UI 原生弹窗也能同步显示并支持直接操作
+      let nextPromise = null
+      if (typeof next === 'function') {
+        try {
+          const res = next()
+          if (res && typeof res.then === 'function') {
+            nextPromise = res
+          }
+        } catch {}
+      }
+
       let timeoutFired = false
-      const outcome = await new Promise((resolve) => {
+      let winner = 'im'
+      const imPromise = new Promise((resolve) => {
         const timer = setTimeout(() => {
           timeoutFired = true
           this.clearApproval(number)
@@ -657,9 +671,22 @@ export class ConversationBridge {
         this.registerApproval(number, { number, request: req, resolve, timer })
       })
 
+      const outcome = await (nextPromise
+        ? Promise.race([
+            imPromise.then(res => { winner = 'im'; return res }),
+            nextPromise.then(res => { winner = 'web'; return res }),
+          ])
+        : imPromise)
+
+      // 如果 Web 端先决议，清除 IM 端 pending 记录
+      if (winner === 'web') {
+        this.clearApproval(number)
+      }
+
       // 仅在非超时路径发送确认消息（超时时 resolve 已经发生在 timer 回调）
       if (!timeoutFired) {
-        const label = outcome === 'allowed-once' ? '✓ **已批准执行**' : outcome === 'rejected' ? '❌ **已拒绝执行**' : `**[${outcome}]**`
+        const sourceHint = winner === 'web' ? '（Web 端操作）' : ''
+        const label = outcome === 'allowed-once' ? `✓ **已批准执行**${sourceHint}` : outcome === 'rejected' ? `❌ **已拒绝执行**${sourceHint}` : `**[${outcome}]**`
         void this.sendText(`${label}（#${number}）`)
       }
       return outcome
@@ -827,11 +854,19 @@ async function routeCommand(node, text) {
         await node.sendText(`## 🗂️ 可用工作区\n\n> 当前没有已注册的工作区。可使用 \`/new <提示词> @<路径>\` 指定项目目录。`)
         return true
       }
-      const lines = workspaces.map((w, i) => {
-        const titleStr = w.title && w.title !== w.path ? `**${w.title}**` : `**${getWorkspaceBasename(w.path)}**`
-        return `- **[${i + 1}]** ${titleStr}\n  \`${w.path}\``
+      const rows = workspaces.map((w, i) => {
+        const titleStr = w.title && w.title !== w.path ? w.title : getWorkspaceBasename(w.path)
+        const safeTitle = titleStr.replace(/\|/g, '｜')
+        return `| **@${i + 1}** | ${safeTitle} | \`${w.path}\` |`
       })
-      await node.sendText(`## 🗂️ 可用工作区 (共 ${workspaces.length} 个)\n\n> 新建会话：发送 \`/new <提示词> @序号\`\n\n${lines.join('\n')}`)
+      await node.sendText([
+        `## 🗂️ 可用工作区 (共 ${workspaces.length} 个)`,
+        `> 新建会话：发送 \`/new <提示词> @序号\` 或 \`/new <提示词> @路径\``,
+        '',
+        '| 序号 | 工作区名称 | 目录路径 |',
+        '| :--- | :--- | :--- |',
+        ...rows,
+      ].join('\n'))
       return true
     }
     case 'new': {
@@ -901,10 +936,23 @@ async function routeCommand(node, text) {
       const lastTurn = [...(session.events ?? [])].reverse().find((e) => e.type === 'turn/end')
       const reason = lastTurn ? describeTurnEnd(lastTurn.data.reason) : '尚未运行'
       const title = session.title || (session.events ? sessionLabel(session) : '')
-      const titleLine = title ? `\n- **会话标题**：${title}` : ''
-      const cwdLine = session.header?.cwd ? `\n- **工作区**：\`${session.header.cwd}\`` : ''
+      const shortId = fmtSessionId(session.id)
+      const cwd = session.header?.cwd || node.config?.cwd || ''
 
-      await node.sendText(`## 📊 Agent 状态看板\n\n- **会话 ID**：\`${session.id}\`${titleLine}${cwdLine}\n- **Agent 状态**：${status}\n- **累计事件**：${session.seq ?? 0} 条\n- **最近执行**：${reason}`)
+      const content = [
+        `## 📊 Agent 状态看板`,
+        '',
+        '| 属性 | 当前状态 / 参数 |',
+        '| :--- | :--- |',
+        `| **会话 ID** | \`${shortId}\` |`,
+        ...(title ? [`| **会话标题** | ${title.replace(/\|/g, '｜')} |`] : []),
+        ...(cwd ? [`| **工作区** | \`${cwd}\` |`] : []),
+        `| **Agent 状态** | ${status} |`,
+        `| **累计事件** | ${session.seq ?? 0} 条 |`,
+        `| **最近执行** | ${reason} |`,
+      ].join('\n')
+
+      await node.sendText(content)
       return true
     }
     case 'start': // 别名：首次扫码自动开始一个会话
@@ -949,22 +997,21 @@ async function renderSessions(node) {
   let idx = 0
   for (const [cwd, sessions] of sortedGroups) {
     const groupName = cwd === '(未指定)' ? '📁 未指定工作区' : `📁 **${getWorkspaceBasename(cwd)}**`
-    const pathDetail = cwd === '(未指定)' ? '' : ` \`${cwd}\``
-    parts.push(`${groupName}${pathDetail}`)
-    parts.push('') // 空行：QQ 规定列表前必须空行
+    parts.push(groupName)
+    parts.push('')
+    parts.push('| 序号 | 会话标题 / 摘要 | 时间 | 状态 |')
+    parts.push('| :--- | :--- | :--- | :--- |')
     for (const session of sessions.slice(0, 20)) {
       idx += 1
       const isActive = session.id === node.activeSessionId
-      const activeTag = isActive ? ' `[当前]`' : ''
-      const title = session.title || (session.events ? sessionLabel(session) : '')
-      const label = title || fmtSessionId(session.id)
-      const when = session.createdAt ? fmtTime(session.createdAt) : ''
-      const timeStr = when ? ` · ${when}` : ''
-      parts.push(`- **#${idx}** ${label}${activeTag}`)
-      parts.push(`  \`${fmtSessionId(session.id)}\`${timeStr}`)
+      const statusTag = isActive ? '`[当前]`' : '-'
+      const rawTitle = session.title || (session.events ? sessionLabel(session) : '')
+      const safeTitle = (rawTitle || '新会话 (待输入)').replace(/\|/g, '｜').replace(/\r?\n/g, ' ')
+      const when = session.createdAt ? fmtTime(session.createdAt) : '-'
+      parts.push(`| **#${idx}** | ${safeTitle} | ${when} | ${statusTag} |`)
     }
     if (sessions.length > 20) {
-      parts.push(`  *…该工作区共 ${sessions.length} 个会话*`)
+      parts.push(`*…该工作区共 ${sessions.length} 个会话，仅显示前 20 个*`)
     }
     parts.push('')
   }
@@ -1009,26 +1056,28 @@ function helpText() {
   return [
     '## 🤖 常用指令帮助',
     '',
-    '**💬 会话控制**',
-    '',
-    '- `/sessions` (或 `/list`) — 查看所有会话列表',
-    '- `/use <编号>` (或 `/resume <编号>`) — 切换到指定编号会话',
-    '- `/new <提示词>` — 在当前工作区创建新会话并开始',
-    '- `/new <提示词> @序号` — 在指定工作区创建新会话（/workspaces）',
-    '- `/new <提示词> @路径` — 在指定目录路径创建新会话',
-    '- `/end` — 结束当前会话（回到无活动会话状态）',
-    '- `/stop` — 中断停止当前正在执行的任务',
-    '',
-    '**📁 环境与状态**',
-    '',
-    '- `/workspaces` — 查看已注册的工作区列表',
-    '- `/status` — 查看 Agent 运行状态与事件摘要',
-    '- `/help` — 查看此帮助菜单',
+    '### 💬 会话控制',
+    '| 指令 | 说明 | 示例 |',
+    '| :--- | :--- | :--- |',
+    '| `/sessions` | 查看所有会话表格列表 | `/sessions` 或 `/list` |',
+    '| `/use <编号>` | 切换到指定编号会话 | `/use 1` 或 `/resume 1` |',
+    '| `/new <提示词>` | 在当前工作区新建会话 | `/new 帮我写个脚本` |',
+    '| `/new <词> @N` | 在指定工作区新建会话 | `/new 帮我写个脚本 @1` |',
+    '| `/stop` | 中断停止当前正在执行的任务 | `/stop` |',
+    '| `/end` | 结束当前会话（回到空闲） | `/end` |',
     '',
-    '**🔐 权限确认**',
+    '### 📁 环境与状态',
+    '| 指令 | 说明 |',
+    '| :--- | :--- |',
+    '| `/workspaces` | 查看可用工作区表格列表 |',
+    '| `/status` | 查看 Agent 运行状态看板 |',
+    '| `/help` | 查看此帮助菜单 |',
     '',
-    '- `/yes` (或 `1`) — 批准当前工具执行请求',
-    '- `/no` (或 `2`) — 拒绝当前工具执行请求',
+    '### 🔐 权限确认',
+    '| 指令 | 快捷数字 | 说明 |',
+    '| :--- | :--- | :--- |',
+    '| `/yes` | `1` | 批准当前工具执行请求 |',
+    '| `/no` | `2` | 拒绝当前工具执行请求 |',
   ].join('\n')
 }
 

package/lib/qq/gateway.js

@@ -245,7 +245,7 @@ export class QqGateway extends Service {
         if (this.ws === ws) this.ws = null
         error ? reject(error) : resolve()
       }
-      ws.on('open', () => this.logger?.info?.('[dsh-bridge qq] gateway connected'))
+      ws.on('open', () => this.logger?.info?.('[dsh-bridge qq] WebSocket connected to QQ Open Platform'))
       ws.on('message', (raw) => {
         let payload
         try { payload = JSON.parse(String(raw)) } catch { return }