@wenbin_wb/dsh-bridge 2.2.9 → 2.3.0

package/README.en.md

@@ -19,6 +19,7 @@ Seamlessly extend your local DeepSeek Harness to mobile phones, tablets, public
 - **Custom Tunnel**: Connect to your own tunnel server with a fixed domain ([Setup Guide](docs/custom-tunnel.md))
 - **WeChat Bot (ClawBot / iLink)**: Scan a QR code to log in a WeChat personal account, then chat with, control, and approve your DeepSeek Harness agents right inside WeChat. **Multi-workspace selection, restart-persistent sessions, grouped session listing with titles, media (image/file/voice) transfer, and permission approvals** — over Tencent's official iLink Bot API, no public server or tunnel required ([Usage Guide](docs/wechat-usage.md))
 - **QQ Bot (OpenAPI v2)**: Connect your QQ Bot to receive private/group messages, send Markdown, button keyboards, and rich media. **Full event coverage (C2C / GROUP_AT_MESSAGE_CREATE), auto token refresh, reconnection with backoff, message deduplication** — over Tencent's official QQ Bot OpenAPI v2 ([Usage Guide](docs/qq-usage.md))
+- **Feishu / Lark Bot (Official WebSocket)**: Connect enterprise self-built apps via Feishu's official WebSocket protocol. **No public IP / no Webhook required, Markdown table formatting, native interactive card permission approvals with 1-click button actions** ([Usage Guide](docs/feishu-usage.md))
 - **Official Brand SVG Icons**: Authentic vector brand icons for WeChat, QQ, Feishu, Telegram with real-time status indicators
 - **Fast Version Check & 1-Click Upgrade**: Dual-channel registry check (npmmirror + npmjs fallback in ~200ms) with seamless **1-click in-app upgrade**, no terminal copying required
 - **Dark Mode Support**: Deep integration with DeepSeek Harness Design Tokens (`--dsw-alias-*`), QR code background protection for safe dark mode scanning
@@ -38,7 +39,7 @@ Seamlessly extend your local DeepSeek Harness to mobile phones, tablets, public
 | **Platform Abstraction** | Platform-agnostic core (sessions / approvals / commands / digest) shared across IM channels | ✅ **Completed** (v2.0.0) |
 | **WeChat** | Chat with your Agent directly in WeChat | ✅ Supported (workspaces / persisted sessions / media / approvals) |
 | **QQ Bot** | QQ bot integration for group/private chat | ✅ **Completed** (v2.1.0) — Markdown / buttons / rich media |
-| **Feishu** | Feishu message/bot integration for workplace scenarios | Planned |
+| **Feishu** | Feishu / Lark official persistent WebSocket bot | ✅ **Completed** (v2.3.0) — No-public-IP WS / Card Approvals |
 | **Telegram** | IM channel suited for self-hosting and overseas | Planned |
 | **OpenClaw** | Connect with the OpenClaw ecosystem | Planned |
 

package/README.md

@@ -19,6 +19,7 @@
 - **自建隧道**：连接自己的隧道服务器，获得固定域名（[搭建教程](docs/custom-tunnel.md)）
 - **微信 Bot（ClawBot / iLink）**：扫码登录微信个人号后，直接在微信里对话、控制 DeepSeek Harness 的 agent。**支持多工作区选择、会话跨重启持久化、按工作区分组查看、媒体（图片/文件/语音）收发、权限审批**——走腾讯官方 iLink Bot API，无需公网（[使用说明](docs/wechat-usage.md)）
 - **QQ Bot（OpenAPI v2）**：接入 QQ 机器人，私聊/群聊接收消息，发送 Markdown、按钮键盘和富媒体。**完整事件覆盖（C2C / GROUP_AT_MESSAGE_CREATE）、Token 自动刷新、断线重连、消息去重**——走腾讯官方 QQ Bot OpenAPI v2（[使用说明](docs/qq-usage.md)）
+- **飞书 Bot（官方 WebSocket 长连接）**：接入飞书开放平台企业自建应用，私聊/群聊实时交互。**无需公网 IP / 无需 Webhook、支持飞书 Markdown 表格排版、原生交互卡片权限审批一键点击确认**——走飞书官方最新 WebSocket 长连接协议（[使用说明](docs/feishu-usage.md)）
 - **IM 官方品牌矢量图标**：微信、QQ、飞书、Telegram 官方矢量图标与状态展示，直接在聊天软件里呼唤你的 Agent
 - **极速版本检查与一键升级**：国内高速镜像（npmmirror）优先 + 官方源毫秒级双通道检查，检测到新版本支持**界面一键直接升级**，无需手动打开终端
 - **深色模式深度适配**：完美适配 DeepSeek Harness 设计系统明暗主题切换，二维码自带白底安全垫，暗光下手机扫码 100% 极速识别
