@wenbin_wb/dsh-bridge 1.2.4 → 2.0.0

package/lib/platform/index.js

@@ -0,0 +1,10 @@
+// dsh-bridge 平台抽象层统一导出
+//
+// 提供多平台 IM 接入的基础设施：
+//   Platform             平台适配器基类（协议/连接/登录/收发消息）
+//   ConversationBridge   平台无关会话桥（白名单/会话/审批/命令/digest）
+//   PlatformManager      多平台注册与状态聚合
+
+export { Platform } from './base.js'
+export { ConversationBridge, conversationBridgeHelpers, BRIDGE_MARK, textOfAssistantMessage } from './conversation-bridge.js'
+export { PlatformManager } from './manager.js'

package/lib/platform/manager.js

@@ -0,0 +1,74 @@
+// dsh-bridge 平台管理器
+//
+// 注册/协调多个 IM 平台适配器（Platform 子类），向主插件与 RPC 层提供：
+//   - 统一的多平台状态聚合（getStatus）
+//   - 平台实例查找（get）
+//   - 统一生命周期（dispose）
+//
+// 主插件注入已构造的平台实例列表，本类只负责登记与聚合，不负责构造平台。
+
+export class PlatformManager {
+  /**
+   * @param {object} opts
+   * @param {object} opts.logger       日志器
+   */
+  constructor({ logger } = {}) {
+    this.logger = logger
+    this.platforms = new Map() // platformId -> Platform
+  }
+
+  /** 注册一个平台实例。重复注册同 id 时替换旧实例并 dispose 旧的。 */
+  register(platform) {
+    if (!platform || !platform.id) {
+      this.logger?.warn?.('[dsh-bridge] PlatformManager.register: 平台缺少 id，已忽略')
+      return platform
+    }
+    const existing = this.platforms.get(platform.id)
+    if (existing && existing !== platform) {
+      try {
+        const result = existing.dispose()
+        if (result instanceof Promise) {
+          // 异步 dispose，记录警告（当前架构假定同步清理）
+          this.logger?.warn?.(`[dsh-bridge] Platform ${platform.id} dispose is async but not awaited (may leave dangling resources)`)
+        }
+      } catch { /* 忽略 */ }
+    }
+    this.platforms.set(platform.id, platform)
+    this.logger?.info?.(`[dsh-bridge] platform registered: ${platform.id} (${platform.name ?? ''})`)
+    return platform
+  }
+
+  /** 获取平台实例；不存在返回 undefined。 */
+  get(platformId) {
+    return this.platforms.get(platformId)
+  }
+
+  /** 所有已注册平台 id。 */
+  list() {
+    return [...this.platforms.values()]
+  }
+
+  /** 聚合所有平台状态：{ [platformId]: status }。 */
+  getStatus() {
+    const out = {}
+    for (const [id, platform] of this.platforms) {
+      try {
+        out[id] = platform.getStatus()
+      } catch (err) {
+        // 防御性读取 platform.name（getter 可能抛异常）
+        let name = id
+        try { name = platform.name ?? id } catch { /* 忽略 */ }
+        out[id] = { id, name, status: 'error', error: err?.message ?? String(err) }
+      }
+    }
+    return out
+  }
+
+  /** 释放所有平台。 */
+  dispose() {
+    for (const platform of this.platforms.values()) {
+      try { platform.dispose() } catch { /* 忽略 */ }
+    }
+    this.platforms.clear()
+  }
+}

package/lib/wechat/index.js

@@ -1,15 +1,19 @@
-// dsh-bridge WeChat coordinator
+// dsh-bridge WeChat platform adapter
 //
 // 编排 WechatGateway（iLink 网关，注册为 ctx.wechat 服务）+ WechatConversationNode
-// （微信⇄DSH 会话桥）。对外暴露给 bridge-rpc 的接口：status / login / stop / setAllowFrom。
+// （微信⇄DSH 会话桥）。作为 Platform 子类，可注册进 PlatformManager 统一管理。
+//
+// 对外暴露给 bridge-rpc 的接口（与 v1.x 完全兼容）：getStatus / login / stop /
+// setAllowFrom / setConfig / unbind / destroy。
 //
 // 持久化策略：凭证（token/accountId/baseUrl）与配置（allowFrom/间隔）由主插件通过回调
 // `onPersist` 保存在 $DSH_HOME/dsh-bridge/config.json。本服务不直接碰文件系统。
 
-import { WechatGateway } from './gateway.js'
+import { Platform } from '../platform/base.js'
+import { WechatGateway, gatewayConstants } from './gateway.js'
 import { WechatConversationNode } from './node.js'
 
