@wenbin_wb/dsh-bridge 2.10.8 → 2.10.9

package/lib/connection-compat.js

@@ -0,0 +1,115 @@
+// 运行时兼容垫片：DSH ≥ 0.1.5-alpha.1 的 connection RPC 通道注册回归
+// （lib/connection-compat.js）
+//
+// 背景（上游回归，非本插件声明问题）
+// ---------------------------------------------------------------
+// @deepseek-ai/dsh-client-connection 在 0.1.5-alpha.1 改了插件级服务声明：
+//     ≤ 0.1.3-alpha.2    const inject = ["webServer", "credentials"];
+//     ≥ 0.1.5-alpha.1    const inject = ["credentials"];      // webServer 改为可选
+// 同时把 /api 路由改用作用域注入 ctx.inject(["webServer"], (webCtx) => …)。
+// 但 HostConnectionService.register() 里那一句没有同步改（各版本行号均为 618）：
+//     return owner.effect(() => owner.webServer.register(route),
+//                         `client-connection: ${channel} rpc channel`);
+// 其中 owner === this.ctx，即 connection 插件自己的 ctx。该 ctx 的 fiber 不再把
+// webServer 记入 inject，于是 cordis 4 的服务守卫直接抛：
+//     cannot get property "webServer" without inject
+// 注册发生在插件树加载期，异常向上冒泡 → 整棵插件树加载失败，`dsh web` 起不来：
+//     Error: dsh: plugin tree failed to load: failed to apply loader entry
+//            dsh-bridge (@wenbin_wb/dsh-bridge): cannot get property "webServer" without inject
+//
+// 影响面：任何调用 ctx.connection.rpc.handle() 的插件都会踩中（dsh-bridge 只是第一个撞上的）。
+// 已逐一核对 npm 上的版本：0.1.5-alpha.1 / alpha.2 / rc.1 / rc.2 全部未修
+// （0.1.5-rc.2 为当前已发布的最新版），0.1.3-alpha.2 及更早正常。
+//
+// 本垫片的做法
+// ---------------------------------------------------------------
+// 不改上游代码、不猜内部私有方法，只走两个公开面：
+//   1. 正常路径：ctx.connection.rpc.handle(channel, handler)（公开 API，未来上游修好即恢复）；
+//   2. 兜底路径：仅当该调用抛出 "webServer … without inject" 时，在 root 的
+//      `internal/get` 瀑布事件上临时挂一个监听器 —— 先让默认解析跑，默认解析失败
+//      （抛出的正是同一个 error 对象）才补上本插件已通过 inject 拿到的 webServer 引用。
+//      webServer 是单例服务，语义等价；默认解析成功时零干预。
+// 监听器只在这一次同步注册调用期间存在，返回后立即摘除（cordis 的 effect 同步执行，
+// 注册完成后 owner.webServer 不再被访问），因此对宿主其余部分完全无副作用。
+//
+// 上游修好后本模块自动空转：首次调用不再抛错，兜底分支根本不会进入。
+
+const MISSING_INJECT = /without inject/;
+
+/**
+ * 判断错误是否为"跨服务取属性缺 inject 作用域"的守卫错误，且对象是 webServer。
+ * @param {unknown} err 捕获到的异常
+ * @returns {boolean} 是否命中该回归
+ */
+export function isMissingWebServerInjectError(err) {
+  if (!(err instanceof Error)) return false;
+  return MISSING_INJECT.test(err.message) && /webServer/.test(err.message);
+}
+
+/**
+ * 在 root 的 `internal/get` 瀑布事件上挂一个临时兜底：默认解析失败时提供 webServer。
+ *
+ * cordis 4 的 `ctx.events` 是所有子 ctx 共享的同一个实例，且 `internal/get` 派发时
+ * 不带 context 过滤条件（thisArg 为 null），因此在本插件 ctx 上注册的监听器同样会对
+ * connection 插件 ctx 的查找生效。监听器由 root fiber 持有，须手工摘除。
+ *
+ * @param {object} ctx 本插件的 ctx
+ * @returns {() => void} 摘除函数
+ */
+export function installWebServerResolutionFallback(ctx) {
+  const webServer = ctx?.webServer;
+  if (webServer === undefined) return () => {};
+
+  const listener = function (lookupCtx, prop, error, next) {
+    if (prop !== 'webServer') return next();
+    try {
+      return next();
+    } catch (err) {
+      // 默认解析抛的不是本次守卫错误 → 原样上抛，绝不掩盖真实故障
+      if (err !== error) throw err;
+    }
+    // 默认解析确认失败：补上本插件已 inject 的单例引用（语义等价）
+    return webServer;
+  };
+
+  const off = ctx.on?.('internal/get', listener, { global: true });
+  return typeof off === 'function' ? off : () => {};
+}
+
+/**
+ * 注册 connection RPC 通道，并兼容 DSH ≥ 0.1.5-alpha.1 的 webServer 注入回归。
+ *
+ * @param {object} ctx 本插件的 ctx（须已 inject `connection` 与 `webServer`）
+ * @param {string} channel RPC 通道名（如 `/dsh-bridge`）
+ * @param {Function} handler 通道处理器
+ * @param {object} [rpcOptions] 透传给 connection 的通道选项。
+ *        DSH 0.1.0/0.1.1 的 `rpc.handle(channel, handler, options)` 支持
+ *        `{ authority: 'loopback' }`（仅回环可达，非回环请求 403）；
+ *        0.1.2-rc.1 起该第三参数已被移除（更高版本忽略它，传入无副作用）。
+ *        本插件依赖它来做回环加固，因此必须原样透传、不得丢失。
+ * @param {{warn?: Function}} [logger] 可选日志器
+ * @returns {Function} 由 connection 服务返回的处置函数
+ */
+export function registerRpcChannel(ctx, channel, handler, rpcOptions, logger) {
+  try {
+    return ctx.connection.rpc.handle(channel, handler, rpcOptions);
+  } catch (err) {
+    if (!isMissingWebServerInjectError(err)) throw err;
+
+    // 上游回归：owner（connection 插件自己的 ctx）解析不到 webServer。
+    // 该调用在 owner.webServer 处、于 webServer.register() 之前就抛，未产生任何副作用，
+    // 因此可以安全地补上兜底后重试一次。
+    const dispose = installWebServerResolutionFallback(ctx);
+    try {
+      const registered = ctx.connection.rpc.handle(channel, handler, rpcOptions);
+      logger?.warn?.(
+        'dsh-bridge: 检测到宿主 DSH 的 connection RPC 注册回归（cannot get property "webServer" without inject，'
+        + '见 dsh-client-connection 的 register()）；已用 webServer 解析兜底完成通道注册。'
+        + '此为宿主侧问题（DSH 0.1.5-alpha.1 起），插件侧垫片会在上游修复后自动空转。'
+      );
+      return registered;
+    } finally {
+      dispose();
+    }
+  }
+}