@@ -38,7 +39,7 @@
 | **平台抽象层** | 平台无关的核心（会话/审批/命令/digest）跨 IM 渠道复用 | ✅ **已完成**（v2.0.0） |
 | **微信** | 在微信里直接与你的 Agent 对话 | ✅ 已支持（多工作区 / 会话持久化 / 媒体 / 审批） |
 | **QQ Bot** | 接入 QQ 机器人，群聊/私聊唤起 Agent | ✅ **已完成**（v2.1.0）— Markdown / 按钮 / 富媒体 |
-| **飞书** | 飞书消息/机器人集成，办公场景直接调用 | 规划中 |
+| **飞书** | 飞书开放平台长连接机器人，办公场景直接调用 | ✅ **已完成**（v2.3.0）— 免公网 WS / 卡片审批 |
 | **Telegram** | 适合自托管与海外的 IM 渠道 | 规划中 |
 | **OpenClaw** | 与 OpenClaw 生态打通 | 规划中 |
 

package/client/client.js

@@ -425,7 +425,9 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
         sendChunkDelayMs: String(platform.config.sendChunkDelayMs ?? 1500),
         appId: platform.config.appId ?? "",
         // Secret 不由后端回传；空值表示沿用已保存密钥
-        clientSecret: ""
+        clientSecret: "",
+        appSecret: "",
+        domain: platform.config.domain ?? "feishu"
       });
     }
   }, [platform?.config]);
@@ -501,10 +503,14 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
     if (platformId === "qq") {
       payload.appId = cfgDraft.appId.trim();
       payload.clientSecret = cfgDraft.clientSecret.trim();
+    } else if (platformId === "feishu") {
+      payload.appId = cfgDraft.appId.trim();
+      payload.appSecret = cfgDraft.appSecret.trim();
+      payload.domain = cfgDraft.domain || "feishu";
     }
     await act(BRIDGE_ENDPOINTS.platformSetConfig, payload);
   }, [act, cfgDraft, platformId]);
-  const cfgDirty = cfgDraft && platform?.config && (Number(cfgDraft.digestIntervalSec) !== platform.config.digestIntervalSec || Number(cfgDraft.approvalTimeoutSec) !== platform.config.approvalTimeoutSec || Number(cfgDraft.maxMessageChars) !== platform.config.maxMessageChars || Number(cfgDraft.sendChunkDelayMs) !== platform.config.sendChunkDelayMs || platformId === "qq" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.clientSecret !== (platform.config.clientSecret ?? "")));
+  const cfgDirty = cfgDraft && platform?.config && (Number(cfgDraft.digestIntervalSec) !== platform.config.digestIntervalSec || Number(cfgDraft.approvalTimeoutSec) !== platform.config.approvalTimeoutSec || Number(cfgDraft.maxMessageChars) !== platform.config.maxMessageChars || Number(cfgDraft.sendChunkDelayMs) !== platform.config.sendChunkDelayMs || platformId === "qq" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.clientSecret !== (platform.config.clientSecret ?? "")) || platformId === "feishu" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.appSecret !== (platform.config.appSecret ?? "")));
   if (!platform && !err) {
     return React.createElement(
       "div",
@@ -561,6 +567,18 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
         rel: "noopener noreferrer",
         style: s.btnGhost
       }, "\u{1F310} QQ \u5F00\u653E\u5E73\u53F0"),