-export class WechatService {
+export class WechatService extends Platform {
   /**
    * @param {object} opts
    * @param {object} opts.ctx          Cordis 上下文
@@ -18,17 +22,9 @@ export class WechatService {
    * @param {(patch: object) => (void|Promise<void>)} opts.onPersist  主插件保存回调
    */
   constructor({ ctx, logger, config = {}, onPersist }) {
-    this.ctx = ctx
-    this.logger = logger
-    this.onPersist = onPersist ?? (() => {})
-
-    // 扫码登录的流式状态（RPC 轮询读取）
-    this.loginState = {
-      phase: 'idle',     // idle | qr | scaned | confirmed | done | error
-      qrPayload: null,   // 待渲染内容：dataURL 图片 或 二维码文本
-      qrKind: null,      // 'img' | 'text'
-      error: null,
-    }
+    super({ ctx, logger, config, onPersist })
+    this.id = 'wechat'
+    this.name = '微信'
 
     this.gateway = new WechatGateway({
       ctx,
@@ -51,18 +47,50 @@ export class WechatService {
       onFirstSender: (senderId) => this.persist({ allowFrom: [senderId] }),
       onActiveSessionChange: (sessionId) => this.persist({ activeSessionId: sessionId }), // v0.2.1：持久化活动会话
     })
+    this.bridge = this.node
 
     if (this.gateway.configured) {
-      void this.gateway.start().catch((err) => {
+      void this.start().catch((err) => {
         this.logger.error('[dsh-bridge wechat] start failed: %s', err?.message ?? err)
       })
     }
   }
 
-  /** 合并展示状态给浏览器 UI。 */
+  // ---- Platform 接口 ----
+
+  get configured() { return this.gateway.configured }
+  get accountId() { return this.gateway.accountId }
+  get baseUrl() { return this.gateway.baseUrl }
+
+  get capabilities() {
+    return {
+      supportsGroup: false, // v0.1 不处理群消息
+      supportsMedia: true,
+      supportsVoice: true,
+      supportsTyping: true,
+      maxMessageChars: this.node.config.maxMessageChars ?? gatewayConstants.MAX_MESSAGE_CHARS,
+    }
+  }
+
+  /** 消息抽象：委托 gateway（供 PlatformManager/未来多平台统一调用）。 */
+  async sendText(peerId, text, opts = {}) {
+    return this.gateway.sendText(peerId, text, opts.clientId)
+  }
+
+  async sendTyping(peerId, state) {
+    return this.gateway.sendTyping(peerId, state)
+  }
+
+  async sendMedia(peerId, media, opts = {}) {
+    return this.gateway.sendMedia({ ...media, to: peerId, ...opts })
+  }
+
+  /** 合并展示状态给浏览器 UI（保持 v1.x 字段结构，新增 id/name/capabilities）。 */
   getStatus() {
     const allowFrom = [...(this.node.config.allowFrom ?? [])]
     return {
+      id: this.id,
+      name: this.name,
       status: this.gateway.status,
       configured: this.gateway.configured,
       accountId: this.gateway.accountId,
@@ -71,6 +99,7 @@ export class WechatService {
       sessionId: this.node.activeSessionId,
       baseUrl: this.gateway.baseUrl,
       login: { ...this.loginState },
+      capabilities: { ...this.capabilities },
       // 可编辑配置（供 UI 设置面板读取）
       config: {
         digestIntervalSec: this.node.config.digestIntervalSec,
@@ -81,6 +110,42 @@ export class WechatService {
     }
   }
 
+  /** 可编辑配置（供通用 PlatformPanel 读取）。 */
+  getEditableConfig() {
+    return {
+      digestIntervalSec: this.node.config.digestIntervalSec,
+      approvalTimeoutSec: this.node.config.approvalTimeoutSec,
+      maxMessageChars: this.node.config.maxMessageChars,
+      sendChunkDelayMs: this.node.config.sendChunkDelayMs,
+    }
+  }
+
+  /** 启动网关轮询（凭证已配置时生效）。 */
+  async start() {
+    if (!this.gateway.configured) {
+      this.setStatus('idle')
+      return
+    }
+    await this.gateway.start()
+  }
+
+  /** 停止网关轮询（保留凭证与配置）。 */
+  async stop() {
+    await this.gateway.stop()
+  }
+
+  /** 完整关停（dispose 时调用）。 */
+  async dispose() {
+    await this.gateway.stop()
+    this.gateway.dispose()
+    super.dispose() // 清理 node (bridge) + disposers
+  }
+
+  /** 兼容 v1.x 的别名（主插件 ctx.effect 调用）。 */
+  async destroy() {
+    await this.dispose()
+  }
+
   /**
    * 发起扫码登录（后台执行，状态通过 getStatus/loginState 轮询读取）。
    * @param {object} [opts]
@@ -138,11 +203,6 @@ export class WechatService {
     this.loginState = { phase: 'done', qrPayload: null, qrKind: null, error: null }
   }
 
-  /** 停止网关轮询（保留凭证与配置）。 */
-  async stop() {
-    await this.gateway.stop()
-  }
-
   /** 解绑：停止网关并清除凭证（token/accountId），下次重启不再自动重连。 */
   async unbind() {
     await this.gateway.stop()
@@ -171,19 +231,4 @@ export class WechatService {
       sendChunkDelayMs:   this.node.config.sendChunkDelayMs,
     })
   }
-
-  /** 完整关停（dispose 时调用）。 */
-  async destroy() {
-    await this.gateway.stop()
-    this.gateway.dispose()
-    this.node.dispose()
-  }
-
-  async persist(patch) {
-    try {
-      await this.onPersist(patch)
-    } catch (err) {
-      this.logger.warn('[dsh-bridge wechat] persist failed: %s', err?.message ?? err)
-    }
-  }
 }