dsh-bridge-gateway 0.2.2 → 0.3.0

package/lib/paths.js

@@ -82,18 +82,32 @@ export function wechatContextTokenFile() {
 
 // ── cloudflared 二进制缓存 ────────────────────────────────────────────────
 // 与插件数据目录分开存放：它是可重新下载的外部依赖（约 39MB），不是用户数据。
-// 新名 ~/.dsh-bridge-cloudflared/；旧名 ~/.dsh-bridge/（上游沿用）。
-export const CLOUDFLARED_DIR_NAME = '.dsh-bridge-cloudflared';
-export const LEGACY_CLOUDFLARED_DIR_NAME = '.dsh-bridge';
+//
+// 这个名字改过两次，所以迁移是**两级链**：
+//   ~/.dsh-bridge/                     ← 上游沿用名（fork 前）
+//   ~/.dsh-bridge-cloudflared/         ← 第一次改名后
+//   ~/.dsh-bridge-gateway-cloudflared/ ← 当前
+// 迁移按"从新到旧"依次尝试，命中第一个存在的旧目录即迁移，避免老用户白等一次
+// 39MB 重下载。
+export const CLOUDFLARED_DIR_NAME = '.dsh-bridge-gateway-cloudflared';
+
+/**
+ * cloudflared 缓存目录的历史名字，**从新到旧**。
+ * 迁移顺序即数组顺序：先找最近一次改名前的名字，再往上追。
+ */
+export const LEGACY_CLOUDFLARED_DIR_NAMES = Object.freeze([
+  '.dsh-bridge-cloudflared',
+  '.dsh-bridge',
+]);
 
-/** cloudflared 缓存根目录（新名）。 */
+/** cloudflared 缓存根目录（当前名）。 */
 export function cloudflaredDir() {
   return join(homedir(), CLOUDFLARED_DIR_NAME);
 }
 
-/** cloudflared 缓存根目录（旧名）。 */
-export function legacyCloudflaredDir() {
-  return join(homedir(), LEGACY_CLOUDFLARED_DIR_NAME);
+/** 全部历史缓存目录（从新到旧）。 */
+export function legacyCloudflaredDirs() {
+  return LEGACY_CLOUDFLARED_DIR_NAMES.map((name) => join(homedir(), name));
 }
 
 /** cloudflared 二进制所在目录。 */
@@ -101,26 +115,41 @@ export function cloudflaredBinDir() {
   return join(cloudflaredDir(), 'bin');
 }
 
+/** 可能存放 cloudflared 二进制的全部目录（当前 + 历史），供清理时一并处理。 */
+export function cloudflaredBinDirs() {
+  return [cloudflaredDir(), ...legacyCloudflaredDirs()].map((dir) => join(dir, 'bin'));
+}
+
 /**
- * 迁移 cloudflared 二进制缓存目录（旧名 → 新名）。幂等。
+ * 迁移 cloudflared 二进制缓存目录（历史名 → 当前名）。幂等。
+ *
+ * 按 `LEGACY_CLOUDFLARED_DIR_NAMES` 的顺序（从新到旧）尝试，命中第一个存在
+ * 且确实是目录的旧目录即迁移，然后返回。
  *
  * 与数据目录迁移的区别：这里失败代价只是「重新下载约 39MB」，不是丢数据，
  * 因此策略更宽松 —— 失败也不抛出，让下载逻辑自愈。
  *
- * @returns {{migrated: boolean, reason: string}}
+ * @returns {{migrated: boolean, reason: string, from?: string, to?: string}}
  */
 export function migrateLegacyCloudflaredDir({ logger } = {}) {
-  const from = legacyCloudflaredDir();
   const to = cloudflaredDir();
   try {
     if (existsSync(to)) return { migrated: false, reason: 'already-migrated' };
-    if (!existsSync(from)) return { migrated: false, reason: 'no-legacy-dir' };
-    if (!statSync(from).isDirectory()) return { migrated: false, reason: 'legacy-not-a-directory' };
+
+    // 从新到旧找第一个可用的旧目录
+    let from = null;
+    for (const candidate of legacyCloudflaredDirs()) {
+      if (!existsSync(candidate)) continue;
+      if (!statSync(candidate).isDirectory()) continue;
+      from = candidate;
+      break;
+    }
+    if (!from) return { migrated: false, reason: 'no-legacy-dir' };
 
     try {
       renameSync(from, to);
       logger?.info?.('dsh-bridge-gateway: cloudflared 缓存目录已迁移 %s -> %s', from, to);
-      return { migrated: true, reason: 'renamed' };
+      return { migrated: true, reason: 'renamed', from, to };
     } catch (renameErr) {
       mkdirSync(to, { recursive: true });
       try {
@@ -133,7 +162,7 @@ export function migrateLegacyCloudflaredDir({ logger } = {}) {
         return { migrated: false, reason: `copy-failed:${copyErr?.message ?? copyErr}` };
       }
       logger?.info?.('dsh-bridge-gateway: cloudflared 缓存已复制迁移 %s -> %s', from, to);
-      return { migrated: true, reason: 'copied' };
+      return { migrated: true, reason: 'copied', from, to };
     }
   } catch (err) {
     logger?.warn?.('dsh-bridge-gateway: cloudflared 缓存迁移失败（将按需重新下载）：%s', err?.message ?? err);

package/lib/platform/base.js

@@ -1,4 +1,4 @@
-// dsh-bridge 平台抽象基类
+// dsh-bridge-gateway 平台抽象基类
 //
 // 定义 IM 平台适配器的统一接口。每个平台（微信/QQ/飞书/Telegram…）继承本类，
 // 实现协议层（登录、收发消息、typing）。平台无关的会话桥逻辑在 ConversationBridge
@@ -137,7 +137,7 @@ export class Platform {
     try {
       await this.onPersist(patch)
     } catch (err) {
-      this.logger?.warn?.(`[dsh-bridge ${this.id}] persist failed: %s`, err?.message ?? err)
+      this.logger?.warn?.(`[dsh-bridge-gateway ${this.id}] persist failed: %s`, err?.message ?? err)
     }
   }
 

package/lib/platform/conversation-bridge.js

@@ -1,4 +1,4 @@
-// dsh-bridge 平台无关的会话桥
+// dsh-bridge-gateway 平台无关的会话桥
 //
 // 承担所有 IM 平台共享的核心逻辑：
 //   - 白名单（allowFrom）与首条自动授权
@@ -385,7 +385,7 @@ export class ConversationBridge {
     } catch (err) {
       if (!wanted) throw err
       const reason = err instanceof Error ? err.message : String(err)
-      this.logger?.warn?.(`[dsh-bridge ${this.platform.id}] agent preset "${wanted}" unavailable (${reason}); falling back to the default preset`)
+      this.logger?.warn?.(`[dsh-bridge-gateway ${this.platform.id}] agent preset "${wanted}" unavailable (${reason}); falling back to the default preset`)
       resolvedId = (await presets.resolve(undefined)).id
       fallbackFrom = wanted
     }
@@ -446,7 +446,7 @@ export class ConversationBridge {
 
       if (prompt) {
         const platformName = this.platform?.name || 'IM客户端'
-        const promptWithContext = `${prompt}\n\n<!-- [dsh-bridge 提示] 当前用户正通过【${platformName}】与你对话。若用户明确要求发送、导出或传送文件/图片/报表/代码脚本产物，请在本地生成/准备好文件后，在回复正文中附带明确发送指令：\n[SEND_FILE: <本地文件绝对路径>]\n例如：[SEND_FILE: C:\\path\\to\\report.xlsx]\n网关会自动解析该指令并将该文件直传至用户的聊天窗口，且在聊天文本中自动隐藏该指令。在日常编写代码、回复普通文本或未请求发送文件时，请勿输出此指令。 -->`
+        const promptWithContext = `${prompt}\n\n<!-- [dsh-bridge-gateway 提示] 当前用户正通过【${platformName}】与你对话。若用户明确要求发送、导出或传送文件/图片/报表/代码脚本产物，请在本地生成/准备好文件后，在回复正文中附带明确发送指令：\n[SEND_FILE: <本地文件绝对路径>]\n例如：[SEND_FILE: C:\\path\\to\\report.xlsx]\n网关会自动解析该指令并将该文件直传至用户的聊天窗口，且在聊天文本中自动隐藏该指令。在日常编写代码、回复普通文本或未请求发送文件时，请勿输出此指令。 -->`
         handle.agent.followup(createUserMessage({
           content: [{ type: 'text', text: promptWithContext }],
           source: { kind: 'user' },
@@ -571,32 +571,32 @@ export class ConversationBridge {
         )
         if (shouldAutoApprove) {
           this.config.allowFrom = Array.from(new Set([...this.config.allowFrom, sender]))
-          this.logger?.info?.(`[dsh-bridge ${this.platform.id}] auto-approved ${isGroup ? 'group' : 'sender'} ${sender} into allowlist`)
+          this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] auto-approved ${isGroup ? 'group' : 'sender'} ${sender} into allowlist`)
           try {
             await this.onFirstSender?.(sender)
           } catch (err) {
-            this.logger?.warn?.(`[dsh-bridge ${this.platform.id}] failed to persist first sender: ${err instanceof Error ? err.message : String(err)}`)
+            this.logger?.warn?.(`[dsh-bridge-gateway ${this.platform.id}] failed to persist first sender: ${err instanceof Error ? err.message : String(err)}`)
           }
         } else {
-          this.logger?.info?.(`[dsh-bridge ${this.platform.id}] media-only first message from ${sender} not auto-approved (waiting for text)`)
+          this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] media-only first message from ${sender} not auto-approved (waiting for text)`)
         }
 
         // 如果仍未通过白名单，拒绝处理（防止绕过白名单）
         if (!this.isAllowed(sender)) {
-          this.logger?.info?.(`[dsh-bridge ${this.platform.id}] ignore message from non-allowlisted sender ${sender} (never fed to model)`)
+          this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] ignore message from non-allowlisted sender ${sender} (never fed to model)`)
           return 'ignored'
         }
       }
 
       // 仅在不支持群聊的平台忽略群消息（QQ 等支持群聊的平台放行）
       if (isGroup && !this.platform?.capabilities?.supportsGroup) {
-        this.logger?.info?.(`[dsh-bridge ${this.platform.id}] ignore group message from ${sender} (no group support)`)
+        this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] ignore group message from ${sender} (no group support)`)
         return 'ignored'
       }
 
       const fullText = text?.trim() ?? ''
       if (!fullText) {
-        this.logger?.info?.(`[dsh-bridge ${this.platform.id}] ignore empty message from ${sender}`)
+        this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] ignore empty message from ${sender}`)
         return 'ignored'
       }
 
@@ -669,11 +669,11 @@ export class ConversationBridge {
                 })
               }
               const resumedAgent = handle?.agent
-              this.logger?.info?.(`[dsh-bridge ${this.platform.id}] re-attached agent to session ${sessionId} (${persisted ? 'resume' : 'create'})`)
+              this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] re-attached agent to session ${sessionId} (${persisted ? 'resume' : 'create'})`)
               return resumedAgent
             } catch (err) {
               const reason = err instanceof Error ? err.message : String(err)
-              this.logger?.warn?.(`[dsh-bridge ${this.platform.id}] failed to re-attach agent: ${reason}`)
+              this.logger?.warn?.(`[dsh-bridge-gateway ${this.platform.id}] failed to re-attach agent: ${reason}`)
               // 清除失效的 activeSessionId，避免用户误以为还在旧会话中
               if (this.activeSessionId === sessionId) {
                 this.activeSessionId = null
@@ -695,7 +695,7 @@ export class ConversationBridge {
       }
 
       // 针对微信/IM客户端用户，注入上下文提示，规范 Agent 仅在需要向用户发送文件附件时输出 [SEND_FILE: <文件绝对路径>]
-      const promptWithContext = `${fullText}\n\n<!-- [dsh-bridge 提示] 当前用户正通过【${this.platform.name}】与你对话。若用户明确要求发送、导出或传送文件/图片/报表/代码脚本产物，请在本地生成/准备好文件后，在回复正文中附带明确发送指令：\n[SEND_FILE: <本地文件绝对路径>]\n例如：[SEND_FILE: C:\\path\\to\\report.xlsx]\n网关会自动解析该指令并将该文件直传至用户的聊天窗口，且在聊天文本中自动隐藏该指令。在日常编写代码、回复普通文本或未请求发送文件时，请勿输出此指令。 -->`
+      const promptWithContext = `${fullText}\n\n<!-- [dsh-bridge-gateway 提示] 当前用户正通过【${this.platform.name}】与你对话。若用户明确要求发送、导出或传送文件/图片/报表/代码脚本产物，请在本地生成/准备好文件后，在回复正文中附带明确发送指令：\n[SEND_FILE: <本地文件绝对路径>]\n例如：[SEND_FILE: C:\\path\\to\\report.xlsx]\n网关会自动解析该指令并将该文件直传至用户的聊天窗口，且在聊天文本中自动隐藏该指令。在日常编写代码、回复普通文本或未请求发送文件时，请勿输出此指令。 -->`
 
       const messageValue = createUserMessage({
         content: [{ type: 'text', text: promptWithContext }],
@@ -706,7 +706,7 @@ export class ConversationBridge {
       return 'routed'
     } catch (err) {
       const errMsg = err instanceof Error ? err.message : String(err)
-      this.logger?.error?.(`[dsh-bridge ${this.platform.id}] unhandled error in handleInbound: ${errMsg}`)
+      this.logger?.error?.(`[dsh-bridge-gateway ${this.platform.id}] unhandled error in handleInbound: ${errMsg}`)
       await this.sendText(`❌ **执行出错**：${errMsg}`).catch(() => {})
       return 'ignored'
     }
@@ -726,7 +726,7 @@ export class ConversationBridge {
       for (let i = 0; i < chunks.length; i++) {
         const result = await this.platform.sendText(peer, chunks[i])
         if (result && result.success === false) {
-          this.logger?.warn?.(`[dsh-bridge ${this.platform.id}] outbound chunk ${i + 1}/${chunks.length} failed: ${result.error}`)
+          this.logger?.warn?.(`[dsh-bridge-gateway ${this.platform.id}] outbound chunk ${i + 1}/${chunks.length} failed: ${result.error}`)
           break
         }
         if (i < chunks.length - 1 && this.config.sendChunkDelayMs > 0) {
@@ -847,13 +847,13 @@ export class ConversationBridge {
             }
             for (const resolved of uniqueFilesToSend) {
               try {
-                this.logger?.info?.(`[dsh-bridge ${this.platform.id}] auto sendMediaFile to peer: ${resolved}`)
+                this.logger?.info?.(`[dsh-bridge-gateway ${this.platform.id}] auto sendMediaFile to peer: ${resolved}`)
                 const res = await this.platform.sendMediaFile(targetPeer, resolved)
                 if (res && res.success === false) {
-                  this.logger?.warn?.(`[dsh-bridge ${this.platform.id}] auto sendMediaFile ${resolved} failed: %s`, res.error)
+                  this.logger?.warn?.(`[dsh-bridge-gateway ${this.platform.id}] auto sendMediaFile ${resolved} failed: %s`, res.error)
                 }
               } catch (err) {
-                this.logger?.warn?.(`[dsh-bridge ${this.platform.id}] auto sendMediaFile ${resolved} failed: %s`, err?.message ?? err)
+                this.logger?.warn?.(`[dsh-bridge-gateway ${this.platform.id}] auto sendMediaFile ${resolved} failed: %s`, err?.message ?? err)
               }
             }
           }

package/lib/platform/index.js

@@ -1,4 +1,4 @@
-// dsh-bridge 平台抽象层统一导出
+// dsh-bridge-gateway 平台抽象层统一导出
 //
 // 提供多平台 IM 接入的基础设施：
 //   Platform             平台适配器基类（协议/连接/登录/收发消息）

package/lib/platform/manager.js

@@ -1,4 +1,4 @@
-// dsh-bridge 平台管理器
+// dsh-bridge-gateway 平台管理器
 //
 // 注册/协调多个 IM 平台适配器（Platform 子类），向主插件与 RPC 层提供：
 //   - 统一的多平台状态聚合（getStatus）
@@ -20,7 +20,7 @@ export class PlatformManager {
   /** 注册一个平台实例。重复注册同 id 时替换旧实例并 dispose 旧的。 */
   register(platform) {
     if (!platform || !platform.id) {
-      this.logger?.warn?.('[dsh-bridge] PlatformManager.register: 平台缺少 id，已忽略')
+      this.logger?.warn?.('[dsh-bridge-gateway] PlatformManager.register: 平台缺少 id，已忽略')
       return platform
     }
     const existing = this.platforms.get(platform.id)
@@ -29,12 +29,12 @@ export class PlatformManager {
         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)`)
+          this.logger?.warn?.(`[dsh-bridge-gateway] 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 ?? ''})`)
+    this.logger?.info?.(`[dsh-bridge-gateway] platform registered: ${platform.id} (${platform.name ?? ''})`)
     return platform
   }
 

package/lib/qq/gateway.js

@@ -193,7 +193,7 @@ export class QqGateway extends Service {
 
   async persist(patch) {
     try { await this.onPersist(patch) } catch (error) {
-      this.logger?.warn?.('[dsh-bridge qq] persist failed: %s', error?.message ?? error)
+      this.logger?.warn?.('[dsh-bridge-gateway qq] persist failed: %s', error?.message ?? error)
     }
   }
 
@@ -246,7 +246,7 @@ export class QqGateway extends Service {
       } catch (error) {
         if (this.stopRequested) break
         this.setStatus('reconnecting')
-        this.logger?.warn?.('[dsh-bridge qq] gateway disconnected: %s, retrying in %dms...', error?.message ?? error, backoffMs)
+        this.logger?.warn?.('[dsh-bridge-gateway qq] gateway disconnected: %s, retrying in %dms...', error?.message ?? error, backoffMs)
         await sleep(backoffMs)
         backoffMs = Math.min(Math.round(backoffMs * 1.5), 30_000)
       }
@@ -278,7 +278,7 @@ export class QqGateway extends Service {
           finish()
           return
         }
-        this.logger?.info?.('[dsh-bridge qq] WebSocket connected to QQ Open Platform')
+        this.logger?.info?.('[dsh-bridge-gateway qq] WebSocket connected to QQ Open Platform')
       })
       ws.on('message', (raw) => {
         if (this.stopRequested) return
@@ -300,7 +300,7 @@ export class QqGateway extends Service {
       this.startHeartbeat(ws)
       if (this.sessionId && this.sequence != null) {
         // 快速恢复模式（Resume）：携带 sessionId 与 sequence 避免重新全量鉴权与丢失消息
-        this.logger?.info?.('[dsh-bridge qq] attempting session resume (sessionId=%s, seq=%s)', this.sessionId, this.sequence)
+        this.logger?.info?.('[dsh-bridge-gateway qq] attempting session resume (sessionId=%s, seq=%s)', this.sessionId, this.sequence)
         ws.send(JSON.stringify({
           op: 6,
           d: {
@@ -317,7 +317,7 @@ export class QqGateway extends Service {
             token: `QQBot ${token}`,
             intents: this.config.intents,
             shard: [0, 1],
-            properties: { $os: process.platform, $browser: 'dsh-bridge', $device: 'dsh-bridge' },
+            properties: { $os: process.platform, $browser: 'dsh-bridge-gateway', $device: 'dsh-bridge-gateway' },
           },
         }))
       }
@@ -335,11 +335,11 @@ export class QqGateway extends Service {
         this.unackedHeartbeats = 0
         await this.persist({ accountId: this.accountId })
         this.setStatus('connected')
-        this.logger?.info?.('[dsh-bridge qq] gateway READY (session_id=%s)', this.sessionId)
+        this.logger?.info?.('[dsh-bridge-gateway qq] gateway READY (session_id=%s)', this.sessionId)
       } else if (payload.t === 'RESUMED') {
         this.unackedHeartbeats = 0
         this.setStatus('connected')
-        this.logger?.info?.('[dsh-bridge qq] gateway RESUMED successfully')
+        this.logger?.info?.('[dsh-bridge-gateway qq] gateway RESUMED successfully')
       }
       const event = normalizeEvent(payload)
       if (event.type === 'message' && event.id && !this.seen(event.id)) {
@@ -351,7 +351,7 @@ export class QqGateway extends Service {
       return
     }
     if (op === 7) {
-      this.logger?.info?.('[dsh-bridge qq] gateway requested reconnect (OpCode 7)')
+      this.logger?.info?.('[dsh-bridge-gateway qq] gateway requested reconnect (OpCode 7)')
       try { ws.close() } catch {}
       return
     }
@@ -368,7 +368,7 @@ export class QqGateway extends Service {
     const beat = () => {
       if (ws.readyState === WebSocket.OPEN) {
         if (this.unackedHeartbeats >= 2) {
-          this.logger?.warn?.('[dsh-bridge qq] heartbeat ACK missed (count=%d), dead link detected, reconnecting...', this.unackedHeartbeats)
+          this.logger?.warn?.('[dsh-bridge-gateway qq] heartbeat ACK missed (count=%d), dead link detected, reconnecting...', this.unackedHeartbeats)
           try { ws.terminate() } catch {}
           return
         }
@@ -600,7 +600,7 @@ export class QqGateway extends Service {
       })
       return res
     } catch (err) {
-      this.logger?.warn?.('[dsh-bridge qq] sendMediaFile error: %s', err?.message ?? err)
+      this.logger?.warn?.('[dsh-bridge-gateway qq] sendMediaFile error: %s', err?.message ?? err)
       return null
     }
   }

package/lib/qq/index.js

@@ -1,4 +1,4 @@
-// dsh-bridge QQ platform adapter
+// dsh-bridge-gateway QQ platform adapter
 // 编排 QqGateway（OpenAPI v2 网关）+ QqConversationNode（QQ⇄DSH 会话桥）。
 // 作为 Platform 子类，注册进 PlatformManager 统一管理。
 //
@@ -68,7 +68,7 @@ export class QqService extends Platform {
 
     if (this.gateway.configured) {
       void this.start().catch((err) => {
-        this.logger.error('[dsh-bridge qq] start failed: %s', err?.message ?? err)
+        this.logger.error('[dsh-bridge-gateway qq] start failed: %s', err?.message ?? err)
       })
     }
   }
@@ -184,7 +184,7 @@ export class QqService extends Platform {
     }
     this.loginState = { phase: 'done', qrPayload: null, qrKind: null, error: null }
     void this.gateway.start().catch((err) => {
-      this.logger.error('[dsh-bridge qq] login start failed: %s', err?.message ?? err)
+      this.logger.error('[dsh-bridge-gateway qq] login start failed: %s', err?.message ?? err)
     })
     return { ok: true }
   }
@@ -194,7 +194,7 @@ export class QqService extends Platform {
     await this.gateway.stop()
     this.gateway.setCredentials({ appId: '', clientSecret: '', accessToken: '', accessTokenExpiresAt: 0 })
     await this.persist({ appId: '', clientSecret: '', accessToken: '', accessTokenExpiresAt: 0, accountId: '' })
-    this.logger.info('[dsh-bridge qq] unbound: credentials cleared')
+    this.logger.info('[dsh-bridge-gateway qq] unbound: credentials cleared')
   }
 
   /** 更新白名单并发起持久化。 */
@@ -235,10 +235,10 @@ export class QqService extends Platform {
             target_type: 'all',
             panel: { items, remark, version: 1 },
           })
-          this.logger.info('[dsh-bridge qq] created %s command panel: %s', scope, res?.panel_id ?? '(no id)')
+          this.logger.info('[dsh-bridge-gateway qq] created %s command panel: %s', scope, res?.panel_id ?? '(no id)')
         }
       } catch (err) {
-        this.logger.warn('[dsh-bridge qq] command panel setup for %s skipped: %s', scope, err?.message ?? err)
+        this.logger.warn('[dsh-bridge-gateway qq] command panel setup for %s skipped: %s', scope, err?.message ?? err)
       }
     }
 
@@ -256,12 +256,12 @@ export class QqService extends Platform {
         menuItems.every((item, i) => existingItems[i]?.name === item.name && existingItems[i]?.send_message === item.send_message)
       if (!same) {
         await gate.setMenu(menuItems)
-        this.logger.info('[dsh-bridge qq] custom menu configured')
+        this.logger.info('[dsh-bridge-gateway qq] custom menu configured')
       } else {
-        this.logger.info('[dsh-bridge qq] custom menu already configured')
+        this.logger.info('[dsh-bridge-gateway qq] custom menu already configured')
       }
     } catch (err) {
-      this.logger.warn('[dsh-bridge qq] custom menu setup skipped: %s', err?.message ?? err)
+      this.logger.warn('[dsh-bridge-gateway qq] custom menu setup skipped: %s', err?.message ?? err)
     }
   }
 
@@ -298,7 +298,7 @@ export class QqService extends Platform {
     // 凭证配置完成后自动启动网关（前端「保存并连接」无需二次点击）
     if (this.gateway.configured && (appId !== undefined || clientSecret !== undefined)) {
       await this.gateway.start().catch((err) => {
-        this.logger?.warn?.('[dsh-bridge qq] auto-start failed: %s', err?.message ?? err)
+        this.logger?.warn?.('[dsh-bridge-gateway qq] auto-start failed: %s', err?.message ?? err)
       })
     }
   }
@@ -309,4 +309,4 @@ function gatewayMaxChars() {
 }
 
 // 指令面板 remark 标识，用于幂等判断（区分本插件创建的面板）
-const PANEL_REMARK = 'dsh-bridge 常用命令'
+const PANEL_REMARK = 'dsh-bridge-gateway 常用命令'

package/lib/qq/node.js

@@ -1,4 +1,4 @@
-// dsh-bridge QQ conversation node
+// dsh-bridge-gateway QQ conversation node
 // 把 QQ OpenAPI v2 的入站事件（C2C 私聊 / 群聊 @提及）解析后交给平台无关的
 // ConversationBridge 处理，出站通过 QqGateway 发送文本 / Markdown / 按钮。
 // 平台特定部分：
@@ -277,9 +277,9 @@ export class QqConversationNode extends ConversationBridge {
           streamMsgId = result?.id || result?.message_id || result?.stream_msg_id
           if (streamMsgId) {
             this.lastMessageId = streamMsgId
-            this.logger?.info?.('[dsh-bridge qq] stream started, stream_msg_id=%s, slices=%d', streamMsgId, slices.length)
+            this.logger?.info?.('[dsh-bridge-gateway qq] stream started, stream_msg_id=%s, slices=%d', streamMsgId, slices.length)
           } else {
-            this.logger?.warn?.('[dsh-bridge qq] stream first chunk returned no id: %o', result)
+            this.logger?.warn?.('[dsh-bridge-gateway qq] stream first chunk returned no id: %o', result)
           }
         }
 
@@ -296,7 +296,7 @@ export class QqConversationNode extends ConversationBridge {
       return { success: true }
     } catch (err) {
       // 流式失败 → 补发完整内容 replace 收尾（input_state=10），尽量合并成一条
-      this.logger?.warn?.('[dsh-bridge qq] stream send failed, patch final replace: %s', err?.message ?? err)
+      this.logger?.warn?.('[dsh-bridge-gateway qq] stream send failed, patch final replace: %s', err?.message ?? err)
       try {
         const result = await this.gateway.sendStream(peerId, md, {
           ...streamCommon,
@@ -323,13 +323,13 @@ export class QqConversationNode extends ConversationBridge {
       return result
     } catch (fallbackErr1) {
       // 被动回复失败（msg_id 过期等）→ 主动消息兜底
-      this.logger?.warn?.('[dsh-bridge qq] markdown send failed with msg_id, retry as active: %s', fallbackErr1?.message ?? fallbackErr1)
+      this.logger?.warn?.('[dsh-bridge-gateway qq] markdown send failed with msg_id, retry as active: %s', fallbackErr1?.message ?? fallbackErr1)
       try {
         const result = await this.gateway.sendMarkdown(peerId, md, { scope, keyboard })
         if (result?.id) this.lastMessageId = result.id
         return result
       } catch (fallbackErr2) {
-        this.logger?.error?.('[dsh-bridge qq] markdown send failed: %s', fallbackErr2?.message ?? fallbackErr2)
+        this.logger?.error?.('[dsh-bridge-gateway qq] markdown send failed: %s', fallbackErr2?.message ?? fallbackErr2)
         return { success: false, error: fallbackErr2?.message ?? String(fallbackErr2) }
       }
     }
@@ -375,7 +375,7 @@ export class QqConversationNode extends ConversationBridge {
     // 快速预检查：白名单非空时，未授权单聊发件人直接忽略；
     // 群聊不在此拦截——交给 handleInbound 自动授权（首次 @机器人 即授权该群）
     if (!isGroup && !this.isAllowed(authId) && this.config.allowFrom.length > 0) {
-      this.logger?.info?.(`[dsh-bridge qq] ignore message from non-allowlisted sender ${authId}`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] ignore message from non-allowlisted sender ${authId}`)
       return
     }
 
@@ -384,13 +384,13 @@ export class QqConversationNode extends ConversationBridge {
 
     let mediaFiles = []
     if (attachments.length > 0) {
-      this.logger?.info?.(`[dsh-bridge qq] processing ${attachments.length} attachment(s) from ${sender}...`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] processing ${attachments.length} attachment(s) from ${sender}...`)
       mediaFiles = await this._processAttachments(attachments, this.config.cwd)
-      this.logger?.info?.(`[dsh-bridge qq] downloaded ${mediaFiles.length} file(s)`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] downloaded ${mediaFiles.length} file(s)`)
     }
 
     if (!text && mediaFiles.length === 0) {
-      this.logger?.info?.(`[dsh-bridge qq] ignore empty message from ${sender}`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] ignore empty message from ${sender}`)
       return
     }
 
@@ -410,7 +410,7 @@ export class QqConversationNode extends ConversationBridge {
     // 则自动创建新会话并发送消息
     const messageReference = event.messageReference
     if (messageReference && !this.activeSessionId && !fullText.startsWith('/')) {
-      this.logger?.info?.(`[dsh-bridge qq] detected message reference from ${sender}, auto-starting conversation`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] detected message reference from ${sender}, auto-starting conversation`)
       // 先创建新会话，再处理消息
       await this.handleInbound({ senderId: authId, text: '/new', isGroup })
       // 等待一小段时间确保会话创建完成
@@ -441,7 +441,7 @@ export class QqConversationNode extends ConversationBridge {
         await fs.promises.writeFile(filePath, buf)
         downloaded.push({ filename: safeName, path: filePath, size: buf.length })
       } catch (err) {
-        this.logger?.warn?.('[dsh-bridge qq] download attachment error: %s', err?.message ?? err)
+        this.logger?.warn?.('[dsh-bridge-gateway qq] download attachment error: %s', err?.message ?? err)
       }
     }
     return downloaded
@@ -462,7 +462,7 @@ export class QqConversationNode extends ConversationBridge {
     // 快速预检查：白名单非空时，未授权单聊发件人直接忽略；
     // 群聊不在此拦截——handleInbound 会按群自动授权
     if (!isGroup && !this.isAllowed(authId) && this.config.allowFrom.length > 0) {
-      this.logger?.info?.(`[dsh-bridge qq] ignore interaction from non-allowlisted sender ${authId}`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] ignore interaction from non-allowlisted sender ${authId}`)
       return
     }
 
@@ -481,12 +481,12 @@ export class QqConversationNode extends ConversationBridge {
       try {
         await this.gateway.respondInteraction(event.interactionId, { code: 0 })
       } catch (err) {
-        this.logger?.warn?.('[dsh-bridge qq] respond interaction failed: %s', err?.message ?? err)
+        this.logger?.warn?.('[dsh-bridge-gateway qq] respond interaction failed: %s', err?.message ?? err)
       }
     }
 
     if (!needsRespond) {
-      this.logger?.info?.(`[dsh-bridge qq] skip non-button interaction type=${type} from ${authId}`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] skip non-button interaction type=${type} from ${authId}`)
       return
     }
 
@@ -495,7 +495,7 @@ export class QqConversationNode extends ConversationBridge {
     const buttonId = resolved.button_id || ''
 
     // 根据按钮 ID 执行对应操作（消息按钮 11 与快捷菜单 12 都映射到命令）
-    this.logger?.info?.('[dsh-bridge qq] button interaction type=%s button_id=%s from %s', type, buttonId, authId)
+    this.logger?.info?.('[dsh-bridge-gateway qq] button interaction type=%s button_id=%s from %s', type, buttonId, authId)
     if (buttonId === 'new_conversation') {
       await this.handleInbound({ senderId: authId, text: '/new', isGroup })
     } else if (buttonId === 'list_sessions') {
@@ -507,7 +507,7 @@ export class QqConversationNode extends ConversationBridge {
     } else if (buttonId === 'approve_no') {
       await this.handleInbound({ senderId: authId, text: '/no', isGroup })
     } else {
-      this.logger?.info?.(`[dsh-bridge qq] unknown button interaction: ${buttonId}`)
+      this.logger?.info?.(`[dsh-bridge-gateway qq] unknown button interaction: ${buttonId}`)
     }
   }
 

package/lib/telegram/gateway.js

@@ -282,7 +282,7 @@ export class TelegramGateway extends Service {
   async start() {
     if (this._startingPromise) return this._startingPromise
     if (!this.configured) {
-      this.logger.info?.('[dsh-bridge telegram] not configured (missing botToken); staying idle')
+      this.logger.info?.('[dsh-bridge-gateway telegram] not configured (missing botToken); staying idle')
       this.setStatus('idle')
       return false
     }
@@ -296,13 +296,13 @@ export class TelegramGateway extends Service {
 
       try {
         this.botInfo = await this.request('getMe')
-        this.logger.info?.(`[dsh-bridge telegram] authenticated as @${this.botInfo.username} (id=${this.botInfo.id})`)
+        this.logger.info?.(`[dsh-bridge-gateway telegram] authenticated as @${this.botInfo.username} (id=${this.botInfo.id})`)
         this.setStatus('online')
         void this.registerCommands().catch(() => {})
         this._startPollLoop()
         return true
       } catch (err) {
-        this.logger.error?.('[dsh-bridge telegram] getMe error:', err.message)
+        this.logger.error?.('[dsh-bridge-gateway telegram] getMe error:', err.message)
         this.setStatus('error', err.message)
         return false
       } finally {
@@ -336,9 +336,9 @@ export class TelegramGateway extends Service {
       await this.request('setMyCommands', { commands, scope: { type: 'all_group_chats' } })
       // 4. 设置左下角菜单按键为命令列表
       await this.request('setChatMenuButton', { menu_button: { type: 'commands' } }).catch(() => {})
-      this.logger.info?.('[dsh-bridge telegram] bot command menu & menu button registered successfully')
+      this.logger.info?.('[dsh-bridge-gateway telegram] bot command menu & menu button registered successfully')
     } catch (err) {
-      this.logger.warn?.('[dsh-bridge telegram] setMyCommands failed: %s', err?.message ?? err)
+      this.logger.warn?.('[dsh-bridge-gateway telegram] setMyCommands failed: %s', err?.message ?? err)
     }
   }
 
@@ -388,7 +388,7 @@ export class TelegramGateway extends Service {
           if (this._stopPolling) break
           consecutiveErrors += 1
           const backoffSec = Math.min(30, 2 ** Math.min(consecutiveErrors, 5))
-          this.logger.warn?.(`[dsh-bridge telegram] poll error: ${err.message}, retrying in ${backoffSec}s...`)
+          this.logger.warn?.(`[dsh-bridge-gateway telegram] poll error: ${err.message}, retrying in ${backoffSec}s...`)
           this.setStatus('reconnecting', err.message)
           await new Promise((r) => setTimeout(r, backoffSec * 1000))
         }
@@ -470,7 +470,7 @@ export class TelegramGateway extends Service {
       return await this.request('sendMessage', params)
     } catch (err) {
       if (err.errorCode === 400 || String(err.message).includes('can\'t parse')) {
-        this.logger.warn?.(`[dsh-bridge telegram] HTML parse failed, falling back to plain text for chat ${chatId}`)
+        this.logger.warn?.(`[dsh-bridge-gateway telegram] HTML parse failed, falling back to plain text for chat ${chatId}`)
         return await this.request('sendMessage', {
           chat_id: chatId,
           text: String(text).slice(0, MAX_MESSAGE_CHARS),
@@ -545,7 +545,7 @@ export class TelegramGateway extends Service {
         show_alert: showAlert,
       })
     } catch (err) {
-      this.logger.warn?.('[dsh-bridge telegram] answerCallbackQuery error:', err.message)
+      this.logger.warn?.('[dsh-bridge-gateway telegram] answerCallbackQuery error:', err.message)
     }
   }
 
@@ -583,7 +583,7 @@ export class TelegramGateway extends Service {
 
       return await this.request(method, {}, { isMultipart: true, formData })
     } catch (err) {
-      this.logger.warn?.(`[dsh-bridge telegram] sendMediaFile (${filePath}) error: ${err.message}`)
+      this.logger.warn?.(`[dsh-bridge-gateway telegram] sendMediaFile (${filePath}) error: ${err.message}`)
       return null
     }
   }
@@ -611,7 +611,7 @@ export class TelegramGateway extends Service {
       await fs.promises.writeFile(fullPath, buf)
       return { path: fullPath, filename: safeName, size: buf.length }
     } catch (err) {
-      this.logger.warn?.(`[dsh-bridge telegram] downloadFile error: ${err.message}`)
+      this.logger.warn?.(`[dsh-bridge-gateway telegram] downloadFile error: ${err.message}`)
       return null
     }
   }