+      platformId === "feishu" && React.createElement("a", {
+        href: "https://github.com/wenbin-wb/dsh-bridge/blob/main/docs/feishu-usage.md",
+        target: "_blank",
+        rel: "noopener noreferrer",
+        style: s.btnGhost
+      }, "\u{1F4D6} \u98DE\u4E66\u4F7F\u7528\u8BF4\u660E"),
+      platformId === "feishu" && React.createElement("a", {
+        href: "https://open.feishu.cn/app",
+        target: "_blank",
+        rel: "noopener noreferrer",
+        style: s.btnGhost
+      }, "\u{1F310} \u98DE\u4E66\u5F00\u653E\u5E73\u53F0"),
       React.createElement("button", {
         style: s.btnGhost,
         onClick: () => setShowHelp((v) => !v)
@@ -695,19 +713,19 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
       React.createElement(
         "div",
         { style: { display: "flex", gap: 8, marginTop: 10, flexWrap: "wrap", alignItems: "center" } },
-        platform.status !== "connected" && platform.status !== "starting" && React.createElement("button", { style: s.btnPri, onClick: onLogin, disabled: busy }, "\u91CD\u65B0\u767B\u5F55"),
+        platform.status !== "connected" && platform.status !== "starting" && React.createElement("button", { style: s.btnPri, onClick: onLogin, disabled: busy }, "\u91CD\u65B0\u8FDE\u63A5"),
         (platform.status === "connected" || platform.status === "starting") && React.createElement("button", { style: s.btnGhost, onClick: onStop, disabled: busy }, "\u65AD\u5F00"),
         React.createElement("button", {
           style: { ...s.btnGhost, color: "var(--dsw-alias-state-error-primary,#dc2626)", borderColor: "var(--dsw-alias-state-error-primary,#dc2626)", opacity: busy ? 0.5 : 1 },
           disabled: busy,
           onClick: () => {
-            if (window.confirm("\u786E\u8BA4\u89E3\u7ED1\uFF1F\u8FD9\u5C06\u6E05\u9664\u767B\u5F55\u51ED\u8BC1\uFF0C\u4E0B\u6B21\u9700\u91CD\u65B0\u767B\u5F55\u3002")) act(BRIDGE_ENDPOINTS.platformUnbind, {});
+            if (window.confirm("\u786E\u8BA4\u89E3\u7ED1\uFF1F\u8FD9\u5C06\u6E05\u9664\u4FDD\u5B58\u7684\u51ED\u8BC1\u3002")) act(BRIDGE_ENDPOINTS.platformUnbind, {});
           },
-          title: "\u6E05\u9664\u767B\u5F55\u51ED\u8BC1\uFF0C\u4E0B\u6B21\u9700\u91CD\u65B0\u767B\u5F55"
+          title: "\u6E05\u9664\u767B\u5F55\u51ED\u8BC1\uFF0C\u4E0B\u6B21\u9700\u91CD\u65B0\u914D\u7F6E"
         }, "\u89E3\u7ED1\u8D26\u53F7")
       )
     ),
-    // 未配置 / 登录中：二维码（QQ 无二维码，显示凭证表单）
+    // 未配置 / 登录中：表单（QQ / 飞书）或二维码（微信）
     (!platform?.configured || showQr) && React.createElement(
       "div",
       { style: s.block },
@@ -721,39 +739,41 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
           login.phase === "scaned" ? "\u5DF2\u626B\u7801\uFF0C\u8BF7\u5728\u624B\u673A\u4E0A\u786E\u8BA4\u2026" : platformId === "wechat" ? "\u8BF7\u4F7F\u7528\u5FAE\u4FE1\u626B\u7801\u767B\u5F55\uFF08ClawBot\uFF09" : "\u8BF7\u626B\u7801\u767B\u5F55"
         ),
         login.error && React.createElement("div", { style: { ...s.muted, marginTop: 4, color: "var(--dsw-alias-state-warn-primary,#92400e)" } }, login.error)
-      ) : platformId === "qq" ? React.createElement(
+      ) : platformId === "qq" || platformId === "feishu" ? React.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 10, marginTop: 4 } },
         React.createElement(
           "div",
           null,
-          React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "AppID \u2014 QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u5E94\u7528 ID"),
+          React.createElement(
+            "div",
+            { style: { ...s.muted, marginBottom: 4 } },
+            platformId === "qq" ? "AppID \u2014 QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u5E94\u7528 ID" : "App ID \u2014 \u98DE\u4E66\u5F00\u653E\u5E73\u53F0\u81EA\u5EFA\u5E94\u7528 ID (cli_xxx)"
+          ),
           React.createElement("input", {
             style: { ...s.input, width: "100%" },
-            placeholder: "\u8BF7\u8F93\u5165 AppID",
+            placeholder: platformId === "qq" ? "\u8BF7\u8F93\u5165 AppID" : "\u8BF7\u8F93\u5165 App ID (\u5982 cli_a1b2c3d4...)",
             value: cfgDraft?.appId ?? "",
-            onChange: (e) => setCfgDraft((d) => ({ ...d, appId: e.target.value })),
-            onKeyDown: (e) => {
-              if (e.key === "Enter" && cfgDraft?.appId?.trim() && cfgDraft?.clientSecret?.trim() && !busy) saveConfig();
-            }
+            onChange: (e) => setCfgDraft((d) => ({ ...d, appId: e.target.value }))
           })
         ),
         React.createElement(
           "div",
           null,
-          React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "ClientSecret \u2014 QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u5BC6\u94A5"),
+          React.createElement(
+            "div",
+            { style: { ...s.muted, marginBottom: 4 } },
+            platformId === "qq" ? "ClientSecret \u2014 QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u5BC6\u94A5" : "App Secret \u2014 \u98DE\u4E66\u5F00\u653E\u5E73\u53F0\u5E94\u7528\u5BC6\u94A5"
+          ),
           React.createElement(
             "div",
             { style: { display: "flex", gap: 6, alignItems: "center" } },
             React.createElement("input", {
               style: { ...s.input, flex: 1 },
               type: showSecret ? "text" : "password",
-              placeholder: "\u8BF7\u8F93\u5165 ClientSecret",
-              value: cfgDraft?.clientSecret ?? "",
-              onChange: (e) => setCfgDraft((d) => ({ ...d, clientSecret: e.target.value })),
-              onKeyDown: (e) => {
-                if (e.key === "Enter" && cfgDraft?.appId?.trim() && cfgDraft?.clientSecret?.trim() && !busy) saveConfig();
-              }
+              placeholder: platformId === "qq" ? "\u8BF7\u8F93\u5165 ClientSecret" : "\u8BF7\u8F93\u5165 App Secret",
+              value: platformId === "qq" ? cfgDraft?.clientSecret ?? "" : cfgDraft?.appSecret ?? "",
+              onChange: (e) => setCfgDraft((d) => platformId === "qq" ? { ...d, clientSecret: e.target.value } : { ...d, appSecret: e.target.value })
             }),
             React.createElement("button", {
               style: { ...s.btnGhost, height: 32, padding: "0 10px", fontSize: 13, flexShrink: 0 },
@@ -767,11 +787,11 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
           "div",
           null,
           React.createElement("a", {
-            href: "https://bot.q.qq.com/wiki/develop/api-v2/",
+            href: platformId === "qq" ? "https://bot.q.qq.com/wiki/develop/api-v2/" : "https://open.feishu.cn/app",
             target: "_blank",
             rel: "noopener noreferrer",
             style: s.btnLink
-          }, "\u{1F4D6} \u524D\u5F80 QQ \u5F00\u653E\u5E73\u53F0\u7533\u8BF7\u673A\u5668\u4EBA")
+          }, platformId === "qq" ? "\u{1F4D6} \u524D\u5F80 QQ \u5F00\u653E\u5E73\u53F0\u7533\u8BF7\u673A\u5668\u4EBA" : "\u{1F4D6} \u524D\u5F80\u98DE\u4E66\u5F00\u653E\u5E73\u53F0\u521B\u5EFA\u4F01\u4E1A\u81EA\u5EFA\u5E94\u7528")
         ),
         React.createElement(
           "div",
@@ -779,7 +799,7 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
           React.createElement("button", {
             style: { ...s.btnPri, opacity: busy ? 0.5 : 1 },
             onClick: saveConfig,
-            disabled: busy || !cfgDraft?.appId?.trim() || !cfgDraft?.clientSecret?.trim()
+            disabled: busy || !cfgDraft?.appId?.trim() || (platformId === "qq" ? !cfgDraft?.clientSecret?.trim() : !cfgDraft?.appSecret?.trim())
           }, busy ? "\u4FDD\u5B58\u4E2D\u2026" : "\u4FDD\u5B58\u5E76\u8FDE\u63A5"),
           login.phase === "error" && React.createElement("div", { style: { ...s.muted, fontSize: 12 } }, login.error ?? "\u8FDE\u63A5\u5931\u8D25")
         )
