@wenbin_wb/dsh-bridge 2.3.0 → 2.3.2

package/README.en.md

@@ -246,6 +246,43 @@ Integrates Tencent's official QQ Bot platform. Supports private chat, group chat
 
 ---
 
+### Feishu / Lark Bot (Official WebSocket)
+
+Connect your enterprise self-built app via Feishu's official WebSocket protocol. Supports private chat and group mentions without public IP, domain name, or webhook configuration.
+
+**Key Highlights**
+
+- ⚡ **100% No Public IP Required**: Direct duplex WebSocket connection to Feishu Open Platform
+- 📜 **Card JSON 2.0 Streaming**: In-place single-card incremental streaming updates, eliminating message bubble fragmentation
+- 🛡️ **Card 2.0 Interactive Approvals**: Native orange approval card with `[✓ Approve]` / `[✕ Reject]` action buttons for 1-click execution
+- 📝 **Full Markdown Rendering**: Native support for headings, tables, syntax highlighting, blockquotes, and lists
+- 🔄 **Workspace & Session Management**: Table-formatted `/sessions`, `/use N` switching, and `/workspaces` listing
+
+**Setup Steps**
+
+1. Go to [Feishu Open Platform](https://open.feishu.cn/app) to create a self-built app, enable "Bot" capability, and publish a version ([Detailed Guide](docs/feishu-usage.md))
+2. Under "Events & Callbacks", select "Use WebSocket to receive events", and add `im.message.receive_v1` & `card.action.trigger`
+3. Open DSH Settings → "Remote Access" → "IM Bots" → select "Feishu"
+4. Fill in App ID and App Secret, then click "Save & Connect"
+
+**Feishu Bot Commands** (Full guide in [Feishu Bot Usage Guide](docs/feishu-usage.md))
+
+| Command | Description |
+|---------|-------------|
+| *(plain text)* | Send to current active agent |
+| `/new <prompt>` | Create and start a new session in current workspace |
+| `/new <prompt> @N` | Create a new session in workspace N |
+| `/sessions` (or `/list`) | List all sessions in a structured Markdown table |
+| `/use N` (or `/resume N`) | Switch to/resume session N |
+| `/workspaces` | List all available workspaces |
+| `/end` | End current session |
+| `/stop` | Stop currently executing task |
+| `/status` | View agent status dashboard |
+| `/yes` `/no` (or `1`/`2`) | Respond to permission approval requests (or click card buttons) |
+| `/help` | Display full command help |
+
+---
+
 ## Optional Configuration
 
 The plugin is ready to use out of the box. To customize the proxy port, add to `cordis.yml`:

package/README.md

@@ -246,6 +246,43 @@ dsh plugin --profile web add @wenbin_wb/dsh-bridge@latest
 
 ---
 
+### 飞书 Bot（官方 WebSocket 长连接）
+
+接入飞书开放平台企业自建应用，支持单聊与群聊（群聊需 @机器人）。走飞书官方最新 WebSocket 长连接协议，无需公网 IP、无需域名、免配置 Webhook。
+
+**功能亮点**
+
+- ⚡ **100% 免公网 IP**：官方 WebSocket 全双工长连接，本地电脑即可直连飞书开放平台
+- 📜 **Card JSON 2.0 原生流式打字机**：单条卡片原地增量打字机更新，彻底告别气泡拆分碎片化
+- 🛡️ **Card 2.0 交互卡片审批**：敏感操作触发审批时下发橙色告警卡片，手机/电脑端点击 `[✓ 批准执行]` / `[✕ 拒绝执行]` 按钮一键处理
+- 📝 **全量 Markdown 渲染**：支持多级标题、表格、代码高亮、引用块与列表
+- 🔄 **会话与工作区管理**：支持 `/sessions` 表格化查看、`/use N` 切换、`/workspaces` 查看工作区
+
+**使用步骤**
+
+1. 前往 [飞书开放平台](https://open.feishu.cn/app) 创建企业自建应用，开启「机器人」能力并发布版本（详见 [飞书接入指南](docs/feishu-usage.md)）
+2. 在「事件与回调」中开启「使用长连接接收事件」，添加 `im.message.receive_v1` 和 `card.action.trigger` 事件
+3. 打开 DSH 设置页「远程访问」→「IM 机器人」→ 选中「飞书」
+4. 填入 App ID 和 App Secret，点击「保存并连接」即可
+
+**飞书里的命令**（完整说明见 [飞书 Bot 使用说明](docs/feishu-usage.md)）
+
+| 命令 | 说明 |
+|------|------|
+| *(普通文本)* | 发给当前活动 agent |
+| `/new <提示词>` | 在当前工作区新建会话并开始 |
+| `/new <提示词> @N` | 在指定工作区新建会话 |
+| `/sessions`（或 `/list`） | 查看所有历史会话（结构化表格排版） |
+| `/use N`（或 `/resume N`） | 切换到会话 N |
+| `/workspaces` | 列出可用工作区 |
+| `/end` | 结束当前会话 |
+| `/stop` | 停止当前任务 |
+| `/status` | 查看 agent 状态看板 |
+| `/yes` `/no`（或 `1`/`2`） | 响应权限审批请求（或直接点击卡片按钮） |
+| `/help` | 查看全部命令 |
+
+---
+
 ## 可选配置
 
 插件开箱即用，无需配置。如需修改代理端口，在 cordis.yml 中添加：

package/client/client.js

@@ -723,6 +723,44 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
           },
           title: "\u6E05\u9664\u767B\u5F55\u51ED\u8BC1\uFF0C\u4E0B\u6B21\u9700\u91CD\u65B0\u914D\u7F6E"
         }, "\u89E3\u7ED1\u8D26\u53F7")
