@wenbin_wb/dsh-bridge 2.10.4 → 2.10.6

package/lib/index.js

@@ -798,7 +798,7 @@ class BridgeService {
       },
 
       cloudflared: {
-        running: !!this.cloudflared,
+        running: this.isCloudflaredActive(),
         url: cloudflaredUrl,
         rawUrl: baseCloudflaredUrl,
         qr: cloudflaredUrl
@@ -942,8 +942,18 @@ class BridgeService {
     await this.onPersist?.({ customTunnel: this.customTunnelConfig });
   }
 
+  // 仅断开与状态，不动持久化配置（dispose 路径用）
+  async _haltCustomTunnel() {
+    if (this.customTunnel) {
+      this.customTunnel.disconnect();
+      this.customTunnel = null;
+      this.customTunnelState = { phase: 'idle', detail: '' };
+    }
+  }
+
   async startCloudflared({ autoStart = true } = {}) {
-    if (this.cloudflared) {
+    // 活动中的隧道不允许重复开启；error / idle（引用保留但已停止）允许重建。
+    if (this.cloudflared && this.isCloudflaredActive()) {
       throw new Error('Cloudflare 隧道已在运行');
     }
 
@@ -953,6 +963,12 @@ class BridgeService {
     };
     await this.onPersist?.({ cloudflared: this.cloudflaredConfig });
 
+    // 若存在旧 manager（error/自愈中断留的引用），先彻底停止再重建，杜绝双跑
+    if (this.cloudflared) {
+      this.cloudflared.stop();
+      this.cloudflared = null;
+    }
+
     this.cloudflaredState = { phase: 'connecting', detail: '正在初始化...' };
     this.cloudflared = new CloudflaredManager({
       port: this.proxyPort,
@@ -961,10 +977,10 @@ class BridgeService {
       hostname: this.cloudflaredConfig?.hostname,
       onStateChange: (state) => {
         this.cloudflaredState = state;
-        // 出错时自动清理，让用户可以重新开启
-        if (state.phase === 'error') {
-          this.cloudflared = null;
-        }
+        // 注意：不在 error 时清空 this.cloudflared 引用。
+        // manager 在 error/意外退出时会自行退避重试（reconnecting），引用必须保留到
+        // 用户显式 stop / dispose——否则自愈后 UI 失去控制句柄（"关闭"杀不掉、
+        // "开启"叠新 manager 双跑）。
       },
       logger: this.logger,
     });
@@ -973,6 +989,15 @@ class BridgeService {
     this.cloudflared.start();
   }
 
+  // cloudflared 是否处于"活动"（进程存在或有意图运行）状态。
+  // 引用保留期间（自愈退避中）引用仍在，但不算 running——UI 据此显示"重连中"而非"运行中"。
+  isCloudflaredActive() {
+    const phase = this.cloudflaredState?.phase;
+    return phase === 'ready' || phase === 'connecting' || phase === 'downloading' || phase === 'reconnecting';
+  }
+
+  // 用户显式关闭：停止进程并持久化 autoStart=false（与 UI"关闭"语义一致：关了就不该再自启）。
+  // 内部 dispose 请走 _haltCloudflared()，避免误改用户配置。
   async stopCloudflared() {
     if (this.cloudflared) {
       this.cloudflared.stop();
@@ -986,6 +1011,15 @@ class BridgeService {
     await this.onPersist?.({ cloudflared: this.cloudflaredConfig });
   }
 
+  // 仅停止进程与状态，不动持久化配置（插件卸载/重启路径用——用户的 autoStart 意图要保留）
+  async _haltCloudflared() {
+    if (this.cloudflared) {
+      this.cloudflared.stop();
+      this.cloudflared = null;
+      this.cloudflaredState = { phase: 'idle', detail: '' };
+    }
+  }
+
   // 重置 Cloudflare 隧道：关闭隧道 + 删除已下载的 cloudflared 二进制
   async resetCloudflared() {
     await this.stopCloudflared();
@@ -1581,8 +1615,9 @@ class BridgeService {
   }
 
   async dispose() {
-    this.stopCustomTunnel();
-    this.stopCloudflared();
+    await this._haltCustomTunnel();
+    // 只停进程与状态，不改持久化：插件卸载/重载不应悄悄抹掉用户的 autoStart 意图
+    await this._haltCloudflared();
     if (this.proxy) {
       await this.proxy.stop();
       this.proxy = null;

package/lib/platform/base.js

@@ -1,147 +1,147 @@
-// dsh-bridge 平台抽象基类
-//
-// 定义 IM 平台适配器的统一接口。每个平台（微信/QQ/飞书/Telegram…）继承本类，
-// 实现协议层（登录、收发消息、typing）。平台无关的会话桥逻辑在 ConversationBridge
-// （lib/platform/conversation-bridge.js）中实现，通过 platform 注入到 bridge。
-//
-// 生命周期：constructor → start() → stop() → dispose()
-// 消息抽象：sendText / sendTyping / sendMedia（由子类实现）
-
-export class Platform {
-  /**
-   * @param {object} opts
-   * @param {object} opts.ctx          Cordis 上下文
-   * @param {object} opts.logger       日志器
-   * @param {object} [opts.config]     已持久化的平台配置（凭证等）
-   * @param {(patch: object) => (void|Promise<void>)} [opts.onPersist]  主插件保存回调
-   * @param {import('./conversation-bridge.js').ConversationBridge} [opts.bridge] 会话桥实例
-   */
-  constructor({ ctx, logger, config = {}, onPersist, bridge } = {}) {
-    this.ctx = ctx
-    this.logger = logger
-    this.config = { ...config }
-    this.onPersist = onPersist ?? (() => {})
-    this.bridge = bridge ?? null
-
-    // 平台标识（子类必须设置）
-    this.id = ''
-    this.name = ''
-
-    // 连接状态与账号：子类可能用 getter 覆盖（如委托给 gateway），
-    // 因此仅在未被子类覆盖时才初始化默认值。
-    if (!('status' in this)) this.status = 'idle'
-    if (!('accountId' in this)) this.accountId = null
-
-    // 扫码/登录的流式状态（RPC 轮询读取）
-    this.loginState = {
-      phase: 'idle',   // idle | qr | scaned | confirmed | done | error
-      qrPayload: null, // 待渲染内容：dataURL 图片 或 二维码文本
-      qrKind: null,    // 'img' | 'text'
-      error: null,
-    }
-
-    this.disposers = []
-  }
-
-  // ---- 平台能力声明（子类可覆盖）----
-
-  get capabilities() {
-    return {
-      supportsGroup: false,   // 是否支持群聊
-      supportsMedia: false,   // 是否支持媒体收发
-      supportsVoice: false,   // 是否支持语音
-      supportsTyping: false,  // 是否支持 typing 状态
-      maxMessageChars: 2000,  // 单条消息最大字符数
-    }
-  }
-
-  get configured() {
-    return false
-  }
-
-  // ---- 生命周期（子类必须实现 start/stop；dispose 已提供默认实现）----
-
-  async start() {
-    throw new Error(`${this.id || 'platform'}: start() not implemented`)
-  }
-
-  async stop() {
-    throw new Error(`${this.id || 'platform'}: stop() not implemented`)
-  }
-
-  dispose() {
-    for (const disposer of this.disposers) {
-      try { disposer() } catch { /* 忽略 */ }
-    }
-    this.disposers = []
-    this.bridge?.dispose?.()
-    this.bridge = null
-  }
-
-  // ---- 消息抽象（子类必须实现）----
-
-  async sendText(peerId, text, opts = {}) {
-    throw new Error(`${this.id || 'platform'}: sendText() not implemented`)
-  }
-
-  async sendTyping(peerId, state) {
-    return Promise.resolve()
-  }
-
-  async sendMedia(peerId, media, opts = {}) {
-    throw new Error(`${this.id || 'platform'}: sendMedia() not implemented`)
-  }
-
-  // ---- 登录（子类必须实现 login；getLoginState 已提供默认）----
-
-  async login(opts = {}) {
-    throw new Error(`${this.id || 'platform'}: login() not implemented`)
-  }
-
-  getLoginState() {
-    return { ...this.loginState }
-  }
-
-  // ---- 状态汇总（供 RPC/UI 读取）----
-
-  getStatus() {
-    return {
-      id: this.id,
-      name: this.name,
-      status: this.status,
-      configured: this.configured,
-      accountId: this.accountId,
-      login: this.getLoginState(),
-      peerId: this.bridge?.peerId ?? null,
-      sessionId: this.bridge?.activeSessionId ?? null,
-      config: this.getEditableConfig?.(),
-    }
-  }
-
-  /** 可编辑配置（供 UI 设置面板读取）；子类可覆盖返回具体字段。 */
-  getEditableConfig() {
-    return {}
-  }
-
-  // ---- 工具 ----
-
-  setStatus(status) {
-    if (this.status === status) return
-    this.status = status
-    try {
-      this.ctx.emit?.(`${this.id}/status`, status)
-    } catch { /* emit 失败不致命 */ }
-  }
-
-  async persist(patch) {
-    try {
-      await this.onPersist(patch)
-    } catch (err) {
-      this.logger?.warn?.(`[dsh-bridge ${this.id}] persist failed: %s`, err?.message ?? err)
-    }
-  }
-
-  async destroy() {
-    this.dispose()
-  }
-}
+// dsh-bridge 平台抽象基类
+//
+// 定义 IM 平台适配器的统一接口。每个平台（微信/QQ/飞书/Telegram…）继承本类，
+// 实现协议层（登录、收发消息、typing）。平台无关的会话桥逻辑在 ConversationBridge
+// （lib/platform/conversation-bridge.js）中实现，通过 platform 注入到 bridge。
+//
+// 生命周期：constructor → start() → stop() → dispose()
+// 消息抽象：sendText / sendTyping / sendMedia（由子类实现）
+
+export class Platform {
+  /**
+   * @param {object} opts
+   * @param {object} opts.ctx          Cordis 上下文
+   * @param {object} opts.logger       日志器
+   * @param {object} [opts.config]     已持久化的平台配置（凭证等）
+   * @param {(patch: object) => (void|Promise<void>)} [opts.onPersist]  主插件保存回调
+   * @param {import('./conversation-bridge.js').ConversationBridge} [opts.bridge] 会话桥实例
+   */
+  constructor({ ctx, logger, config = {}, onPersist, bridge } = {}) {
+    this.ctx = ctx
+    this.logger = logger
+    this.config = { ...config }
+    this.onPersist = onPersist ?? (() => {})
+    this.bridge = bridge ?? null
+
+    // 平台标识（子类必须设置）
+    this.id = ''
+    this.name = ''
+
+    // 连接状态与账号：子类可能用 getter 覆盖（如委托给 gateway），
+    // 因此仅在未被子类覆盖时才初始化默认值。
+    if (!('status' in this)) this.status = 'idle'
+    if (!('accountId' in this)) this.accountId = null
+
+    // 扫码/登录的流式状态（RPC 轮询读取）
+    this.loginState = {
+      phase: 'idle',   // idle | qr | scaned | confirmed | done | error
+      qrPayload: null, // 待渲染内容：dataURL 图片 或 二维码文本
+      qrKind: null,    // 'img' | 'text'
+      error: null,
+    }
+
+    this.disposers = []
+  }
+
+  // ---- 平台能力声明（子类可覆盖）----
+
+  get capabilities() {
+    return {
+      supportsGroup: false,   // 是否支持群聊
+      supportsMedia: false,   // 是否支持媒体收发
+      supportsVoice: false,   // 是否支持语音
+      supportsTyping: false,  // 是否支持 typing 状态
+      maxMessageChars: 2000,  // 单条消息最大字符数
+    }
+  }
+
+  get configured() {
+    return false
+  }
+
+  // ---- 生命周期（子类必须实现 start/stop；dispose 已提供默认实现）----
+
+  async start() {
+    throw new Error(`${this.id || 'platform'}: start() not implemented`)
+  }
+
+  async stop() {
+    throw new Error(`${this.id || 'platform'}: stop() not implemented`)
+  }
+
+  dispose() {
+    for (const disposer of this.disposers) {
+      try { disposer() } catch { /* 忽略 */ }
+    }
+    this.disposers = []
+    this.bridge?.dispose?.()
+    this.bridge = null
+  }
+
+  // ---- 消息抽象（子类必须实现）----
+
+  async sendText(peerId, text, opts = {}) {
+    throw new Error(`${this.id || 'platform'}: sendText() not implemented`)
+  }
+
+  async sendTyping(peerId, state) {
+    return Promise.resolve()
+  }
+
+  async sendMedia(peerId, media, opts = {}) {
+    throw new Error(`${this.id || 'platform'}: sendMedia() not implemented`)
+  }
+
+  // ---- 登录（子类必须实现 login；getLoginState 已提供默认）----
+
+  async login(opts = {}) {
+    throw new Error(`${this.id || 'platform'}: login() not implemented`)
+  }
+
+  getLoginState() {
+    return { ...this.loginState }
+  }
+
+  // ---- 状态汇总（供 RPC/UI 读取）----
+
+  getStatus() {
+    return {
+      id: this.id,
+      name: this.name,
+      status: this.status,
+      configured: this.configured,
+      accountId: this.accountId,
+      login: this.getLoginState(),
+      peerId: this.bridge?.peerId ?? null,
+      sessionId: this.bridge?.activeSessionId ?? null,
+      config: this.getEditableConfig?.(),
+    }
+  }
+
+  /** 可编辑配置（供 UI 设置面板读取）；子类可覆盖返回具体字段。 */
+  getEditableConfig() {
+    return {}
+  }
+
+  // ---- 工具 ----
+
+  setStatus(status) {
+    if (this.status === status) return
+    this.status = status
+    try {
+      this.ctx.emit?.(`${this.id}/status`, status)
+    } catch { /* emit 失败不致命 */ }
+  }
+
+  async persist(patch) {
+    try {
+      await this.onPersist(patch)
+    } catch (err) {
+      this.logger?.warn?.(`[dsh-bridge ${this.id}] persist failed: %s`, err?.message ?? err)
+    }
+  }
+
+  async destroy() {
+    this.dispose()
+  }
+}