@@ -794,138 +814,6 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
         login.phase === "error" && React.createElement("div", { style: { ...s.muted, fontSize: 12 } }, login.error ?? "\u767B\u5F55\u5931\u8D25")
       )
     ),
-    // 高级设置（紧凑 2x2 网格 + 恢复默认值）
-    cfgDraft && React.createElement(
-      "div",
-      { style: s.block },
-      React.createElement("button", {
-        style: { ...s.btnLink, fontSize: 12, marginBottom: showAdvanced ? 10 : 0 },
-        onClick: () => setShowAdvanced((v) => !v)
-      }, showAdvanced ? "\u25BE \u9AD8\u7EA7\u8BBE\u7F6E" : "\u25B8 \u9AD8\u7EA7\u8BBE\u7F6E"),
-      showAdvanced && React.createElement(
-        "div",
-        { style: { display: "flex", flexDirection: "column", gap: 10 } },
-        // 2x2 参数网格
-        React.createElement(
-          "div",
-          {
-            style: {
-              display: "grid",
-              gridTemplateColumns: "repeat(auto-fit, minmax(200px, 1fr))",
-              gap: 10
-            }
-          },
-          // 心跳间隔
-          React.createElement(
-            "div",
-            null,
-            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u5FC3\u8DF3\u8FDB\u5EA6\u95F4\u9694 (\u79D2)"),
-            React.createElement("input", {
-              style: { ...s.input, width: "100%" },
-              type: "number",
-              min: 30,
-              max: 3600,
-              value: cfgDraft.digestIntervalSec,
-              onChange: (e) => setCfgDraft((d) => ({ ...d, digestIntervalSec: e.target.value }))
-            })
-          ),
-          // 审批超时
-          React.createElement(
-            "div",
-            null,
-            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u5BA1\u6279\u8D85\u65F6\u81EA\u52A8\u62D2\u7EDD (\u79D2)"),
-            React.createElement("input", {
-              style: { ...s.input, width: "100%" },
-              type: "number",
-              min: 30,
-              max: 86400,
-              value: cfgDraft.approvalTimeoutSec,
-              onChange: (e) => setCfgDraft((d) => ({ ...d, approvalTimeoutSec: e.target.value }))
-            })
-          ),
-          // 每气泡字数
-          React.createElement(
-            "div",
-            null,
-            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u5355\u6761\u6700\u5927\u5B57\u6570\u9650\u5236 (\u5B57)"),
-            React.createElement("input", {
-              style: { ...s.input, width: "100%" },
-              type: "number",
-              min: 100,
-              max: 1e4,
-              value: cfgDraft.maxMessageChars,
-              onChange: (e) => setCfgDraft((d) => ({ ...d, maxMessageChars: e.target.value }))
-            })
-          ),
-          // 分块延迟
-          React.createElement(
-            "div",
-            null,
-            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u5206\u5757\u53D1\u9001\u5EF6\u8FDF (\u6BEB\u79D2)"),
-            React.createElement("input", {
-              style: { ...s.input, width: "100%" },
-              type: "number",
-              min: 0,
-              max: 1e4,
-              value: cfgDraft.sendChunkDelayMs,
-              onChange: (e) => setCfgDraft((d) => ({ ...d, sendChunkDelayMs: e.target.value }))
-            })
-          )
-        ),
-        // QQ 平台凭证
-        platformId === "qq" && React.createElement(
-          "div",
-          { style: { display: "flex", flexDirection: "column", gap: 10, marginTop: 4 } },
-          React.createElement(
-            "div",
-            null,
-            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "AppID \u2014 QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u5E94\u7528 ID"),
-            React.createElement("input", {
-              style: { ...s.input, width: "100%" },
-              placeholder: "\u8BF7\u8F93\u5165 AppID",
-              value: cfgDraft.appId,
-              onChange: (e) => setCfgDraft((d) => ({ ...d, appId: e.target.value }))
-            })
-          ),
-          React.createElement(
-            "div",
-            null,
-            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "ClientSecret \u2014 QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u5BC6\u94A5\uFF08\u7559\u7A7A\u5219\u4FDD\u6301\u5DF2\u4FDD\u5B58\u5BC6\u94A5\uFF09"),
-            React.createElement(
-              "div",
-              { style: { display: "flex", gap: 6, alignItems: "center" } },
-              React.createElement("input", {
-                style: { ...s.input, flex: 1 },
-                type: showSecret ? "text" : "password",
-                placeholder: "\u7559\u7A7A\u4FDD\u6301\u5DF2\u4FDD\u5B58\u5BC6\u94A5",
-                value: cfgDraft.clientSecret,
-                onChange: (e) => setCfgDraft((d) => ({ ...d, clientSecret: e.target.value }))
-              }),
-              React.createElement("button", {
-                style: { ...s.btnGhost, height: 32, padding: "0 10px", fontSize: 13, flexShrink: 0 },
-                onClick: () => setShowSecret((v) => !v),
-                type: "button",
-                title: showSecret ? "\u9690\u85CF\u5BC6\u94A5" : "\u663E\u793A\u660E\u6587"
-              }, showSecret ? "\u{1F648} \u9690\u85CF" : "\u{1F441}\uFE0F \u663E\u793A")
-            )
-          )
-        ),
-        React.createElement(
-          "div",
-          { style: { display: "flex", gap: 8, alignItems: "center", marginTop: 4 } },
-          React.createElement("button", {
-            style: { ...s.btnPri, opacity: cfgDirty && !busy ? 1 : 0.5 },
-            disabled: !cfgDirty || busy,
-            onClick: saveConfig
-          }, busy ? "\u4FDD\u5B58\u4E2D\u2026" : "\u4FDD\u5B58\u8BBE\u7F6E"),
-          React.createElement("button", {
-            style: { ...s.btnGhost, height: 32, fontSize: 12 },
-            onClick: resetDefaults,
-            title: "\u6062\u590D\u63A8\u8350\u9ED8\u8BA4\u914D\u7F6E"
-          }, "\u21BA \u6062\u590D\u63A8\u8350\u9ED8\u8BA4")
-        )
-      )
-    ),
     React.createElement(
       "div",
       { style: s.block },
@@ -1365,7 +1253,7 @@ function BridgePanel({ rpcCall }) {
     const IM_PLATFORMS = [
       { id: "wechat", label: "\u5FAE\u4FE1", icon: Icons.wechat, brandColor: "#07C160", desc: "ClawBot \u626B\u7801\u76F4\u8FDE \xB7 \u65E0\u9700\u516C\u7F51" },
       { id: "qq", label: "QQ", icon: Icons.qq, brandColor: "#12B7F5", desc: "\u5B98\u65B9\u673A\u5668\u4EBA \xB7 \u79C1\u804A/\u7FA4\u804A/\u6309\u94AE" },
-      { id: "feishu", label: "\u98DE\u4E66", icon: Icons.feishu, brandColor: "#00D6B9", desc: "\u5B98\u65B9\u4E8B\u4EF6\u56DE\u8C03 API" },
+      { id: "feishu", label: "\u98DE\u4E66", icon: Icons.feishu, brandColor: "#00D6B9", desc: "\u5B98\u65B9 WebSocket \u957F\u8FDE\u63A5 \xB7 \u514D\u516C\u7F51" },
       { id: "telegram", label: "Telegram", icon: Icons.telegram, brandColor: "#24A1DE", desc: "\u5B98\u65B9 Bot API" }
     ];
     tabContent = React.createElement(

package/client/index.js

@@ -348,6 +348,8 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
         appId: platform.config.appId ?? '',
         // Secret 不由后端回传；空值表示沿用已保存密钥
         clientSecret: '',
+        appSecret: '',
+        domain: platform.config.domain ?? 'feishu',
       });
     }
   }, [platform?.config]);