package/lib/feishu/index.js

@@ -1,225 +1,225 @@
-// dsh-bridge Feishu / Lark platform adapter
-// 编排 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'
-
-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._botQrCache = { appId: '', qr: '' }
-
-    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 : [],
-      groupAutoApprove: config.groupAutoApprove,
-      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 ?? [])]
-    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,
-      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,
-      botLink,
-      botQr: this._botQrCache.qr,
-      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, groupAutoApprove, appId, appSecret, domain } = {}) {
-    if (digestIntervalSec != null)   this.node.config.digestIntervalSec   = Number(digestIntervalSec)
-    if (approvalTimeoutSec != null)  this.node.config.approvalTimeoutSec  = Number(approvalTimeoutSec)
-    if (maxMessageChars != null) {
-      const val = Number(maxMessageChars)
-      this.node.config.maxMessageChars = (val >= 200) ? val : 2000
-    }
-    if (sendChunkDelayMs != null)    this.node.config.sendChunkDelayMs    = Number(sendChunkDelayMs)
-    if (groupAutoApprove != null)    this.node.config.groupAutoApprove    = groupAutoApprove === true
-    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,
-      groupAutoApprove:   this.node.config.groupAutoApprove === true,
-    }
-    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?.()
-  }
-}
+// dsh-bridge Feishu / Lark platform adapter
+// 编排 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'
+
+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._botQrCache = { appId: '', qr: '' }
+
+    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 : [],
+      groupAutoApprove: config.groupAutoApprove,
+      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 ?? [])]
+    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,
+      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,
+      botLink,
+      botQr: this._botQrCache.qr,
+      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, groupAutoApprove, appId, appSecret, domain } = {}) {
+    if (digestIntervalSec != null)   this.node.config.digestIntervalSec   = Number(digestIntervalSec)
+    if (approvalTimeoutSec != null)  this.node.config.approvalTimeoutSec  = Number(approvalTimeoutSec)
+    if (maxMessageChars != null) {
+      const val = Number(maxMessageChars)
+      this.node.config.maxMessageChars = (val >= 200) ? val : 2000
+    }
+    if (sendChunkDelayMs != null)    this.node.config.sendChunkDelayMs    = Number(sendChunkDelayMs)
+    if (groupAutoApprove != null)    this.node.config.groupAutoApprove    = groupAutoApprove === true
+    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,
+      groupAutoApprove:   this.node.config.groupAutoApprove === true,
+    }
+    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?.()
+  }
+}