+      ),
+      // 飞书专属：手机扫码直达 Bot 对话
+      platformId === "feishu" && platform.botQr && React.createElement(
+        "div",
+        {
+          style: {
+            marginTop: 12,
+            padding: 12,
+            background: "var(--dsw-alias-bg-layer-1,#ffffff)",
+            border: "1px solid var(--dsw-alias-border-l2,#e5e7eb)",
+            borderRadius: 8,
+            display: "flex",
+            gap: 14,
+            alignItems: "center",
+            flexWrap: "wrap"
+          }
+        },
+        React.createElement("img", { src: platform.botQr, alt: "Feishu Bot QR", style: { width: 110, height: 110, borderRadius: 8, border: "1px solid var(--dsw-alias-border-l2,#e5e7eb)", padding: 4, background: "#fff" } }),
+        React.createElement(
+          "div",
+          { style: { flex: 1, minWidth: 160 } },
+          React.createElement("div", { style: { ...s.label, fontSize: 13, fontWeight: 600 } }, "\u{1F4F1} \u624B\u673A\u98DE\u4E66\u626B\u7801\u76F4\u8FBE\u5BF9\u8BDD"),
+          React.createElement(
+            "div",
+            { style: { ...s.muted, fontSize: 12, marginTop: 4, lineHeight: 1.5 } },
+            "\u7528\u98DE\u4E66\u624B\u673A App \u626B\u63CF\u5DE6\u4FA7\u4E8C\u7EF4\u7801\uFF0C\u7ACB\u5373\u6253\u5F00\u4E0E Bot \u5BF9\u8BDD\uFF1B\u53D1\u9001\u9996\u6761\u6D88\u606F\u81EA\u52A8\u5B8C\u6210\u767D\u540D\u5355\u6388\u6743\u3002"
+          ),
+          platform.botLink && React.createElement(
+            "div",
+            { style: { display: "flex", gap: 8, marginTop: 8 } },
+            React.createElement("a", {
+              href: platform.botLink,
+              target: "_blank",
+              rel: "noopener noreferrer",
+              style: { ...s.btnGhost, textDecoration: "none", display: "inline-flex", alignItems: "center", gap: 4, padding: "4px 10px", fontSize: 12 }
+            }, "\u5728\u98DE\u4E66\u5BA2\u6237\u7AEF\u6253\u5F00 \u2197")
+          )
+        )
       )
     ),
     // 未配置 / 登录中：表单（QQ / 飞书）或二维码（微信）