@@ -436,10 +438,14 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
       maxMessageChars:    Number(cfgDraft.maxMessageChars),
       sendChunkDelayMs:   Number(cfgDraft.sendChunkDelayMs),
     };
-    // QQ 平台额外携带凭证
+    // QQ / 飞书 平台额外携带凭证
     if (platformId === 'qq') {
       payload.appId = cfgDraft.appId.trim();
       payload.clientSecret = cfgDraft.clientSecret.trim();
+    } else if (platformId === 'feishu') {
+      payload.appId = cfgDraft.appId.trim();
+      payload.appSecret = cfgDraft.appSecret.trim();
+      payload.domain = cfgDraft.domain || 'feishu';
     }
     await act(BRIDGE_ENDPOINTS.platformSetConfig, payload);
   }, [act, cfgDraft, platformId]);
@@ -451,6 +457,10 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
     (platformId === 'qq' && (
       cfgDraft.appId !== (platform.config.appId ?? '') ||
       cfgDraft.clientSecret !== (platform.config.clientSecret ?? '')
+    )) ||
+    (platformId === 'feishu' && (
+      cfgDraft.appId !== (platform.config.appId ?? '') ||
+      cfgDraft.appSecret !== (platform.config.appSecret ?? '')
     ))
   );
 
@@ -503,6 +513,16 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
         target: '_blank', rel: 'noopener noreferrer',
         style: s.btnGhost,
       }, '🌐 QQ 开放平台'),
