@wenbin_wb/dsh-bridge 2.8.6 → 2.9.0

package/lib/platform/base.js

@@ -1,156 +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)
-    }
-  }
-
-  dispose() {
-    for (const d of this.disposers) {
-      try { d() } catch {}
-    }
-    this.disposers = []
-    this.bridge?.dispose?.()
-    this.bridge = null
-  }
-
-  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/commands.js

@@ -0,0 +1,221 @@
+// 斜杠命令解释器（/sessions /use /new /workspaces /status /help …）
+// 自 conversation-bridge.js 拆出。routeCommand(node, text, senderId) 只通过 node 参数
+// 访问会话桥能力，目录/渲染逻辑来自 session-catalog.js。
+import {
+  listSessions, listWorkspaces, validateWorkspacePath, renderSessions,
+  sessionsInDisplayOrder, describeTurnEnd, helpText, fmtTime, fmtSessionId,
+  sessionLabel, getWorkspaceBasename,
+} from './session-catalog.js'
+import { isSafeWorkspacePath } from '../security/path-validator.js'
+import { basename, normalize } from 'node:path'
+
+export async function routeCommand(node, text, senderId = null) {
+  const trimmed = text.trim()
+
+  if (trimmed === '/yes' || trimmed === '/no' || /^[12]$/.test(trimmed)) {
+    if (node.resolveApproval(trimmed, senderId)) return true
+  }
+
+  if (!trimmed.startsWith('/')) return false
+
+  const [command, ...rest] = trimmed.slice(1).split(/\s+/)
+  switch (command) {
+    case 'help':
+      await node.sendText(helpText())
+      return true
+    case 'sessions':
+    case 'list':
+      await node.sendText(await renderSessions(node))
+      return true
+    case 'use':
+    case 'resume': {
+      const index = Number(rest[0])
+      const sessions = sessionsInDisplayOrder(await listSessions(node))
+      if (!Number.isInteger(index) || index < 1 || index > sessions.length) {
+        await node.sendText(`❌ **无效会话编号**：\`${rest[0] ?? ''}\`\n\n> 可用编号范围：\`1 – ${sessions.length}\`（发送 \`/sessions\` 查看会话列表）`)
+        return true
+      }
+      const session = sessions[index - 1]
+      node.setActiveSessionById(session.id)
+      const title = session.title || (session.events ? sessionLabel(session) : '')
+      const titleLine = title ? `\n- **标题**：${title}` : ''
+      await node.sendText(`✓ **已切换到会话 #${index}**${titleLine}\n- **会话 ID**：\`${fmtSessionId(session.id)}\``)
+      return true
+    }
+    case 'rename': {
+      if (!node.activeSessionId) {
+        await node.sendText(`❌ **当前没有活动会话**\n\n> 请先使用 \`/sessions\` 查看会话列表并通过 \`/use 编号\` 切换到目标会话，或通过 \`/new <提示词>\` 创建新会话。`)
+        return true
+      }
+      const newTitle = rest.join(' ').trim()
+      if (!newTitle) {
+        await node.sendText(`❌ **缺少新标题参数**\n\n> 用法：\`/rename <新标题>\`\n> 示例：\`/rename 优化登录交互逻辑\``)
+        return true
+      }
+
+      try {
+        const session = node.activeSession()
+        if (session) {
+          session.title = newTitle
+        }
+        if (node.ctx.sessionPersistence?.update) {
+          await node.ctx.sessionPersistence.update(node.activeSessionId, { title: newTitle }).catch(() => {})
+        }
+        await node.sendText(`✓ **会话重命名成功**\n- **会话 ID**：\`${fmtSessionId(node.activeSessionId)}\`\n- **新标题**：${newTitle}`)
+      } catch (err) {
+        await node.sendText(`❌ **重命名失败**：${err instanceof Error ? err.message : String(err)}`)
+      }
+      return true
+    }
+    case 'workspaces': {
+      const workspaces = await listWorkspaces(node)
+      if (workspaces.length === 0) {
+        await node.sendText(`## 🗂️ 可用工作区\n\n> 当前没有已注册的工作区。可使用 \`/new <提示词> @<路径>\` 指定项目目录。`)
+        return true
+      }
+      const rows = workspaces.map((w, i) => {
+        const titleStr = w.title && w.title !== w.path ? w.title : getWorkspaceBasename(w.path)
+        const safeTitle = titleStr.replace(/\|/g, '｜')
+        return `| **@${i + 1}** | ${safeTitle} | \`${w.path}\` |`
+      })
+      await node.sendText([
+        `## 🗂️ 可用工作区 (共 ${workspaces.length} 个)`,
+        `> 新建会话：发送 \`/new <提示词> @序号\` 或 \`/new <提示词> @路径\``,
+        '',
+        '| 序号 | 工作区名称 | 目录路径 |',
+        '| :--- | :--- | :--- |',
+        ...rows,
+      ].join('\n'))
+      return true
+    }
+    case 'addworkspace': {
+      const targetPath = rest.join(' ').trim()
+      if (!targetPath) {
+        await node.sendText(`❌ **缺少工作区路径**\n\n> 用法：\`/addworkspace <电脑绝对路径>\`\n> 示例：\`/addworkspace D:\\IdeaProjects\\my-app\``)
+        return true
+      }
+      try {
+        const safetyCheck = await isSafeWorkspacePath(targetPath)
+        if (!safetyCheck.valid) {
+          await node.sendText(`⚠️ **${safetyCheck.error || '路径安全校验未通过'}**：\`${targetPath}\`\n\n> 出于安全考虑，禁止将系统关键目录或敏感配置文件所在路径登记为工作区。`)
+          return true
+        }
+        const resolved = safetyCheck.path
+        const title = basename(resolved) || resolved
+        if (node.ctx.workspaceRegistry?.add) {
+          await node.ctx.workspaceRegistry.add({ path: resolved, title }).catch(() => {})
+        } else if (node.ctx.workspaceRegistry?.register) {
+          await node.ctx.workspaceRegistry.register({ path: resolved, title }).catch(() => {})
+        }
+        const workspaces = await listWorkspaces(node)
+        const foundIndex = workspaces.findIndex(w => normalize(w.path) === normalize(resolved))
+        const numStr = foundIndex >= 0 ? `@${foundIndex + 1}` : ''
+        await node.sendText([
+          `✓ **工作区添加成功**！`,
+          `- **名称**：${title}`,
+          `- **路径**：\`${resolved}\``,
+          foundIndex >= 0 ? `- **快捷编号**：\`${numStr}\`` : '',
+          '',
+          `> 发送 \`/new <提示词> ${numStr || '@' + resolved}\` 即可直接在此工作区创建会话。`,
+        ].filter(Boolean).join('\n'))
+      } catch (err) {
+        await node.sendText(`❌ **添加工作区失败**：${err instanceof Error ? err.message : String(err)}`)
+      }
+      return true
+    }
+    case 'new': {
+      // 解析尾部 @N 或 @路径 作为工作区 cwd
+      const args = rest.join(' ').trim()
+      let cwd
+      let prompt = args
+      const atMatch = args.match(/\s+@(\S+)$/)
+      if (atMatch) {
+        prompt = args.slice(0, atMatch.index).trim()
+        const sel = atMatch[1]
+        const workspaces = await listWorkspaces(node)
+        if (/^\d+$/.test(sel)) {
+          const idx = Number(sel)
+          const ws = workspaces[idx - 1]
+          if (ws) cwd = ws.path
+          else {
+            await node.sendText(`❌ **无效工作区编号**：\`${sel}\`\n\n> 请发送 \`/workspaces\` 查看可用工作区列表与编号。`)
+            return true
+          }
+        } else {
+          // 直接指定路径时，规范化并校验（必须完全匹配已注册工作区）
+          const validation = await validateWorkspacePath(node, sel)
+          if (!validation.valid) {
+            await node.sendText(validation.error)
+            return true
+          }
+          cwd = validation.path
+        }
+      }
+      await node.createSession(prompt, cwd)
+      return true
+    }
+    case 'stop': {
+      node.stopAllHeartbeats()
+      const agent = node.activeAgent()
+      if (!agent) {
+        await node.sendText(`ℹ️ **当前没有正在运行的 Agent 任务**`)
+      } else {
+        agent.cancel({ kind: 'user' })
+        await node.sendText(`⏹ **已请求停止当前任务**`)
+      }
+      return true
+    }
+    case 'end': {
+      node.stopAllHeartbeats()
+      // 结束当前会话：停止 agent 并清除活动会话（进入"没有活动会话"状态）
+      const agent = node.activeAgent()
+      if (agent) agent.cancel({ kind: 'user' })
+      node.activeSessionId = null
+      await node.onActiveSessionChange?.(null)
+      await node.sendText(`✓ **已结束当前会话**（没有活动会话）。\n\n> **后续操作**：\n> - \`/new <提示词>\` — 新建会话并开始\n> - \`/sessions\` — 查看历史会话列表\n> - \`/help\` — 查看常用指令帮助`)
+      return true
+    }
+    case 'status': {
+      const agent = node.activeAgent()
+      const session = node.activeSession()
+      if (!session) {
+        await node.sendText(`## 📊 Agent 状态看板\n\n> 当前没有活动会话。\n> 发送 \`/new <提示词>\` 开始新任务，或发送 \`/sessions\` 查看已有会话。`)
+        return true
+      }
+      const statusMap = {
+        idle: '空闲 (idle)',
+        running: '运行中 (running)',
+        paused: '已暂停 (paused)',
+        error: '异常 (error)',
+      }
+      const status = statusMap[agent?.status] || (agent?.status ?? '空闲 (idle)')
+      const lastTurn = [...(session.events ?? [])].reverse().find((e) => e.type === 'turn/end')
+      const reason = lastTurn ? describeTurnEnd(lastTurn.data.reason) : '尚未运行'
+      const title = session.title || (session.events ? sessionLabel(session) : '')
+      const shortId = fmtSessionId(session.id)
+      const cwd = session.header?.cwd || node.config?.cwd || ''
+
+      const content = [
+        `## 📊 Agent 状态看板`,
+        '',
+        '| 属性 | 当前状态 / 参数 |',
+        '| :--- | :--- |',
+        `| **会话 ID** | \`${shortId}\` |`,
+        ...(title ? [`| **会话标题** | ${title.replace(/\|/g, '｜')} |`] : []),
+        ...(cwd ? [`| **工作区** | \`${cwd}\` |`] : []),
+        `| **Agent 状态** | ${status} |`,
+        `| **累计事件** | ${session.seq ?? 0} 条 |`,
+        `| **最近执行** | ${reason} |`,
+      ].join('\n')
+
+      await node.sendText(content)
+      return true
+    }
+    case 'start': // 别名：首次扫码自动开始一个会话
+      await node.createSession('')
+      return true
+    default:
+      await node.sendText(`❌ **未知指令**：\`/${command}\`\n\n${helpText()}`)
+      return true
+  }
+}