@wenbin_wb/dsh-bridge 2.8.4 → 2.8.5

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 
 ---
 
+## [v2.8.5] - 2026-08-27
+
+### 🎯 产物文件推送改为 AI 指令驱动 & 修复 IM 平台断开连接问题
+- **🎯 显式文件发送协议**：由 AI 通过 `[SEND_FILE: <路径>]` 显式驱动文件直传，杜绝修改代码时的文件误发风暴；
+- **🧹 聊天正文自动净化**：自动剔除聊天窗口中的文件发送指令，保持聊天气泡清爽；
+- **🔌 修复 IM 断开连接失效**：修复 QQ 等网关断开连接时 WebSocket 事件悬挂问题，断开后彻底阻断入站消息与出站回复。
+
+---
+
 ## [v2.8.4] - 2026-08-26
 
 ### 🗂️ 会话列表 Web 端 1:1 深度对齐与归档过滤修复

package/lib/feishu/gateway.js

@@ -205,6 +205,7 @@ export class FeishuGateway extends Service {
   // ---- 消息收发 ----
 
   async _handleMessageReceive(data) {
+    if (this._closing || this.status === 'offline') return
     if (!data?.message) return
     const { message, sender } = data
     const messageId = message.message_id

package/lib/feishu/node.js

@@ -107,6 +107,7 @@ export class FeishuConversationNode extends ConversationBridge {
   }
 
   async _handleInbound(event) {
+    if (this.gateway?._closing || this.gateway?.status === 'offline') return
     const { peerId, senderId, isGroup, text, messageId, messageType, contentObj } = event
     this._lastPeer = { peerId, senderId, isGroup }
 

package/lib/platform/conversation-bridge.js

@@ -21,7 +21,7 @@ import { createUserMessage } from '@deepseek-ai/dsh-llm'
 import { randomUUID } from 'node:crypto'
 import { statSync, existsSync, readFileSync } from 'node:fs'
 import { stat } from 'node:fs/promises'
-import { join, resolve, normalize, basename, isAbsolute } from 'node:path'
+import { join, resolve, normalize, basename, extname, isAbsolute } from 'node:path'
 import { homedir } from 'node:os'
 import { isSafeWorkspacePath } from '../security/path-validator.js'
 
@@ -178,49 +178,41 @@ export function resolveFilePath(rawPath, cwd = process.cwd()) {
 }
 
 /**
- * 从模型助手回复正文或工具命令中提取所有真实存在于本地磁盘的文件绝对路径
+ * 提取并过滤文本中的 [SEND_FILE: <path>] 显式发送指令
+ * 由 AI 根据用户意图显式决定何时向用户发送文件附件，杜绝底层盲目扫描与误发。
+ * @param {string} text - 原始助手回复文本
+ * @param {string} cwd - 会话当前工作目录
+ * @returns {{ cleanText: string, files: string[] }}
  */
-export function extractFilePathsFromText(text, cwd = process.cwd()) {
-  if (typeof text !== 'string' || !text.trim()) return []
-  const found = new Set()
-
-  // 1. Windows 绝对路径：C:\Users\...\file.ext 或 C:/Users/.../file.ext（支持中文、空格、特殊符号）
-  const winAbsRegex = /[A-Za-z]:[\\/][^\s"'`<>|*?()]+?\.[A-Za-z0-9_.-]+/g
-  let m
-  while ((m = winAbsRegex.exec(text)) !== null) {
-    const r = resolveFilePath(m[0], cwd)
-    if (r) found.add(r)
+export function extractAndStripSendFileDirectives(text, cwd = process.cwd()) {
+  if (typeof text !== 'string' || !text.trim()) {
+    return { cleanText: text || '', files: [] }
   }
 
-  // 2. POSIX 绝对路径：/home/.../file.ext 或 /tmp/.../file.ext
-  const posixAbsRegex = /\/(?:[^\s"'`<>|*?()\/]+\/)+[^\s"'`<>|*?()\/]+\.[A-Za-z0-9_.-]+/g
-  while ((m = posixAbsRegex.exec(text)) !== null) {
-    const r = resolveFilePath(m[0], cwd)
-    if (r) found.add(r)
-  }
+  const files = []
+  const directiveRegex = /\[(?:SEND_FILE|SEND-FILE|send_file|send-file|SEND_MEDIA|send_media):\s*[`"']?([^\]`"'\r\n]+?)[`"']?\s*\]/gi
 
-  // 3. Markdown 文件链接：[name](file:///path/to/file) 或 [name](path/to/file)
-  const mdLinkRegex = /\[(?:[^\]]*)\]\((?:file:\/\/\/?)?([^)]+)\)/g
-  while ((m = mdLinkRegex.exec(text)) !== null) {
-    const r = resolveFilePath(m[1], cwd)
-    if (r) found.add(r)
+  let m
+  const re = new RegExp(directiveRegex)
+  while ((m = re.exec(text)) !== null) {
+    const rawPath = m[1].trim()
+    const resolved = resolveFilePath(rawPath, cwd)
+    if (resolved && !files.includes(resolved)) {
+      files.push(resolved)
+    }
   }
 
-  // 4. 关键词或 Emoji 引用的文件路径：📁 file.txt, 保存到：file.txt, 产物文件: ...
-  const keywordRegex = /(?:📁|📄|📦|保存到[：:\s]*|生成文件[：:\s]*|文件路径[：:\s]*|产物[：:\s]*|输出文件[：:\s]*|写入文件[：:\s]*)[`"']?([^\r\n`"'\t<>|*?]+?\.[A-Za-z0-9_.-]+)[`"']?/g
-  while ((m = keywordRegex.exec(text)) !== null) {
-    const r = resolveFilePath(m[1], cwd)
-    if (r) found.add(r)
-  }
+  // 从聊天正文中彻底剔除控制指令（保持 IM 聊天气泡的干净整洁）
+  const cleanText = text.replace(directiveRegex, '').replace(/\n{3,}/g, '\n\n').trim()
 
-  // 5. Shell 终端常用输出命令参数：-Path "...", > "...", Out-File "...", Set-Content "..."
-  const cmdRegex = /(?:-Path\s+|>\s*|Out-File\s+|Set-Content\s+|TargetFile["':\s]+|targetFile["':\s]+)[`"']?([^\r\n`"'\t<>|*?]+?\.[A-Za-z0-9_.-]+)[`"']?/gi
-  while ((m = cmdRegex.exec(text)) !== null) {
-    const r = resolveFilePath(m[1], cwd)
-    if (r) found.add(r)
-  }
+  return { cleanText, files }
+}
 
-  return Array.from(found)
+/**
+ * 提取文本中的产物文件路径（基于显式指令）
+ */
+export function extractFilePathsFromText(text, cwd = process.cwd()) {
+  return extractAndStripSendFileDirectives(text, cwd).files
 }
 
 // ---------------------------------------------------------------------------
@@ -627,8 +619,8 @@ export class ConversationBridge {
       return 'routed'
     }
 
-    // 针对微信/IM客户端用户，注入上下文提示，指导 Agent 生成文件后输出明确完整路径以触发自动上传直发
-    const promptWithContext = `${fullText}\n\n<!-- [dsh-bridge 提示] 当前用户正通过【${this.platform.name}】与你对话。若用户要求生成、导出或发送文件，请将文件保存在本地磁盘并在回复中明确写出文件的完整路径（如 📁 <路径>），网关会自动把该文件上传并直接发送到用户的 ${this.platform.name} 聊天窗口。 -->`
+    // 针对微信/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 messageValue = createUserMessage({
       content: [{ type: 'text', text: promptWithContext }],
@@ -643,6 +635,7 @@ export class ConversationBridge {
 
   /** 向当前 peer 发送文本（自动分块 + typing 指示）。 */
   async sendText(text) {
+    if (this.platform?.status === 'idle' || this.platform?.status === 'offline') return
     const peer = this.peerId || this.config.allowFrom?.[0]
     if (!peer) return
     const chunks = splitForIM(text, this.config.maxMessageChars)
@@ -711,6 +704,7 @@ export class ConversationBridge {
         stopHeartbeat(state)
       }
       if (session.id !== this.activeSessionId) return
+      if (this.platform?.status === 'idle' || this.platform?.status === 'offline') return
 
       if (event.type === 'turn/start') {
         const turn = event.data?.turn
@@ -726,36 +720,21 @@ export class ConversationBridge {
       const getSessionCwd = (sess) => sess?.cwd || this.config.cwd || process.cwd()
 
       if (event.type === 'tool/call') {
-        const cwd = getSessionCwd(session)
-        let args = event.data?.parameters || event.data?.args || event.data?.arguments || {}
-        if (typeof args === 'string') {
-          try { args = JSON.parse(args) } catch {}
-        }
-        if (typeof args === 'object' && args !== null) {
-          const possibleKeys = [
-            'TargetFile', 'targetFile', 'target_file', 'path', 'filePath', 'file',
-            'destination', 'out_file', 'output', 'ImageName', 'fileName', 'filename'
-          ]
-          for (const k of possibleKeys) {
-            const val = args[k]
-            if (val && typeof val === 'string') {
-              const clean = val.trim().replace(/^["'`]|["'`]$/g, '').replace(/^file:\/\/\/?/, '')
-              if (clean) state.createdFiles.add(clean)
-            }
-          }
-        }
-        const rawStr = JSON.stringify(event.data || {})
-        const fromRaw = extractFilePathsFromText(rawStr, cwd)
-        for (const f of fromRaw) state.createdFiles.add(f)
+        // 工具执行仅在终端/状态中展示，文件直发由 AI 回复中的 [SEND_FILE: ...] 指令显式驱动，杜绝误判
         return
       }
       if (event.type === 'assistant/message') {
-        const text = textOfAssistantMessage(event.data.message)
-        if (text.trim()) {
+        const rawText = textOfAssistantMessage(event.data.message)
+        if (rawText.trim()) {
           const cwd = getSessionCwd(session)
-          const fromText = extractFilePathsFromText(text, cwd)
-          for (const f of fromText) state.createdFiles.add(f)
-          void this.sendText(text)
+          const { cleanText, files } = extractAndStripSendFileDirectives(rawText, cwd)
+          for (const f of files) {
+            state.createdFiles.add(f)
+          }
+          // 仅向聊天窗口发送过滤掉 [SEND_FILE: ...] 控制指令后的纯净正文
+          if (cleanText) {
+            void this.sendText(cleanText)
+          }
         }
         return
       }
@@ -771,20 +750,19 @@ export class ConversationBridge {
           void this.sendText(`⚠️ **达到模型单轮输出上限，本轮内容已截断**`)
         }
 
-        // 如果本轮生成/记录了产物文件，下发清单通知并尝试直接上传文件至聊天窗口
+        // 如果本轮 AI 显式指定了 [SEND_FILE: ...] 文件发送指令，直接上传并发送给用户
         if (state.createdFiles && state.createdFiles.size > 0) {
           const rawFiles = Array.from(state.createdFiles)
           const cwd = getSessionCwd(session)
-          const fileLines = rawFiles.map((f) => `- \`${f}\``).join('\n')
-          void this.sendText(`📦 **本轮已生成产物文件**：\n${fileLines}`)
-
-          // 如果平台支持 sendMediaFile，自动尝试直接发送真实存在的文件/图片到聊天窗口（严格按绝对路径去重）
           const targetPeer = this.peerId || this.config.allowFrom?.[0]
+
           if (typeof this.platform?.sendMediaFile === 'function' && targetPeer) {
-            const uniqueFilesToSend = new Set()
+            const uniqueFilesToSend = []
             for (const f of rawFiles) {
               const resolved = resolveFilePath(f, cwd)
-              if (resolved) uniqueFilesToSend.add(resolved)
+              if (resolved && !uniqueFilesToSend.includes(resolved)) {
+                uniqueFilesToSend.push(resolved)
+              }
             }
             for (const resolved of uniqueFilesToSend) {
               try {
@@ -1558,6 +1536,7 @@ export const conversationBridgeHelpers = {
   textOfAssistantMessage,
   resolveFilePath,
   extractFilePathsFromText,
+  extractAndStripSendFileDirectives,
   sessionsInDisplayOrder,
   listSessions,
   renderSessions,

package/lib/qq/gateway.js

@@ -164,9 +164,16 @@ export class QqGateway extends Service {
   async stop() {
     this.stopRequested = true
     this.clearHeartbeat()
+    const finish = this._finishConnect
+    this._finishConnect = null
+    if (finish) {
+      try { finish(new Error('Stopped by user')) } catch {}
+    }
     const ws = this.ws
     this.ws = null
-    if (ws) { try { ws.removeAllListeners(); ws.close(); ws.terminate() } catch {} }
+    if (ws) {
+      try { ws.close(); ws.terminate() } catch {}
+    }
     const task = this.loopTask
     this.loopTask = null
     if (task) await task.catch(() => {})
@@ -227,11 +234,13 @@ export class QqGateway extends Service {
       try {
         this.setStatus('starting')
         const token = await this.refreshAccessToken()
+        if (this.stopRequested) break
         // 官方「获取带分片 WSS 接入点」接口，返回网关地址与建议分片数
         // 参考：https://bot.q.qq.com/wiki/develop/api-v2/dev-prepare/event-emit/websocket.html
         const gateway = this.config.gatewayUrl
           || ((await requestJson(`${API_BASE}/gateway/bot`, { token, timeoutMs: this.config.apiTimeoutMs })).url)
           || DEFAULT_GATEWAY
+        if (this.stopRequested) break
         await this.connect(gateway, token)
         backoffMs = this.config.reconnectDelayMs
       } catch (error) {
@@ -247,18 +256,32 @@ export class QqGateway extends Service {
 
   connect(url, token) {
     return new Promise((resolve, reject) => {
+      if (this.stopRequested) {
+        resolve()
+        return
+      }
       const ws = new WebSocket(url)
       this.ws = ws
       let settled = false
       const finish = (error) => {
         if (settled) return
         settled = true
+        this._finishConnect = null
         this.clearHeartbeat()
         if (this.ws === ws) this.ws = null
         error ? reject(error) : resolve()
       }
-      ws.on('open', () => this.logger?.info?.('[dsh-bridge qq] WebSocket connected to QQ Open Platform'))
+      this._finishConnect = finish
+
+      ws.on('open', () => {
+        if (this.stopRequested) {
+          finish()
+          return
+        }
+        this.logger?.info?.('[dsh-bridge qq] WebSocket connected to QQ Open Platform')
+      })
       ws.on('message', (raw) => {
+        if (this.stopRequested) return
         let payload
         try { payload = JSON.parse(String(raw)) } catch { return }
         void this.handlePayload(payload, token, ws).catch(finish)
@@ -269,6 +292,7 @@ export class QqGateway extends Service {
   }
 
   async handlePayload(payload, token, ws) {
+    if (this.stopRequested) return
     const op = Number(payload?.op)
     if (payload?.s != null) this.sequence = payload.s
     if (op === 10) {

package/lib/qq/node.js

@@ -360,6 +360,7 @@ export class QqConversationNode extends ConversationBridge {
   // ---- 入站 ----
 
   async _handleInbound(event) {
+    if (this.gateway?.stopRequested) return
     const sender = String(event.senderId ?? '').trim()
     if (!sender) return
 
@@ -449,6 +450,7 @@ export class QqConversationNode extends ConversationBridge {
   // ---- 互动事件 ----
 
   async _handleInteraction(event) {
+    if (this.gateway?.stopRequested) return
     const sender = String(event.senderId ?? '').trim()
     if (!sender) return
 

package/lib/telegram/gateway.js

@@ -365,8 +365,11 @@ export class TelegramGateway extends Service {
           consecutiveErrors = 0
           if (this.status !== 'online') this.setStatus('online')
 
+          if (this._stopPolling) break
+
           if (Array.isArray(updates) && updates.length > 0) {
             for (const update of updates) {
+              if (this._stopPolling) break
               if (this._seenUpdates.has(update.update_id)) continue
               this._seenUpdates.add(update.update_id)
               if (this._seenUpdates.size > 2000) {

package/lib/telegram/node.js

@@ -95,6 +95,7 @@ export class TelegramConversationNode extends ConversationBridge {
   }
 
   async _handleInbound(event) {
+    if (this.gateway?._stopPolling) return
     const { chatId, senderId, senderUsername, isGroup, text, messageId, raw } = event
     this._lastPeer = { chatId, senderId, senderUsername, isGroup }
     const authId = isGroup ? chatId : senderId

package/lib/wechat/gateway.js

@@ -845,8 +845,10 @@ export class WechatGateway extends Service {
         if (this.statusValue !== 'connected') {
           this.logger?.info?.('[dsh-bridge wechat] connected to iLink platform')
         }
+        if (this.stopPollingLocal) break
         this.setStatus('connected')
         for (const message of batch.messages) {
+          if (this.stopPollingLocal) break
           this.dispatchInbound(message)
         }
         if (this.c.pollIdleDelayMs > 0) await sleep(this.c.pollIdleDelayMs)

package/lib/wechat/node.js

@@ -67,6 +67,7 @@ export class WechatConversationNode extends ConversationBridge {
   // ---- 入站 ----
 
   async _handleInbound(message) {
+    if (this.ctx?.wechat?.stopPollingLocal) return
     const sender = String(message.from_user_id ?? '').trim()
     if (!sender) return
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@wenbin_wb/dsh-bridge",
-  "version": "2.8.4",
+  "version": "2.8.5",
   "description": "手机扫码即可在移动端/公网继续用 DeepSeek Harness，人不在电脑前也能接着干。一键局域网二维码、Cloudflare 公网隧道、自建隧道与微信 / QQ / 飞书 / Telegram Bot（多工作区/会话持久化/媒体/卡片审批/流式输出），无需自己搭公网服务器。",
-  "releaseNotes": "【v2.8.4 会话列表 Web 端 1:1 深度对齐与归档过滤修复】\n• 🗂️ 严格按工作区账本对齐会话列表：修复会话列表展示冗余，严格以 DSH 官方工作区账本为准，自动过滤子代理派生会话、空白草稿与已归档会话，与 Web 端侧边栏 1:1 保持一致",
+  "releaseNotes": "【v2.8.5 产物文件推送改为 AI 指令驱动 & 修复 IM 平台断开连接问题】\n• 🎯 显式文件发送协议：由 AI 通过 [SEND_FILE: <路径>] 显式驱动文件直传，杜绝修改代码时的文件误发风暴\n• 🧹 聊天正文自动净化：自动剔除聊天窗口中的文件发送指令，保持聊天气泡清爽\n• 🔌 修复 IM 断开连接失效：修复 QQ 等网关断开连接时 WebSocket 事件悬挂问题，断开后彻底阻断入站消息与出站回复",
   "type": "module",
   "main": "lib/index.js",
   "exports": {