@wenbin_wb/dsh-bridge 2.2.8 → 2.3.0

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`)。

package/lib/feishu/gateway.js

@@ -0,0 +1,373 @@
+// Feishu / Lark Bot OpenAPI & WebSocket Gateway
+// Official SDK: @larksuiteoapi/node-sdk
+// Reference: https://open.feishu.cn/document/home/event-subscription-via-websocket/overview
+
+import { Service } from '@deepseek-ai/cordis'
+import * as Lark from '@larksuiteoapi/node-sdk'
+
+export class FeishuGateway extends Service {
+  static name = 'feishu'
+
+  constructor(ctx, config = {}) {
+    super(ctx, 'feishu', true)
+    this.ctx = ctx
+    this.logger = ctx.logger?.('feishu') ?? console
+    this.config = {
+      appId: '',
+      appSecret: '',
+      domain: 'feishu', // 'feishu' | 'lark'
+      ...config,
+    }
+    this.status = 'idle'
+    this.error = null
+    this.botInfo = null
+    this.client = null
+    this.wsClient = null
+    this.eventDispatcher = null
+    this._closing = false
+    this.seenMessageIds = new Set()
+  }
+
+  get configured() {
+    return Boolean(this.config.appId && this.config.appSecret)
+  }
+
+  setStatus(status, error = null) {
+    this.status = status
+    this.error = error ? String(error?.message || error) : null
+    this.ctx.emit('feishu/status', {
+      status: this.status,
+      error: this.error,
+      botInfo: this.botInfo,
+      configured: this.configured,
+    })
+  }
+
+  updateConfig(cfg = {}) {
+    this.config = { ...this.config, ...cfg }
+  }
+
+  async start() {
+    if (!this.configured) {
+      this.setStatus('idle')
+      return false
+    }
+
+    if (this.status === 'online') {
+      return true
+    }
+
+    if (this._startingPromise) {
+      return this._startingPromise
+    }
+
+    this._closing = false
+    this.setStatus('starting')
+
+    this._startingPromise = (async () => {
+      try {
+        const isLark = this.config.domain === 'lark'
+        const domain = isLark ? Lark.Domain.Lark : Lark.Domain.Feishu
+
+        // 1. 初始化 REST API Client
+        this.client = new Lark.Client({
+          appId: this.config.appId,
+          appSecret: this.config.appSecret,
+          domain,
+          appType: Lark.AppType.SelfBuild,
+        })
+
+        // 2. 初始化长连接 WSClient
+        this.wsClient = new Lark.WSClient({
+          appId: this.config.appId,
+          appSecret: this.config.appSecret,
+          domain,
+          loggerLevel: Lark.LoggerLevel.error,
+        })
+
+        // 3. 构建事件分发器
+        this.eventDispatcher = new Lark.EventDispatcher({})
+
+        // 注册接收消息事件
+        this.eventDispatcher.register({
+          'im.message.receive_v1': async (data) => {
+            try {
+              await this._handleMessageReceive(data)
+            } catch (err) {
+              this.logger.error?.('[dsh-bridge feishu] error in im.message.receive_v1:', err)
+            }
+          },
+          'card.action.trigger': async (data) => {
+            try {
+              return await this._handleCardActionTrigger(data)
+            } catch (err) {
+              this.logger.error?.('[dsh-bridge feishu] error in card.action.trigger:', err)
+              return { toast: { type: 'error', content: '处理失败' } }
+            }
+          },
+          'im.message.message_read_v1': async () => {
+            // 消息已读回执事件，忽略
+          },
+        })
+
+        // 4. 尝试获取机器人信息（验证凭证，非阻断）
+        try {
+          const botRes = await this.client.bot.v3.bot.get({}).catch(() => null)
+          if (botRes?.bot) {
+            this.botInfo = {
+              openId: botRes.bot.open_id,
+              appName: botRes.bot.app_name,
+              avatarUrl: botRes.bot.avatar_url,
+            }
+            this.logger.info?.(`[dsh-bridge feishu] bot authenticated: ${this.botInfo.appName} (${this.botInfo.openId})`)
+          }
+        } catch (authErr) {
+          this.logger.warn?.(`[dsh-bridge feishu] fetch bot info error: ${authErr.message}`)
+        }
+
+        // 5. 启动 WebSocket 长连接
+        await this.wsClient.start({ eventDispatcher: this.eventDispatcher })
+        this.setStatus('online')
+        this.logger.info?.('[dsh-bridge feishu] WebSocket connected to Feishu Open Platform')
+        return true
+      } catch (err) {
+        this.logger.error?.('[dsh-bridge feishu] start failed:', err?.message ?? err)
+        this.setStatus('error', err)
+        return false
+      } finally {
+        this._startingPromise = null
+      }
+    })()
+
+    return this._startingPromise
+  }
+
+  async stop() {
+    this._closing = true
+    try {
+      if (this.wsClient) {
+        const wsInstance = this.wsClient.wsConfig?.getWSInstance?.()
+        if (wsInstance) {
+          try { wsInstance.close?.() } catch {}
+          try { wsInstance.terminate?.() } catch {}
+        }
+      }
+    } catch (err) {
+      this.logger.warn?.('[dsh-bridge feishu] stop error:', err)
+    } finally {
+      this.client = null
+      this.wsClient = null
+      this.eventDispatcher = null
+      this.setStatus('offline')
+    }
+  }
+
+  // ---- 消息收发 ----
+
+  async _handleMessageReceive(data) {
+    if (!data?.message) return
+    const { message, sender } = data
+    const messageId = message.message_id
+    if (!messageId) return
+
+    // 消息去重
+    if (this.seenMessageIds.has(messageId)) return
+    this.seenMessageIds.add(messageId)
+    if (this.seenMessageIds.size > 500) {
+      const first = this.seenMessageIds.values().next().value
+      this.seenMessageIds.delete(first)
+    }
+
+    const senderOpenId = sender?.sender_id?.open_id || ''
+    const chatId = message.chat_id || ''
+    const chatType = message.chat_type || 'p2p' // 'p2p' or 'group'
+    const isGroup = chatType === 'group'
+
+    // 提取文本内容
+    let text = ''
+    if (message.message_type === 'text') {
+      try {
+        const parsed = JSON.parse(message.content || '{}')
+        text = parsed.text || ''
+      } catch {
+        text = message.content || ''
+      }
+    }
+
+    // 群聊中剥离机器人 @ 占位符（例如 @_user_1 等）
+    if (isGroup && text) {
+      text = text.replace(/@_user_\d+/g, '').trim()
+    }
+
+    const peerId = isGroup ? chatId : senderOpenId
+    if (!peerId) return
+
+    this.ctx.emit('feishu/message', {
+      peerId,
+      senderId: senderOpenId,
+      chatId,
+      chatType,
+      isGroup,
+      messageId,
+      text,
+      messageType: message.message_type,
+      raw: data,
+      createTime: Number(message.create_time || Date.now()),
+    })
+  }
+
+  async _handleCardActionTrigger(data) {
+    const action = data?.action || {}
+    const operator = data?.operator || {}
+    const operatorOpenId = operator.open_id || ''
+    const value = action.value || {}
+
+    this.ctx.emit('feishu/action', {
+      operatorId: operatorOpenId,
+      action: value.action || action.tag,
+      value,
+      raw: data,
+    })
+
+    const actionName = value.action === 'approve' ? '已批准' : value.action === 'reject' ? '已拒绝' : '已操作'
+    return {
+      toast: {
+        type: 'success',
+        content: `操作成功：${actionName}`,
+      },
+    }
+  }
+
+  /**
+   * 发送文本消息
+   * @param {string} receiveId - 接收人 open_id 或群 chat_id
+   * @param {string} text - 发送文本
+   * @param {object} opts - { isGroup, receiveIdType }
+   */
+  async sendText(receiveId, text, opts = {}) {
+    if (!this.client || !receiveId || !text) return null
+    let receiveIdType = opts.receiveIdType
+    if (!receiveIdType) {
+      if (receiveId.startsWith('ou_')) receiveIdType = 'open_id'
+      else if (receiveId.startsWith('oc_')) receiveIdType = 'chat_id'
+      else if (opts.isGroup) receiveIdType = 'chat_id'
+      else receiveIdType = 'open_id'
+    }
+
+    try {
+      this.logger.debug?.(`[dsh-bridge feishu] sending text to ${receiveId} (${receiveIdType})`)
+      const res = await this.client.im.v1.message.create({
+        params: { receive_id_type: receiveIdType },
+        data: {
+          receive_id: receiveId,
+          msg_type: 'text',
+          content: JSON.stringify({ text }),
+        },
+      })
+      return res?.data
+    } catch (err) {
+      this.logger.error?.(`[dsh-bridge feishu] sendText error (${receiveId}, ${receiveIdType}):`, err?.message ?? err)
+      throw err
+    }
+  }
+
+  /**
+   * 发送飞书原生交互卡片
+   * @param {string} receiveId - 接收人 open_id 或群 chat_id
+   * @param {object} cardData - 卡片结构对象 (JSON 2.0)
+   * @param {object} opts - { isGroup, receiveIdType }
+   */
+  async sendCard(receiveId, cardData, opts = {}) {
+    if (!this.client || !receiveId || !cardData) return null
+    let receiveIdType = opts.receiveIdType
+    if (!receiveIdType) {
+      if (receiveId.startsWith('ou_')) receiveIdType = 'open_id'
+      else if (receiveId.startsWith('oc_')) receiveIdType = 'chat_id'
+      else if (opts.isGroup) receiveIdType = 'chat_id'
+      else receiveIdType = 'open_id'
+    }
+
+    try {
+      this.logger.debug?.(`[dsh-bridge feishu] sending card to ${receiveId} (${receiveIdType})`)
+      const res = await this.client.im.v1.message.create({
+        params: { receive_id_type: receiveIdType },
+        data: {
+          receive_id: receiveId,
+          msg_type: 'interactive',
+          content: JSON.stringify(cardData),
+        },
+      })
+      return res?.data
+    } catch (err) {
+      this.logger.error?.(`[dsh-bridge feishu] sendCard error (${receiveId}, ${receiveIdType}):`, err?.message ?? err)
+      throw err
+    }
+  }
+
+  /**
+   * 发送 Markdown 交互卡片 (JSON 2.0)
+   * @param {string} receiveId - 接收人 open_id 或群 chat_id
+   * @param {string} markdownText - Markdown 文本
+   * @param {object} opts - { isGroup, receiveIdType }
+   */
+  async sendMarkdownCard(receiveId, markdownText, opts = {}) {
+    const card = {
+      schema: '2.0',
+      config: {
+        wide_screen_mode: true,
+        update_multi: true,
+      },
+      body: {
+        elements: [
+          {
+            tag: 'markdown',
+            content: String(markdownText || '').trim(),
+          },
+        ],
+      },
+    }
+    return this.sendCard(receiveId, card, opts)
+  }
+
+  /**
+   * 更新已发送的交互卡片（流式更新 / 原地替换，JSON 2.0）
+   * @param {string} messageId - 已发送消息的 message_id
+   * @param {string} markdownText - 最新完整 Markdown 文本
+   */
+  async patchCard(messageId, markdownText) {
+    if (!this.client || !messageId) return null
+    const card = {
+      schema: '2.0',
+      config: {
+        wide_screen_mode: true,
+        update_multi: true,
+      },
+      body: {
+        elements: [
+          {
+            tag: 'markdown',
+            content: String(markdownText || '').trim(),
+          },
+        ],
+      },
+    }
+    try {
+      this.logger.debug?.(`[dsh-bridge feishu] patching card message ${messageId}`)
+      const res = await this.client.im.v1.message.patch({
+        path: { message_id: messageId },
+        data: {
+          content: JSON.stringify(card),
+        },
+      })
+      return res?.data
+    } catch (err) {
+      this.logger.error?.(`[dsh-bridge feishu] patchCard error (${messageId}):`, err?.message ?? err)
+      throw err
+    }
+  }
+
+  // 释放资源
+  dispose() {
+    void this.stop()
+  }
+}

package/lib/feishu/index.js

@@ -0,0 +1,203 @@
+// dsh-bridge Feishu / Lark platform adapter
+// 编排 FeishuGateway（官方 OpenAPI/WSClient 网关）+ FeishuConversationNode（飞书⇄DSH 会话桥）。
+// 作为 Platform 子类，注册进 PlatformManager 统一管理。
+
+import { Platform } from '../platform/base.js'
+import { FeishuGateway } from './gateway.js'
+import { FeishuConversationNode } from './node.js'
+
+export class FeishuService extends Platform {
+  /**
+   * @param {object} opts
+   * @param {object} opts.ctx          Cordis 上下文
+   * @param {object} opts.logger       日志器
+   * @param {object} [opts.config]     已持久化的 feishu 配置（凭证 + allowFrom + 间隔）
+   * @param {(patch: object) => (void|Promise<void>)} opts.onPersist  主插件保存回调
+   */
+  constructor({ ctx, logger, config = {}, onPersist }) {
+    super({ ctx, logger, config, onPersist })
+    this.id = 'feishu'
+    this.name = 'Feishu'
+
+    this.gateway = new FeishuGateway(ctx, {
+      appId: config.appId ?? '',
+      appSecret: config.appSecret ?? '',
+      domain: config.domain ?? 'feishu',
+    })
+
+    // 挂到 ctx 供会话节点读取
+    try { ctx.feishu = this.gateway } catch { /* 挂载失败不致命 */ }
+
+    this.node = new FeishuConversationNode(ctx, {
+      allowFrom: Array.isArray(config.allowFrom) ? config.allowFrom : [],
+      digestIntervalSec: config.digestIntervalSec,
+      approvalTimeoutSec: config.approvalTimeoutSec,
+      maxMessageChars: config.maxMessageChars || 2000,
+      sendChunkDelayMs: config.sendChunkDelayMs,
+      activeSessionId: config.activeSessionId,
+    }, logger, {
+      onFirstSender: () => this.persist({ allowFrom: [...(this.node?.config?.allowFrom ?? [])] }),
+      onActiveSessionChange: (sessionId) => this.persist({ activeSessionId: sessionId }),
+    })
+    this.bridge = this.node
+
+    if (this.gateway.configured) {
+      void this.start().catch((err) => {
+        this.logger.error?.('[dsh-bridge feishu] start failed:', err?.message ?? err)
+      })
+    }
+  }
+
+  // ---- Platform 接口 ----
+
+  get configured() { return this.gateway.configured }
+  get accountId() { return this.gateway.botInfo?.openId || '' }
+
+  get capabilities() {
+    return {
+      group: true,
+      media: true,
+      approvals: true,
+      maxMessageChars: this.node.config.maxMessageChars || 2000,
+    }
+  }
+
+  async sendText(peerId, text, opts = {}) {
+    return this.gateway.sendMarkdownCard(peerId, text, opts)
+  }
+
+  async sendTyping(peerId, opts = {}) {
+    return this.gateway.sendTyping?.(peerId, opts)
+  }
+
+  // ---- 生命周期控制 ----
+
+  async start() {
+    if (!this.gateway.configured) {
+      this.setStatus('idle')
+      return { success: false, error: 'App ID 与 App Secret 未配置' }
+    }
+    this.setStatus('starting')
+    const ok = await this.gateway.start()
+    if (ok) {
+      this.setStatus('connected')
+      return { success: true }
+    } else {
+      this.setStatus('error', this.gateway.error || '连接失败')
+      return { success: false, error: this.gateway.error }
+    }
+  }
+
+  async stop() {
+    await this.gateway.stop()
+    this.setStatus('offline')
+    return { success: true }
+  }
+
+  /**
+   * 配置或登录
+   * @param {object} creds - { appId, appSecret, domain }
+   */
+  async login(creds = {}) {
+    const patch = {}
+    if (creds.appId !== undefined) patch.appId = String(creds.appId).trim()
+    if (creds.appSecret !== undefined) patch.appSecret = String(creds.appSecret).trim()
+    if (creds.domain !== undefined) patch.domain = creds.domain === 'lark' ? 'lark' : 'feishu'
+
+    this.gateway.updateConfig(patch)
+    this.persist(patch)
+
+    if (!this.gateway.configured) {
+      await this.stop()
+      return { success: false, error: '请填写完整的 App ID 和 App Secret' }
+    }
+
+    return this.start()
+  }
+
+  async unbind() {
+    await this.stop()
+    this.gateway.updateConfig({ appId: '', appSecret: '' })
+    this.persist({ appId: '', appSecret: '', allowFrom: [] })
+    if (this.node) this.node.config.allowFrom = []
+    return { success: true }
+  }
+
+  getStatus() {
+    const allowFrom = [...(this.node?.config?.allowFrom ?? [])]
+    return {
+      id: this.id,
+      name: this.name,
+      status: this.status === 'connected' ? 'connected' : this.gateway.status,
+      configured: this.gateway.configured,
+      accountId: this.gateway.botInfo?.appName
+        ? `${this.gateway.botInfo.appName} (${this.gateway.botInfo.openId || this.gateway.config.appId})`
+        : (this.gateway.botInfo?.openId || this.gateway.config.appId || ''),
+      allowFrom,
+      peerId: this.node?.peerId,
+      sessionId: this.node?.activeSessionId,
+      login: {
+        phase: this.status === 'connected' ? 'done' : this.status === 'error' ? 'error' : 'idle',
+        error: this.gateway.error,
+      },
+      capabilities: { ...this.capabilities },
+      config: {
+        digestIntervalSec: this.node?.config?.digestIntervalSec,
+        approvalTimeoutSec: this.node?.config?.approvalTimeoutSec,
+        maxMessageChars: this.node?.config?.maxMessageChars,
+        sendChunkDelayMs: this.node?.config?.sendChunkDelayMs,
+        appId: this.gateway.config.appId,
+        appSecret: '',
+        domain: this.gateway.config.domain,
+      },
+      botInfo: this.gateway.botInfo,
+      error: this.gateway.error,
+    }
+  }
+
+  setAllowFrom(allowFrom) {
+    const list = Array.isArray(allowFrom) ? allowFrom.map((s) => String(s).trim()).filter(Boolean) : []
+    if (this.node) this.node.config.allowFrom = list
+    this.persist({ allowFrom: list })
+    return { success: true, allowFrom: list }
+  }
+
+  async setConfig({ digestIntervalSec, approvalTimeoutSec, maxMessageChars, sendChunkDelayMs, appId, appSecret, domain } = {}) {
+    if (digestIntervalSec != null)   this.node.config.digestIntervalSec   = Number(digestIntervalSec)
+    if (approvalTimeoutSec != null)  this.node.config.approvalTimeoutSec  = Number(approvalTimeoutSec)
+    if (maxMessageChars != null)     this.node.config.maxMessageChars     = Number(maxMessageChars)
+    if (sendChunkDelayMs != null)    this.node.config.sendChunkDelayMs    = Number(sendChunkDelayMs)
+    if (appId !== undefined || appSecret !== undefined || domain !== undefined) {
+      this.gateway.updateConfig({
+        appId: appId !== undefined ? appId.trim() : this.gateway.config.appId,
+        appSecret: appSecret?.trim() ? appSecret.trim() : this.gateway.config.appSecret,
+        domain: domain || this.gateway.config.domain || 'feishu',
+      })
+    }
+    const patch = {
+      digestIntervalSec:  this.node.config.digestIntervalSec,
+      approvalTimeoutSec: this.node.config.approvalTimeoutSec,
+      maxMessageChars:    this.node.config.maxMessageChars,
+      sendChunkDelayMs:   this.node.config.sendChunkDelayMs,
+    }
+    if (appId !== undefined || appSecret !== undefined || domain !== undefined) {
+      patch.appId = this.gateway.config.appId
+      patch.appSecret = this.gateway.config.appSecret
+      patch.domain = this.gateway.config.domain
+    }
+    await this.persist(patch)
+
+    // 凭证配置完成后自动启动网关（前端「保存并连接」自动连接）
+    if (this.gateway.configured && (appId !== undefined || appSecret !== undefined)) {
+      await this.start().catch((err) => {
+        this.logger?.warn?.('[dsh-bridge feishu] auto-start failed: %s', err?.message ?? err)
+      })
+    }
+    return { success: true }
+  }
+
+  dispose() {
+    super.dispose()
+    this.gateway?.dispose?.()
+  }
+}