@@ -742,6 +780,23 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
       ) : platformId === "qq" || platformId === "feishu" ? React.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 10, marginTop: 4 } },
+        platformId === "feishu" && React.createElement(
+          "div",
+          {
+            style: {
+              background: "var(--dsw-alias-bg-layer-1,#ffffff)",
+              border: "1px dashed var(--dsw-alias-border-l2,#e5e7eb)",
+              borderRadius: 6,
+              padding: "8px 10px",
+              fontSize: 12,
+              lineHeight: 1.5
+            }
+          },
+          React.createElement("span", { style: s.label }, "\u{1F4A1} \u626B\u7801\u81EA\u52A8\u521B\u5EFA\u5F15\u5BFC\uFF1A"),
+          React.createElement("span", { style: s.muted }, " \u53EF\u5728\u7EC8\u7AEF\u8FD0\u884C "),
+          React.createElement("code", { style: { ...s.code, fontSize: 11, background: "var(--dsw-alias-bg-layer-2,#f3f4f6)", padding: "2px 4px", borderRadius: 4 } }, "npx feishu-bot-bootstrap"),
+          React.createElement("span", { style: s.muted }, " \u624B\u673A\u626B\u7801\u4E00\u952E\u81EA\u52A8\u521B\u5EFA\u5E94\u7528\u5E76\u8F93\u51FA\u51ED\u8BC1\uFF1B\u6216\u5728\u4E0B\u65B9\u624B\u52A8\u586B\u5165\u51ED\u8BC1\u3002")
+        ),
         React.createElement(
           "div",
           null,

package/client/index.js

@@ -643,6 +643,36 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
           title: '清除登录凭证，下次需重新配置',
         }, '解绑账号'),
       ),
+      // 飞书专属：手机扫码直达 Bot 对话
+      platformId === 'feishu' && platform.botQr && React.createElement('div', {
+        style: {
+          marginTop: 12,
+          padding: 12,
+          background: 'var(--dsw-alias-bg-layer-1,#ffffff)',
+          border: '1px solid var(--dsw-alias-border-l2,#e5e7eb)',
+          borderRadius: 8,
+          display: 'flex',
+          gap: 14,
+          alignItems: 'center',
+          flexWrap: 'wrap',
+        },
+      },
+        React.createElement('img', { src: platform.botQr, alt: 'Feishu Bot QR', style: { width: 110, height: 110, borderRadius: 8, border: '1px solid var(--dsw-alias-border-l2,#e5e7eb)', padding: 4, background: '#fff' } }),
+        React.createElement('div', { style: { flex: 1, minWidth: 160 } },
+          React.createElement('div', { style: { ...s.label, fontSize: 13, fontWeight: 600 } }, '📱 手机飞书扫码直达对话'),
+          React.createElement('div', { style: { ...s.muted, fontSize: 12, marginTop: 4, lineHeight: 1.5 } },
+            '用飞书手机 App 扫描左侧二维码，立即打开与 Bot 对话；发送首条消息自动完成白名单授权。'
+          ),
+          platform.botLink && React.createElement('div', { style: { display: 'flex', gap: 8, marginTop: 8 } },
+            React.createElement('a', {
+              href: platform.botLink,
+              target: '_blank',
+              rel: 'noopener noreferrer',
+              style: { ...s.btnGhost, textDecoration: 'none', display: 'inline-flex', alignItems: 'center', gap: 4, padding: '4px 10px', fontSize: 12 },
+            }, '在飞书客户端打开 ↗'),
+          ),
+        ),
+      ),
     ),
 
     // 未配置 / 登录中：表单（QQ / 飞书）或二维码（微信）
@@ -659,6 +689,21 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
           )
         : (platformId === 'qq' || platformId === 'feishu')
           ? React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 10, marginTop: 4 } },
