@wenbin_wb/dsh-bridge 2.11.0 → 2.11.2

package/lib/index.js

@@ -10,7 +10,7 @@ import { get as httpsGet } from 'node:https';
 import { networkInterfaces, homedir, totalmem, freemem, cpus, loadavg, platform, arch, release, hostname, uptime } from 'node:os';
 import { join, dirname, basename, resolve, normalize } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { readFileSync, appendFileSync, existsSync, realpathSync } from 'node:fs';
+import { readFileSync, appendFileSync, existsSync, realpathSync, mkdirSync } from 'node:fs';
 import { readFile, writeFile, mkdir, unlink, readdir, stat, access } from 'node:fs/promises';
 import { spawn } from 'node:child_process';
 import QRCode from 'qrcode';
@@ -278,12 +278,18 @@ function sanitizeProxyHeaders(headers, extra) {
  * @returns {string} 单元名，取不到返回空串
  */
 export function parseSystemdUnit(cgroup) {
-  const parts = String(cgroup || '').split('/').filter(Boolean);
-  // 只认**最内层**组件：若最内层不是 .service（例如 .scope、或 docker/k8s 的容器目录），
-  // 说明本进程不是被某个 service 直接托管，绝不能向上游误取祖先单元
-  // （否则会把 docker.service / cron.service 之类重启掉）。
-  const innermost = parts[parts.length - 1] ?? '';
-  return innermost.endsWith('.service') ? innermost : '';
+  const lines = String(cgroup || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  for (const line of lines) {
+    const parts = line.split('/').map((p) => p.trim()).filter(Boolean);
+    // 只认**最内层**组件：若最内层不是 .service（例如 .scope、或 docker/k8s 的容器目录），
+    // 说明本进程不是被某个 service 直接托管，绝不能向上游误取祖先单元
+    // （否则会把 docker.service / cron.service 之类重启掉）。
+    const innermost = parts[parts.length - 1] ?? '';
+    if (innermost.endsWith('.service')) {
+      return innermost;
+    }
+  }
+  return '';
 }
 
 /**
@@ -304,8 +310,8 @@ export function detectSupervisor({ env = process.env, cgroup = '' } = {}) {
   const systemdMarked = Boolean(env.INVOCATION_ID || env.JOURNAL_STREAM) || text.includes('.slice');
   const unit = systemdMarked ? parseSystemdUnit(text) : '';
   if (unit) {
-    const parts = text.split('/').filter(Boolean);
-    return { kind: 'systemd', scope: parts.includes('user.slice') ? 'user' : 'system', unit, reason: 'cgroup 检出 systemd 单元' };
+    const isUser = text.includes('user.slice') || text.includes('/user@');
+    return { kind: 'systemd', scope: isUser ? 'user' : 'system', unit, reason: 'cgroup 检出 systemd 单元' };
   }
   return { kind: 'self', reason: '未检出托管器（无 DSH_DAEMON/PM2_HOME，也不在 systemd 单元内）' };
 }
@@ -1379,6 +1385,7 @@ class BridgeService {
     const dshHome = env.DSH_HOME ?? join(homedir(), '.dsh');
     const logFile = join(dshHome, 'dsh-bridge', 'restart.log');
     const childLog = join(dshHome, 'dsh-bridge', 'restart-child.log');
+    try { mkdirSync(dirname(logFile), { recursive: true }); } catch { /* 日志目录不可写时忽略 */ }
     const writeLog = (message) => {
       try { appendFileSync(logFile, `[${new Date().toISOString()}] ${message}\n`); } catch { /* 日志不可写时忽略 */ }
     };
@@ -1389,18 +1396,36 @@ class BridgeService {
 
     if (plan.kind === 'systemd') {
       const args = [...(plan.scope === 'user' ? ['--user'] : []), 'restart', '--no-block', plan.unit];
+      const systemctlEnv = { ...env };
+      if (process.platform === 'linux') {
+        const defaultPaths = ['/usr/local/bin', '/usr/bin', '/bin', '/usr/local/sbin', '/usr/sbin', '/sbin'];
+        const existingPath = systemctlEnv.PATH || '';
+        const missingPaths = defaultPaths.filter((p) => !existingPath.split(':').includes(p));
+        if (missingPaths.length > 0) {
+          systemctlEnv.PATH = existingPath ? `${existingPath}:${missingPaths.join(':')}` : missingPaths.join(':');
+        }
+        if (plan.scope === 'user' && !systemctlEnv.XDG_RUNTIME_DIR && typeof process.getuid === 'function') {
+          systemctlEnv.XDG_RUNTIME_DIR = `/run/user/${process.getuid()}`;
+        }
+      }
       // 关键：必须以 **systemctl 的退出码** 判定成败，而不是"派生成功"。
       // `--no-block` 下 systemctl 只发请求就返回（实测往返 ~6ms），但单元名不存在会 rc=5、
       // 权限不足会 rc=1；旧写法只看 'spawn' 事件 → 必然失败也返回 ok:true 再 exit(0)，
       // 而干净退出不满足 Restart=on-failure → DSH 直接下线且不自动拉起。
       const outcome = await new Promise((resolve) => {
         let settled = false;
-        const settle = (value) => { if (!settled) { settled = true; resolve(value); } };
+        const timer = setTimeout(() => settle({ error: new Error('systemctl 执行超时（5s）') }), 5000);
+        const settle = (value) => {
+          if (!settled) {
+            settled = true;
+            clearTimeout(timer);
+            resolve(value);
+          }
+        };
         try {
-          const child = spawnImpl('systemctl', args, { detached: true, stdio: 'ignore', env });
+          const child = spawnImpl('systemctl', args, { detached: true, stdio: 'ignore', env: systemctlEnv });
           child.once?.('error', (err) => settle({ error: err }));
           child.once?.('close', (code) => settle({ code }));
-          child.unref?.();
         } catch (err) {
           settle({ error: err });
         }

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()
+  }
+}

package/lib/platform/dsh-storage.js

@@ -1,117 +1,117 @@
-// DSH 私有存储读取（workspace.json / session_projcache.json 兜底）
-// 自 conversation-bridge.js 拆出。策略：内存服务（workspaceRegistry）优先，
-// 仅当内存服务缺失时才落盘读 DSH 存储；文件不存在时安全返回空值。
-// 注意：不再以 ctx._mock 作为跳过依据——测试通过提供内存服务或注入 DSH_HOME 保持隔离。
-import { existsSync, readFileSync } from 'node:fs'
-import { join, basename } from 'node:path'
-import { homedir } from 'node:os'
-
-export function getArchivedSessionIds(ctx) {
-  const archived = new Set()
-  // 1. 尝试从 ctx.workspaceRegistry 内存服务读取
-  try {
-    const list = ctx?.workspaceRegistry?.archivedSessionIds
-    if (Array.isArray(list)) {
-      for (const id of list) {
-        if (id) archived.add(String(id))
-      }
-      return archived
-    }
-  } catch { /* ignore */ }
-
-  // 2. 尝试从 DSH workspace 存储文件（$DSH_HOME/storages/workspace.json）读取兜底
-  {
-    try {
-      const home = process.env.DSH_HOME || join(homedir(), '.dsh')
-      const wsFile = join(home, 'storages', 'workspace.json')
-      if (existsSync(wsFile)) {
-        const data = JSON.parse(readFileSync(wsFile, 'utf8'))
-        const fileArchived = data?.global?.archivedSessionIds
-        if (Array.isArray(fileArchived)) {
-          for (const id of fileArchived) {
-            if (id) archived.add(String(id))
-          }
-        }
-      }
-    } catch { /* ignore */ }
-  }
-
-  return archived
-}
-
-/**
- * 安全探测 ctx 上的非 inject 属性。
- * 宿主 cordis 上下文对插件未在 inject 中声明的属性读取会直接抛错
- * （'cannot get property "x" without inject'），因此内存注入点（测试夹具用）
- * 必须经 try/catch 探测，绝不能让异常外溢到命令路径。
- */
-function peekCtxProperty(ctx, key) {
-  if (!ctx) return undefined
-  try { return ctx[key] } catch { return undefined }
-}
-
-/** 读取 DSH 官方持久化会话缓存元数据（标题、是否空白、创建时间等） */
-export function getSessionProjCache(ctx) {
-  const injected = peekCtxProperty(ctx, 'sessionProjCache')
-  if (injected) return injected
-  try {
-    const home = process.env.DSH_HOME || join(homedir(), '.dsh')
-    const cacheFile = join(home, 'storages', 'session_projcache.json')
-    if (existsSync(cacheFile)) {
-      const data = JSON.parse(readFileSync(cacheFile, 'utf8'))
-      return data?.tables?.sessions || {}
-    }
-  } catch { /* ignore */ }
-  return {}
-}
-
-/** 读取 DSH 官方注册的工作区列表及各自绑定的 sessionIds 列表 */
-export async function getRegisteredWorkspaces(ctx) {
-  const workspaces = []
-
-  // 优先从内存服务获取
-  if (ctx?.workspaceRegistry) {
-    try {
-      const list = await ctx.workspaceRegistry.list?.()
-      if (Array.isArray(list)) {
-        for (const w of list) {
-          if (w && w.path) {
-            workspaces.push({
-              id: w.id || w.path,
-              path: w.path,
-              title: w.title || basename(w.path),
-              sessionIds: Array.isArray(w.sessionIds) ? [...w.sessionIds] : [],
-            })
-          }
-        }
-        return workspaces
-      }
-    } catch { /* ignore */ }
-  }
-
-  // 兜底从 workspace.json 存储文件读取
-  {
-    try {
-      const home = process.env.DSH_HOME || join(homedir(), '.dsh')
-      const wsFile = join(home, 'storages', 'workspace.json')
-      if (existsSync(wsFile)) {
-        const data = JSON.parse(readFileSync(wsFile, 'utf8'))
-        const wsIds = data?.global?.workspaceIds || Object.keys(data?.tables?.workspaces || {})
-        const table = data?.tables?.workspaces || {}
-        for (const wId of wsIds) {
-          const ws = table[wId]
-          if (ws && ws.path) {
-            workspaces.push({
-              id: wId,
-              path: ws.path,
-              title: ws.title || basename(ws.path),
-              sessionIds: Array.isArray(ws.sessionIds) ? [...ws.sessionIds] : [],
-            })
-          }
-        }
-      }
-    } catch { /* ignore */ }
-  }
-
-  return workspaces
-}
+// DSH 私有存储读取（workspace.json / session_projcache.json 兜底）
+// 自 conversation-bridge.js 拆出。策略：内存服务（workspaceRegistry）优先，
+// 仅当内存服务缺失时才落盘读 DSH 存储；文件不存在时安全返回空值。
+// 注意：不再以 ctx._mock 作为跳过依据——测试通过提供内存服务或注入 DSH_HOME 保持隔离。
+import { existsSync, readFileSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import { homedir } from 'node:os'
+
+export function getArchivedSessionIds(ctx) {
+  const archived = new Set()
+  // 1. 尝试从 ctx.workspaceRegistry 内存服务读取
+  try {
+    const list = ctx?.workspaceRegistry?.archivedSessionIds
+    if (Array.isArray(list)) {
+      for (const id of list) {
+        if (id) archived.add(String(id))
+      }
+      return archived
+    }
+  } catch { /* ignore */ }
+
+  // 2. 尝试从 DSH workspace 存储文件（$DSH_HOME/storages/workspace.json）读取兜底
+  {
+    try {
+      const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+      const wsFile = join(home, 'storages', 'workspace.json')
+      if (existsSync(wsFile)) {
+        const data = JSON.parse(readFileSync(wsFile, 'utf8'))
+        const fileArchived = data?.global?.archivedSessionIds
+        if (Array.isArray(fileArchived)) {
+          for (const id of fileArchived) {
+            if (id) archived.add(String(id))
+          }
+        }
+      }
+    } catch { /* ignore */ }
+  }
+
+  return archived
+}
+
+/**
+ * 安全探测 ctx 上的非 inject 属性。
+ * 宿主 cordis 上下文对插件未在 inject 中声明的属性读取会直接抛错
+ * （'cannot get property "x" without inject'），因此内存注入点（测试夹具用）
+ * 必须经 try/catch 探测，绝不能让异常外溢到命令路径。
+ */
+function peekCtxProperty(ctx, key) {
+  if (!ctx) return undefined
+  try { return ctx[key] } catch { return undefined }
+}
+
+/** 读取 DSH 官方持久化会话缓存元数据（标题、是否空白、创建时间等） */
+export function getSessionProjCache(ctx) {
+  const injected = peekCtxProperty(ctx, 'sessionProjCache')
+  if (injected) return injected
+  try {
+    const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+    const cacheFile = join(home, 'storages', 'session_projcache.json')
+    if (existsSync(cacheFile)) {
+      const data = JSON.parse(readFileSync(cacheFile, 'utf8'))
+      return data?.tables?.sessions || {}
+    }
+  } catch { /* ignore */ }
+  return {}
+}
+
+/** 读取 DSH 官方注册的工作区列表及各自绑定的 sessionIds 列表 */
+export async function getRegisteredWorkspaces(ctx) {
+  const workspaces = []
+
+  // 优先从内存服务获取
+  if (ctx?.workspaceRegistry) {
+    try {
+      const list = await ctx.workspaceRegistry.list?.()
+      if (Array.isArray(list)) {
+        for (const w of list) {
+          if (w && w.path) {
+            workspaces.push({
+              id: w.id || w.path,
+              path: w.path,
+              title: w.title || basename(w.path),
+              sessionIds: Array.isArray(w.sessionIds) ? [...w.sessionIds] : [],
+            })
+          }
+        }
+        return workspaces
+      }
+    } catch { /* ignore */ }
+  }
+
+  // 兜底从 workspace.json 存储文件读取
+  {
+    try {
+      const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+      const wsFile = join(home, 'storages', 'workspace.json')
+      if (existsSync(wsFile)) {
+        const data = JSON.parse(readFileSync(wsFile, 'utf8'))
+        const wsIds = data?.global?.workspaceIds || Object.keys(data?.tables?.workspaces || {})
+        const table = data?.tables?.workspaces || {}
+        for (const wId of wsIds) {
+          const ws = table[wId]
+          if (ws && ws.path) {
+            workspaces.push({
+              id: wId,
+              path: ws.path,
+              title: ws.title || basename(ws.path),
+              sessionIds: Array.isArray(ws.sessionIds) ? [...ws.sessionIds] : [],
+            })
+          }
+        }
+      }
+    } catch { /* ignore */ }
+  }
+
+  return workspaces
+}

package/lib/platform/index.js

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