+      platformId === 'feishu' && React.createElement('a', {
+        href: 'https://github.com/wenbin-wb/dsh-bridge/blob/main/docs/feishu-usage.md',
+        target: '_blank', rel: 'noopener noreferrer',
+        style: s.btnGhost,
+      }, '📖 飞书使用说明'),
+      platformId === 'feishu' && React.createElement('a', {
+        href: 'https://open.feishu.cn/app',
+        target: '_blank', rel: 'noopener noreferrer',
+        style: s.btnGhost,
+      }, '🌐 飞书开放平台'),
       React.createElement('button', {
         style: s.btnGhost,
         onClick: () => setShowHelp(v => !v),
@@ -613,19 +633,19 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
       ),
       React.createElement('div', { style: { display: 'flex', gap: 8, marginTop: 10, flexWrap: 'wrap', alignItems: 'center' } },
         platform.status !== 'connected' && platform.status !== 'starting' &&
-          React.createElement('button', { style: s.btnPri, onClick: onLogin, disabled: busy }, '重新登录'),
+          React.createElement('button', { style: s.btnPri, onClick: onLogin, disabled: busy }, '重新连接'),
         (platform.status === 'connected' || platform.status === 'starting') &&
           React.createElement('button', { style: s.btnGhost, onClick: onStop, disabled: busy }, '断开'),
         React.createElement('button', {
           style: { ...s.btnGhost, color: 'var(--dsw-alias-state-error-primary,#dc2626)', borderColor: 'var(--dsw-alias-state-error-primary,#dc2626)', opacity: busy ? 0.5 : 1 },
           disabled: busy,
-          onClick: () => { if (window.confirm('确认解绑？这将清除登录凭证，下次需重新登录。')) act(BRIDGE_ENDPOINTS.platformUnbind, {}); },
-          title: '清除登录凭证，下次需重新登录',
+          onClick: () => { if (window.confirm('确认解绑？这将清除保存的凭证。')) act(BRIDGE_ENDPOINTS.platformUnbind, {}); },
+          title: '清除登录凭证，下次需重新配置',
         }, '解绑账号'),
       ),
     ),
 
-    // 未配置 / 登录中：二维码（QQ 无二维码，显示凭证表单）
+    // 未配置 / 登录中：表单（QQ / 飞书）或二维码（微信）
     (!platform?.configured || showQr) && React.createElement('div', { style: s.block },
       showQr && login.qr
         ? React.createElement('div', null,
@@ -637,28 +657,30 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
             ),
             login.error && React.createElement('div', { style: { ...s.muted, marginTop: 4, color: 'var(--dsw-alias-state-warn-primary,#92400e)' } }, login.error),
           )