+              platformId === 'feishu' && React.createElement('div', {
+                style: {
+                  background: 'var(--dsw-alias-bg-layer-1,#ffffff)',
+                  border: '1px dashed var(--dsw-alias-border-l2,#e5e7eb)',
+                  borderRadius: 6,
+                  padding: '8px 10px',
+                  fontSize: 12,
+                  lineHeight: 1.5,
+                },
+              },
+                React.createElement('span', { style: s.label }, '💡 扫码自动创建引导：'),
+                React.createElement('span', { style: s.muted }, ' 可在终端运行 '),
+                React.createElement('code', { style: { ...s.code, fontSize: 11, background: 'var(--dsw-alias-bg-layer-2,#f3f4f6)', padding: '2px 4px', borderRadius: 4 } }, 'npx feishu-bot-bootstrap'),
+                React.createElement('span', { style: s.muted }, ' 手机扫码一键自动创建应用并输出凭证；或在下方手动填入凭证。')
+              ),
               React.createElement('div', null,
                 React.createElement('div', { style: { ...s.muted, marginBottom: 4 } },
                   platformId === 'qq' ? 'AppID — QQ 开放平台机器人应用 ID' : 'App ID — 飞书开放平台自建应用 ID (cli_xxx)'

package/lib/feishu/gateway.js

@@ -69,12 +69,22 @@ export class FeishuGateway extends Service {
         const isLark = this.config.domain === 'lark'
         const domain = isLark ? Lark.Domain.Lark : Lark.Domain.Feishu
 
+        const sdkLogger = {
+          debug: (...args) => this.logger?.debug?.('[lark-sdk debug]', ...args),
+          info: (...args) => this.logger?.debug?.('[lark-sdk info]', ...args),
+          warn: (...args) => this.logger?.debug?.('[lark-sdk warn]', ...args),
+          error: (...args) => this.logger?.error?.('[lark-sdk error]', ...args),
+          trace: () => {},
+        }
+
         // 1. 初始化 REST API Client
         this.client = new Lark.Client({
           appId: this.config.appId,
           appSecret: this.config.appSecret,
           domain,
           appType: Lark.AppType.SelfBuild,
+          logger: sdkLogger,
+          loggerLevel: Lark.LoggerLevel.error,
         })
 
         // 2. 初始化长连接 WSClient
@@ -82,11 +92,14 @@ export class FeishuGateway extends Service {
           appId: this.config.appId,
           appSecret: this.config.appSecret,
           domain,
+          logger: sdkLogger,
           loggerLevel: Lark.LoggerLevel.error,
         })
 
         // 3. 构建事件分发器
-        this.eventDispatcher = new Lark.EventDispatcher({})
+        this.eventDispatcher = new Lark.EventDispatcher({
+          logger: sdkLogger,
+        })
 
         // 注册接收消息事件
         this.eventDispatcher.register({
@@ -108,6 +121,9 @@ export class FeishuGateway extends Service {
           'im.message.message_read_v1': async () => {
             // 消息已读回执事件，忽略
           },
+          'im.chat.access_event.bot_p2p_chat_entered_v1': async () => {
+            // 用户进入与机器人的单聊窗口事件，忽略
+          },
         })
 
         // 4. 尝试获取机器人信息（验证凭证，非阻断）

package/lib/feishu/index.js

@@ -2,6 +2,7 @@
 // 编排 FeishuGateway（官方 OpenAPI/WSClient 网关）+ FeishuConversationNode（飞书⇄DSH 会话桥）。
 // 作为 Platform 子类，注册进 PlatformManager 统一管理。
 
+import QRCode from 'qrcode'
 import { Platform } from '../platform/base.js'
 import { FeishuGateway } from './gateway.js'
 import { FeishuConversationNode } from './node.js'
@@ -18,6 +19,7 @@ export class FeishuService extends Platform {
     super({ ctx, logger, config, onPersist })
     this.id = 'feishu'
     this.name = 'Feishu'
+    this._botQrCache = { appId: '', qr: '' }
 
     this.gateway = new FeishuGateway(ctx, {
       appId: config.appId ?? '',
@@ -125,6 +127,18 @@ export class FeishuService extends Platform {
 
   getStatus() {
     const allowFrom = [...(this.node?.config?.allowFrom ?? [])]
+    const appId = this.gateway.config.appId || ''
+    const botLink = appId ? `https://applink.feishu.cn/client/bot/open?appId=${encodeURIComponent(appId)}` : null
+    if (botLink && this._botQrCache.appId !== appId) {
+      this._botQrCache.appId = appId
+      void QRCode.toDataURL(botLink, {
+        width: 260,
+        margin: 2,
+        color: { dark: '#1F2421', light: '#FFFFFF' },
+      }).then((qr) => {
+        this._botQrCache.qr = qr
+      }).catch(() => {})
+    }
     return {
       id: this.id,
       name: this.name,
@@ -151,6 +165,8 @@ export class FeishuService extends Platform {
         domain: this.gateway.config.domain,
       },
       botInfo: this.gateway.botInfo,
+      botLink,
+      botQr: this._botQrCache.qr,
       error: this.gateway.error,
     }
   }

package/lib/platform/conversation-bridge.js

@@ -818,12 +818,13 @@ function getWorkspaceBasename(cwd) {
 
 async function routeCommand(node, text) {
   const trimmed = text.trim()
-  if (!trimmed.startsWith('/')) return false
 
   if (trimmed === '/yes' || trimmed === '/no' || /^[12]$/.test(trimmed)) {
     if (node.resolveApproval(trimmed)) return true
   }
 
+  if (!trimmed.startsWith('/')) return false
+
   const [command, ...rest] = trimmed.slice(1).split(/\s+/)
   switch (command) {
     case 'help':

package/lib/qq/node.js

@@ -205,6 +205,38 @@ export class QqConversationNode extends ConversationBridge {
       return this._sendMarkdown(peerId, text, { scope, msgId: replyMsgId, keyboard })
     }
 
+    // 审批申请：发送带「✓ 批准执行」与「✕ 拒绝执行」交互按钮的 Markdown 卡片
+    const isApprovalMessage = text.includes('操作权限确认')
+    if (isApprovalMessage) {
+      const keyboard = {
+        content: {
+          rows: [
+            {
+              buttons: [
+                {
+                  id: 'approve_yes',
+                  render_data: { label: '✓ 批准执行', visited_label: '已批准', style: 1 },
+                  action: { type: 1, permission: { type: 2 }, data: '/yes', unsupport_tips: '请升级QQ客户端后使用' },
+                },
+                {
+                  id: 'approve_no',
+                  render_data: { label: '✕ 拒绝执行', visited_label: '已拒绝', style: 0 },
+                  action: { type: 1, permission: { type: 2 }, data: '/no', unsupport_tips: '请升级QQ客户端后使用' },
+                },
+              ],
+            },
+          ],
+        },
+      }
+      return this._sendMarkdown(peerId, sanitizeQQMarkdown(text), { scope, keyboard })
+    }
+
+    // 审批决议通知（已批准/已拒绝）：直接单条 Markdown 发送，无需流式分片
+    const isResolutionMessage = text.includes('已批准执行') || text.includes('已拒绝执行')
+    if (isResolutionMessage) {
+      return this._sendMarkdown(peerId, sanitizeQQMarkdown(text), { scope })
+    }
+
     // 其他回复统一走「流式 Markdown」：content_type=markdown 让手机端渲染
     const content = String(text || '').trim()
     if (content.length === 0) return { success: true }
@@ -421,6 +453,10 @@ export class QqConversationNode extends ConversationBridge {
       await this.handleInbound({ senderId: authId, text: '/list', isGroup })
     } else if (buttonId === 'help') {
       await this.handleInbound({ senderId: authId, text: '/help', isGroup })
+    } else if (buttonId === 'approve_yes') {
+      await this.handleInbound({ senderId: authId, text: '/yes', isGroup })
+    } else if (buttonId === 'approve_no') {
+      await this.handleInbound({ senderId: authId, text: '/no', isGroup })
     } else {
       this.logger?.info?.(`[dsh-bridge qq] unknown button interaction: ${buttonId}`)
     }

package/package.json

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