@wenbin_wb/dsh-bridge 2.10.15 → 2.11.0

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'