-        : platformId === 'qq'
+        : (platformId === 'qq' || platformId === 'feishu')
           ? React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 10, marginTop: 4 } },
               React.createElement('div', null,
-                React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, 'AppID — QQ 开放平台机器人应用 ID'),
+                React.createElement('div', { style: { ...s.muted, marginBottom: 4 } },
+                  platformId === 'qq' ? 'AppID — QQ 开放平台机器人应用 ID' : 'App ID — 飞书开放平台自建应用 ID (cli_xxx)'
+                ),
                 React.createElement('input', {
                   style: { ...s.input, width: '100%' },
-                  placeholder: '请输入 AppID',
+                  placeholder: platformId === 'qq' ? '请输入 AppID' : '请输入 App ID (如 cli_a1b2c3d4...)',
                   value: cfgDraft?.appId ?? '',
                   onChange: (e) => setCfgDraft(d => ({ ...d, appId: e.target.value })),
-                  onKeyDown: (e) => { if (e.key === 'Enter' && cfgDraft?.appId?.trim() && cfgDraft?.clientSecret?.trim() && !busy) saveConfig(); },
                 }),
               ),
               React.createElement('div', null,
-                React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, 'ClientSecret — QQ 开放平台机器人密钥'),
+                React.createElement('div', { style: { ...s.muted, marginBottom: 4 } },
+                  platformId === 'qq' ? 'ClientSecret — QQ 开放平台机器人密钥' : 'App Secret — 飞书开放平台应用密钥'
+                ),
                 React.createElement('div', { style: { display: 'flex', gap: 6, alignItems: 'center' } },
                   React.createElement('input', {
                     style: { ...s.input, flex: 1 },
                     type: showSecret ? 'text' : 'password',
-                    placeholder: '请输入 ClientSecret',
-                    value: cfgDraft?.clientSecret ?? '',
-                    onChange: (e) => setCfgDraft(d => ({ ...d, clientSecret: e.target.value })),
-                    onKeyDown: (e) => { if (e.key === 'Enter' && cfgDraft?.appId?.trim() && cfgDraft?.clientSecret?.trim() && !busy) saveConfig(); },
+                    placeholder: platformId === 'qq' ? '请输入 ClientSecret' : '请输入 App Secret',
+                    value: platformId === 'qq' ? (cfgDraft?.clientSecret ?? '') : (cfgDraft?.appSecret ?? ''),
+                    onChange: (e) => setCfgDraft(d => platformId === 'qq' ? ({ ...d, clientSecret: e.target.value }) : ({ ...d, appSecret: e.target.value })),
                   }),
                   React.createElement('button', {
                     style: { ...s.btnGhost, height: 32, padding: '0 10px', fontSize: 13, flexShrink: 0 },
@@ -670,15 +692,16 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
               ),
               React.createElement('div', null,
                 React.createElement('a', {
-                  href: 'https://bot.q.qq.com/wiki/develop/api-v2/',
+                  href: platformId === 'qq' ? 'https://bot.q.qq.com/wiki/develop/api-v2/' : 'https://open.feishu.cn/app',
                   target: '_blank', rel: 'noopener noreferrer',
                   style: s.btnLink,
-                }, '📖 前往 QQ 开放平台申请机器人'),
+                }, platformId === 'qq' ? '📖 前往 QQ 开放平台申请机器人' : '📖 前往飞书开放平台创建企业自建应用'),
               ),
               React.createElement('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap', alignItems: 'center' } },
                 React.createElement('button', {
                   style: { ...s.btnPri, opacity: busy ? 0.5 : 1 },
-                  onClick: saveConfig, disabled: busy || !cfgDraft?.appId?.trim() || !cfgDraft?.clientSecret?.trim(),
+                  onClick: saveConfig,
+                  disabled: busy || !cfgDraft?.appId?.trim() || (platformId === 'qq' ? !cfgDraft?.clientSecret?.trim() : !cfgDraft?.appSecret?.trim()),
                 }, busy ? '保存中…' : '保存并连接'),
                 login.phase === 'error' && React.createElement('div', { style: { ...s.muted, fontSize: 12 } }, login.error ?? '连接失败'),
               ),
@@ -692,106 +715,7 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatu
             ),
     ),
 
