@wenbin_wb/dsh-bridge 2.2.9 → 2.3.1

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,49 @@ 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: '清除登录凭证，下次需重新配置',
         }, '解绑账号'),
       ),
+      // 飞书专属：手机扫码直达 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 无二维码，显示凭证表单）
+    // 未配置 / 登录中：表单（QQ / 飞书）或二维码（微信）
     (!platform?.configured || showQr) && React.createElement('div', { style: s.block },
       showQr && login.qr
         ? React.createElement('div', null,
@@ -637,28 +687,45 @@ 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 } },
+              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 } }, '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 +737,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 +760,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 +1190,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' },
     ];
     

package/docs/feishu-usage.md

@@ -0,0 +1,93 @@
+# 飞书 (Feishu / Lark) 机器人接入指南
+
+> 通过飞书官方开放平台 **WebSocket 长连接（免公网 IP）** 模式，将本地 DeepSeek Harness 接入飞书，支持单聊、群聊、表格命令与原生交互卡片权限审批。
+
+---
+
+## 🌟 核心优势
+
+- **100% 免公网 IP**：基于飞书官方最新 WebSocket 长连接协议，无需配置公网服务器、无需域名、无需内网穿透工具。
+- **免验签与加密配置**：长连接由飞书官方 SDK 在建立通道时完成认证，无需开发者手动处理 HTTP 回调验签。
+- **飞书原生交互卡片**：Agent 触发敏感工具审批时，飞书端下发带点击按钮的交互卡片，手机/电脑端单手一键点击即可完成批准或拒绝。
+- **多工作区与会话持久化**：支持 `/sessions` 表格查看历史会话、`/use <序号>` 极速切换、`/workspaces` 工作区调度。
+
+---
+
+## 🛠️ 第一步：创建飞书企业自建应用
+
+1. 登录 [飞书开放平台开发者后台](https://open.feishu.cn/app)；
+2. 点击右上角 **「创建企业自建应用」**，填写应用名称（如 `DeepSeek Harness`）与应用描述，上传机器人头像；
+3. 创建完成后，在左侧导航栏点击 **「凭证与基础信息」**，即可查看到：
+   - **App ID**（格式如 `cli_a1b2c3d4...`）
+   - **App Secret**（点击复制密钥）
+
+---
+
+## 🤖 第二步：添加机器人能力
+
+1. 在应用详情页左侧导航栏，点击 **「添加应用能力」**；
+2. 找到 **「机器人」**，点击 **「添加」** 开启机器人能力。
+
+---
+
+## 🔐 第三步：开通必要权限
+
+在左侧导航栏点击 **「权限管理」**，搜索并开通以下权限：
+
+| 权限名称 | 权限 Key | 权限说明 |
+| :--- | :--- | :--- |
+| **获取与发送单聊/群聊消息** | `im:message` | 基础消息收发权限 |
+| **以应用的身份发消息** | `im:message:send_as_bot` | 允许机器人向用户/群回复消息 |
+| **获取群组中所有消息** | `im:message.group_msg` | 允许机器人在群聊中被 `@` 时接收消息 |
+| **获取用户 user ID** | `contact:user.id:readonly` | (可选) 获取用户信息 |
+
+---
+
+## ⚡ 第四步：开启 WebSocket 长连接事件订阅
+
+1. 在左侧导航栏点击 **「事件与回调」**；
+2. 在 **「事件配置」** 页面，将事件接收方式切换为 **「使用长连接接收事件」**（WebSocket 模式）；
+3. 点击 **「添加事件」**，勾选并添加：
+   - **`im.message.receive_v1`**（接收消息）
+   - **`card.action.trigger`**（消息卡片回传交互 / 审批按钮点击）
+4. 保存配置。
+
+---
+
+## 🚀 第五步：版本发布
+
+1. 在左侧导航栏点击 **「版本管理与发布」**；
+2. 点击 **「创建版本」**，填写版本号（如 `1.0.0`），设置应用可用范围（如「所有员工」或「仅自己」）；
+3. 点击 **「申请发布」**（自建应用通常由企业管理员直接免审或一键通过）。
+
+---
+
+## 📱 第六步：在 DSH 客户端中连接
+
+1. 打开 DeepSeek Harness，进入「设置」➔「远程访问」➔「IM 机器人」➔ 选择 **「飞书」**；
+2. 在表单中填入刚才复制的 **App ID** 和 **App Secret**；
+3. 点击 **「保存并连接」**；
+4. 状态显示为绿色 **「已连接」** 即表示长连接成功建立！
+
+---
+
+## 💬 常用操作与指令
+
+在飞书与机器人单聊或在群里 `@机器人` 即可开始对话：
+
+### 1. 会话与工作区管理
+| 指令 | 说明 | 示例 |
+| :--- | :--- | :--- |
+| `/sessions` | 查看所有历史会话表格 | `/sessions` 或 `/list` |
+| `/use <编号>` | 切换到指定编号会话 | `/use 1` 或 `/resume 1` |
+| `/new <提示词>` | 在当前工作区创建新会话并开始 | `/new 帮我写个脚本` |
+| `/new <词> @N` | 在指定工作区新建会话 | `/new 帮我写个脚本 @1` |
+| `/workspaces` | 查看所有已注册的工作区列表 | `/workspaces` |
+| `/status` | 查看 Agent 运行状态看板 | `/status` |
+| `/stop` | 中断停止当前正在执行的任务 | `/stop` |
+| `/end` | 结束当前会话回到空闲状态 | `/end` |
+
+### 2. 权限审批交互
+当 Agent 尝试执行需授权的操作（如终端命令、写敏感文件）时，飞书端会自动推送 **原生交互卡片**：
+- 点击卡片上的 **「✓ 批准执行」** 或 **「✕ 拒绝执行」** 按钮即可一键处理；
+- 亦可直接回复文字 `/yes` (或 `1`) / `/no` (或 `2`)。