-    // 高级设置（紧凑 2x2 网格 + 恢复默认值）
-    cfgDraft && React.createElement('div', { style: s.block },
-      React.createElement('button', {
-        style: { ...s.btnLink, fontSize: 12, marginBottom: showAdvanced ? 10 : 0 },
-        onClick: () => setShowAdvanced(v => !v),
-      }, showAdvanced ? '▾ 高级设置' : '▸ 高级设置'),
-      showAdvanced && React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 10 } },
-        // 2x2 参数网格
-        React.createElement('div', {
-          style: {
-            display: 'grid',
-            gridTemplateColumns: 'repeat(auto-fit, minmax(200px, 1fr))',
-            gap: 10,
-          },
-        },
-          // 心跳间隔
-          React.createElement('div', null,
-            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '心跳进度间隔 (秒)'),
-            React.createElement('input', {
-              style: { ...s.input, width: '100%' },
-              type: 'number', min: 30, max: 3600,
-              value: cfgDraft.digestIntervalSec,
-              onChange: (e) => setCfgDraft(d => ({ ...d, digestIntervalSec: e.target.value })),
-            }),
-          ),
-          // 审批超时
-          React.createElement('div', null,
-            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '审批超时自动拒绝 (秒)'),
-            React.createElement('input', {
-              style: { ...s.input, width: '100%' },
-              type: 'number', min: 30, max: 86400,
-              value: cfgDraft.approvalTimeoutSec,
-              onChange: (e) => setCfgDraft(d => ({ ...d, approvalTimeoutSec: e.target.value })),
-            }),
-          ),
-          // 每气泡字数
-          React.createElement('div', null,
-            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '单条最大字数限制 (字)'),
-            React.createElement('input', {
-              style: { ...s.input, width: '100%' },
-              type: 'number', min: 100, max: 10000,
-              value: cfgDraft.maxMessageChars,
-              onChange: (e) => setCfgDraft(d => ({ ...d, maxMessageChars: e.target.value })),
-            }),
-          ),
-          // 分块延迟
-          React.createElement('div', null,
-            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '分块发送延迟 (毫秒)'),
-            React.createElement('input', {
-              style: { ...s.input, width: '100%' },
-              type: 'number', min: 0, max: 10000,
-              value: cfgDraft.sendChunkDelayMs,
-              onChange: (e) => setCfgDraft(d => ({ ...d, sendChunkDelayMs: e.target.value })),
-            }),
-          ),
-        ),
-        // QQ 平台凭证
-        platformId === 'qq' && React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 10, marginTop: 4 } },
-          React.createElement('div', null,
-            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, 'AppID — QQ 开放平台机器人应用 ID'),
-            React.createElement('input', {
-              style: { ...s.input, width: '100%' },
-              placeholder: '请输入 AppID',
-              value: cfgDraft.appId,
-              onChange: (e) => setCfgDraft(d => ({ ...d, appId: e.target.value })),
-            }),
-          ),
-          React.createElement('div', null,
-            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, 'ClientSecret — QQ 开放平台机器人密钥（留空则保持已保存密钥）'),
-            React.createElement('div', { style: { display: 'flex', gap: 6, alignItems: 'center' } },
-              React.createElement('input', {
-                style: { ...s.input, flex: 1 },
-                type: showSecret ? 'text' : 'password',
-                placeholder: '留空保持已保存密钥',
-                value: cfgDraft.clientSecret,
-                onChange: (e) => setCfgDraft(d => ({ ...d, clientSecret: e.target.value })),
-              }),
-              React.createElement('button', {
-                style: { ...s.btnGhost, height: 32, padding: '0 10px', fontSize: 13, flexShrink: 0 },
-                onClick: () => setShowSecret(v => !v),
-                type: 'button',
-                title: showSecret ? '隐藏密钥' : '显示明文',
-              }, showSecret ? '🙈 隐藏' : '👁️ 显示'),
-            ),
-          ),
-        ),
-        React.createElement('div', { style: { display: 'flex', gap: 8, alignItems: 'center', marginTop: 4 } },
-          React.createElement('button', {
-            style: { ...s.btnPri, opacity: (cfgDirty && !busy) ? 1 : 0.5 },
-            disabled: !cfgDirty || busy,
-            onClick: saveConfig,
-          }, busy ? '保存中…' : '保存设置'),
-          React.createElement('button', {
-            style: { ...s.btnGhost, height: 32, fontSize: 12 },
-            onClick: resetDefaults,
-            title: '恢复推荐默认配置',
-          }, '↺ 恢复推荐默认'),
-        ),
-      ),
-    ),
+
 
     React.createElement('div', { style: s.block },
       React.createElement('div', { style: { ...s.tip, fontSize: 12 } },
@@ -1221,7 +1145,7 @@ function BridgePanel({ rpcCall }) {
     const IM_PLATFORMS = [
       { id: 'wechat',   label: '微信',     icon: Icons.wechat,   brandColor: '#07C160', desc: 'ClawBot 扫码直连 · 无需公网' },
       { id: 'qq',       label: 'QQ',       icon: Icons.qq,       brandColor: '#12B7F5', desc: '官方机器人 · 私聊/群聊/按钮' },
-      { id: 'feishu',   label: '飞书',     icon: Icons.feishu,   brandColor: '#00D6B9', desc: '官方事件回调 API' },
+      { id: 'feishu',   label: '飞书',     icon: Icons.feishu,   brandColor: '#00D6B9', desc: '官方 WebSocket 长连接 · 免公网' },
       { id: 'telegram', label: 'Telegram', icon: Icons.telegram, brandColor: '#24A1DE', desc: '官方 Bot API' },
     ];