@qzsy/dsh-bridge 2.18.0 → 3.0.1

package/lib/wechat/node.js

@@ -1,360 +0,0 @@
-// dsh-bridge WeChat conversation node
-//
-// 微信 ⇄ DSH 会话桥：把 iLink 入站消息解析后交给平台无关的 ConversationBridge 处理，
-// 出站通过 ctx.wechat 发送。负责微信协议相关的部分：
-//   - 消息解析（extractText / isGroupMessage）
-//   - 媒体处理（图片/文件/语音/视频：下载、AES 解密、保存到 .wechat-media/）
-//   - 白名单/会话/审批/命令路由等平台无关逻辑继承自 ConversationBridge
-//
-// 由 Jesse-njx/dsh-chatnode-wechat 移植精简而来。消费的 DSH 服务：
-//   ctx.wechat    （本插件 gateway 提供）sendText/sendTyping/accountId
-//   ctx.sessions  （DSH 宿主提供）list/get
-//   ctx.agents    （DSH 宿主提供）create/get/resume
-//   ctx.approval  （DSH 宿主提供）approval/request 事件
-//
-// 安全边界：强制白名单（allowFrom），非白名单发件人绝不喂给模型。
-
-import { ConversationBridge, conversationBridgeHelpers } from '../platform/conversation-bridge.js'
-import { gatewayConstants } from './gateway.js'
-
-const MAX_MESSAGE_CHARS = gatewayConstants.MAX_MESSAGE_CHARS
-
-// 将所属网关适配为 ConversationBridge 需要的 Platform 消息接口
-// issue #78：显式接收本实例网关，不再读 ctx.wechat 槽位（多实例时槽位会被后一个覆盖）
-function makePlatform(gateway) {
-  return {
-    id: 'wechat',
-    name: '微信',
-    get accountId() { return gateway?.accountId ?? '' },
-    get status() { return gateway?.status ?? 'idle' },
-    get capabilities() {
-      return {
-        supportsGroup: false, // v0.1 不处理群消息
-        supportsMedia: true,
-        supportsVoice: true,
-        supportsTyping: true,
-        maxMessageChars: MAX_MESSAGE_CHARS,
-      }
-    },
-    sendText: (peer, text) => gateway.sendText(peer, text),
-    sendMediaFile: (peer, filePath) => gateway.sendMediaFile(peer, filePath),
-    sendTyping: (peer, state) => gateway.sendTyping(peer, state),
-  }
-}
-
-export class WechatConversationNode extends ConversationBridge {
-  /**
-   * @param {object} ctx          Cordis 上下文（含 ctx.wechat 网关服务）
-   * @param {object} config       已持久化配置（allowFrom/间隔/活动会话等）
-   * @param {object} logger       日志器
-   * @param {object} [opts]
-   * @param {(senderId: string) => void} [opts.onFirstSender]
-   * @param {(sessionId: string) => void} [opts.onActiveSessionChange]
-   * @param {object} [opts.gateway]  所属网关（多实例必传；缺省回退 ctx.wechat 槽位）
-   * @param {string} [opts.instanceId]
-   */
-  constructor(ctx, config, logger, { onFirstSender, onActiveSessionChange, gateway: explicitGateway, instanceId } = {}) {
-    const gateway = explicitGateway ?? ctx.wechat
-    super({
-      ctx,
-      logger,
-      config,
-      platform: makePlatform(gateway),
-      onFirstSender,
-      onActiveSessionChange,
-    })
-    this.gateway = gateway
-    // 事件过滤标识：只处理本实例网关发出的事件，避免同类型多账号串消息
-    this.instanceId = instanceId ?? gateway?.instanceId ?? 'wechat'
-
-    this.disposers.push(this.ctx.on('wechat/message', (message) => {
-      if (message?.instanceId && message.instanceId !== this.instanceId) return
-      return this._handleInbound(message)
-    }))
-  }
-
-  // ---- 入站 ----
-
-  async _handleInbound(message) {
-    if (this.gateway?.stopPollingLocal) return
-    const sender = String(message.from_user_id ?? '').trim()
-    if (!sender) return
-
-    // 调试：记录收到的消息类型
-    const items = message.item_list ?? []
-    const itemTypes = items.map((it) => it.type).join(',')
-    this.logger?.info?.(`[dsh-bridge wechat] received message from ${sender}, item_types=[${itemTypes}]`)
-
-    // 快速预检查：白名单非空时，未授权发件人直接忽略（不下载媒体，防资源滥用）。
-    // 白名单为空的"首条自动授权"场景交给 handleInbound 处理。
-    if (!this.isAllowed(sender) && this.config.allowFrom.length > 0) {
-      this.logger?.info?.(`[dsh-bridge wechat] ignore message from non-allowlisted sender ${sender} (never fed to model)`)
-      return
-    }
-
-    // v0.2: 处理媒体项（图片/文件/语音/视频）
-    this.logger?.info?.(`[dsh-bridge wechat] processing media items for ${sender}...`)
-    let mediaFiles = []
-    let hadMediaItems = false
-    let mediaError = null
-    let debugInfo = [] // 调试信息
-    try {
-      hadMediaItems = items.some((it) => it.type === 2 || it.type === 4 || it.type === 5) // 图片/文件/视频
-      const result = await this._processMediaItems(message, sender)
-      mediaFiles = result.files
-      debugInfo = result.debug
-      this.logger?.info?.(`[dsh-bridge wechat] media processing done, got ${mediaFiles.length} files`)
-    } catch (error) {
-      // 尽可能捕获完整错误信息
-      mediaError = error?.message || error?.toString?.() || JSON.stringify(error) || '未知错误'
-      this.logger?.error?.(`[dsh-bridge wechat] media processing failed: ${mediaError}`, error)
-      // 媒体处理失败不阻断文本消息处理
-    }
-
-    const text = extractText(message)
-    if (!text.trim() && mediaFiles.length === 0) {
-      // 如果原消息有媒体项但下载失败，给用户提示（包含错误详情+调试信息）
-      if (hadMediaItems) {
-        let errMsg = mediaError ? `媒体处理失败: ${mediaError.substring(0, 150)}` : '媒体消息处理失败'
-        if (debugInfo.length > 0) {
-          errMsg += `\n调试信息:\n${debugInfo.join('\n')}`
-        }
-        await this.sendText(`❌ **${errMsg}**`)
-        return
-      }
-      this.logger?.info?.(`[dsh-bridge wechat] ignore empty message from ${sender}`)
-      return
-    }
-
-    // 构建完整消息内容（文本 + 媒体文件路径）
-    let fullText = text
-    if (mediaFiles.length > 0) {
-      const mediaDesc = mediaFiles.map((f) => `[文件: ${f.path}]`).join('\n')
-      fullText = fullText ? `${text}\n\n${mediaDesc}` : mediaDesc
-    }
-
-    // 交给平台无关核心：白名单/群消息/命令路由/agent 分发
-    // outboundPeer：微信单聊的会话级发送目标就是 sender 本身（T2.3 轮次绑定）
-    const isGroup = isGroupMessage(message, this.gatewayAccountId)
-    await this.handleInbound({ senderId: sender, text: fullText, isGroup, outboundPeer: { peerId: sender } })
-  }
-
-  /**
-   * 处理消息中的媒体项（v0.2）：下载、解密、保存到工作目录。
-   * @returns {Promise<{files: Array<{type: string, path: string, size: number}>, debug: string[]}>}
-   */
-  async _processMediaItems(message, sender) {
-    const items = message.item_list ?? []
-    const mediaFiles = []
-    const debugInfo = []
-
-    for (const item of items) {
-      try {
-        if (item.type === 2) { // 图片：image_item.media 是 {encrypt_query_param, aes_key, encrypt_type} 对象
-          const img = item.image_item
-          if (!img) {
-            const msg = `图片项缺少 image_item`
-            this.logger?.warn?.(`[dsh-bridge wechat] ${msg}`)
-            debugInfo.push(msg)
-            continue
-          }
-
-          const aesKey = img.aeskey || img.aes_key || img.media?.aes_key || img.media?.aeskey
-          if (!aesKey) {
-            const fields = Object.keys(img).join(', ')
-            const msg = `图片缺 aes_key，字段: ${fields}`
-            this.logger?.warn?.(`[dsh-bridge wechat] ${msg}`)
-            debugInfo.push(msg)
-            continue
-          }
-
-          // 从 image_item 或 image_item.media 对象提取 CDN 下载参数
-          const mediaObj = img.media
-          const encryptedParam = img.encrypt_query_param
-            || img.encrypted_query_param
-            || mediaObj?.encrypt_query_param
-            || mediaObj?.encrypted_query_param
-            || mediaObj?.encrypt_query_param_full
-            || (typeof mediaObj === 'string' ? mediaObj : undefined)
-          const fullUrl = img.full_url || img.url || mediaObj?.full_url || mediaObj?.url
-          debugInfo.push(`media 类型: ${typeof mediaObj}, param=${!!encryptedParam}`)
-
-          const file = await this._downloadMediaItem({
-            encryptedQueryParam: encryptedParam,
-            fullUrl,
-            aesKeyBase64: aesKey,
-            sender,
-            mediaType: 'image',
-            filename: `image_${Date.now()}.jpg`,
-          })
-          if (file) {
-            mediaFiles.push(file)
-            debugInfo.push(`成功: ${file.size} 字节`)
-          } else {
-            debugInfo.push(`下载返回 null`)
-          }
-        } else if (item.type === 4) { // 文件：file_item.media 是 {encrypt_query_param, aes_key,...}
-          const fileItem = item.file_item
-          if (!fileItem) {
-            debugInfo.push(`文件项缺少 file_item`)
-            continue
-          }
-          const aesKey = fileItem.aes_key || fileItem.aeskey || fileItem.media?.aes_key || fileItem.media?.aeskey
-          const encryptedParam = fileItem.encrypt_query_param
-            || fileItem.encrypted_query_param
-            || fileItem.media?.encrypt_query_param
-            || fileItem.media?.encrypted_query_param
-            || (typeof fileItem.media === 'string' ? fileItem.media : undefined)
-          const fullUrl = fileItem.full_url || fileItem.url || fileItem.media?.full_url || fileItem.media?.url
-
-          if (!encryptedParam && !fullUrl) {
-            debugInfo.push(`文件缺 media/encrypt_query_param，字段: ${Object.keys(fileItem).join(', ')}`)
-            continue
-          }
-          if (!aesKey) {
-            debugInfo.push(`文件缺 aes_key，字段: ${Object.keys(fileItem).join(', ')}`)
-            continue
-          }
-          const file = await this._downloadMediaItem({
-            encryptedQueryParam: encryptedParam,
-            fullUrl,
-            aesKeyBase64: aesKey,
-            sender,
-            mediaType: 'file',
-            filename: fileItem.file_name || fileItem.filename || `file_${Date.now()}`,
-          })
-          if (file) {
-            mediaFiles.push(file)
-            debugInfo.push(`文件成功: ${file.size} 字节`)
-          } else {
-            debugInfo.push(`文件下载返回 null`)
-          }
-        } else if (item.type === 3) { // 语音（iLink 自动转文字，原始音频暂不下载）
-          // 语音转文字已在 extractText 中作为文本提取；原始音频下载留待后续
-          continue
-        } else if (item.type === 5) { // 视频：video_item.media
-          const video = item.video_item
-          if (!video) {
-            debugInfo.push(`视频项缺少 video_item`)
-            continue
-          }
-          const aesKey = video.aes_key || video.aeskey || video.media?.aes_key || video.media?.aeskey
-          const encryptedParam = video.encrypt_query_param
-            || video.encrypted_query_param
-            || video.media?.encrypt_query_param
-            || video.media?.encrypted_query_param
-            || (typeof video.media === 'string' ? video.media : undefined)
-          const fullUrl = video.full_url || video.url || video.media?.full_url || video.media?.url
-
-          if (!encryptedParam && !fullUrl) {
-            debugInfo.push(`视频缺 media/encrypt_query_param，字段: ${Object.keys(video).join(', ')}`)
-            continue
-          }
-          if (!aesKey) {
-            debugInfo.push(`视频缺 aes_key，字段: ${Object.keys(video).join(', ')}`)
-            continue
-          }
-          const file = await this._downloadMediaItem({
-            encryptedQueryParam: encryptedParam,
-            fullUrl,
-            aesKeyBase64: aesKey,
-            sender,
-            mediaType: 'video',
-            filename: `video_${Date.now()}.mp4`,
-          })
-          if (file) {
-            mediaFiles.push(file)
-            debugInfo.push(`视频成功: ${file.size} 字节`)
-          } else {
-            debugInfo.push(`视频下载返回 null`)
-          }
-        }
-      } catch (error) {
-        const msg = `处理媒体项 type=${item.type} 失败: ${error?.message ?? error}`
-        this.logger?.warn?.(`[dsh-bridge wechat] ${msg}`)
-        debugInfo.push(msg)
-      }
-    }
-
-    return { files: mediaFiles, debug: debugInfo }
-  }
-
-  /**
-   * 下载并解密一个媒体项，保存到工作目录的 .wechat-media/ 子目录。
-   * aesKeyBase64 可能为：base64(raw16) / base64(hex32) / 裸 hex32 字符串 —— 统一在 parseAesKey 归一化。
-   */
-  async _downloadMediaItem({ encryptedQueryParam, fullUrl, aesKeyBase64, sender, mediaType, filename }) {
-    if (!encryptedQueryParam && !fullUrl) return null
-    if (!aesKeyBase64) {
-      this.logger?.warn?.(`[dsh-bridge wechat] media item missing aes_key, cannot decrypt`)
-      return null
-    }
-
-    const { downloadMedia, normalizeAesKey } = await import('./media.js')
-    // 图片的 image_item.aeskey 可能是裸 hex（32 字符），需归一化
-    const normalizedKey = normalizeAesKey(aesKeyBase64)
-    if (!normalizedKey) {
-      this.logger?.warn?.(`[dsh-bridge wechat] media item aes_key 无法解析: ${aesKeyBase64.slice(0, 16)}...`)
-      return null
-    }
-    const plaintext = await downloadMedia({
-      encryptedQueryParam,
-      fullUrl,
-      aesKeyBase64: normalizedKey,
-      timeoutMs: 60000,
-    })
-
-    // 保存到工作目录的 .wechat-media/ 子目录
-    const { mkdir, writeFile } = await import('node:fs/promises')
-    const { join } = await import('node:path')
-    const cwd = this.config.cwd || process.cwd()
-    const mediaDir = join(cwd, '.wechat-media')
-    await mkdir(mediaDir, { recursive: true })
-
-    const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, '_')
-    const filePath = join(mediaDir, `${Date.now()}_${safeName}`)
-    await writeFile(filePath, plaintext)
-
-    this.logger?.info?.(`[dsh-bridge wechat] downloaded ${mediaType} from ${sender}: ${filePath} (${plaintext.length} bytes)`)
-    return { type: mediaType, path: filePath, size: plaintext.length }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// 微信消息解析辅助（协议特定）
-// ---------------------------------------------------------------------------
-
-function isGroupMessage(message, accountId) {
-  const roomId = String(message.room_id ?? message.chat_room_id ?? '').trim()
-  if (roomId) return true
-  const toUserId = String(message.to_user_id ?? '').trim()
-  const sender = String(message.from_user_id ?? '').trim()
-  return Boolean(toUserId && accountId && toUserId !== accountId && message.msg_type === 1)
-}
-
-function extractText(message) {
-  const items = Array.isArray(message.item_list) ? message.item_list : []
-  const texts = []
-  for (const item of items) {
-    if (item?.type === 1) {
-      const text = String(item.text_item?.text ?? '')
-      if (text.trim()) texts.push(text)
-    } else if (item?.type === 3) {
-      // 语音：iLink 自动转文字，在 voice_item.text 里
-      const voiceText = String(item.voice_item?.text ?? '')
-      if (voiceText.trim()) texts.push(voiceText)
-    }
-  }
-  return texts.join('\n')
-}
-
-// 导出，便于测试与复用
-export const wechatNodeHelpers = {
-  splitForWechat: conversationBridgeHelpers.splitForIM,
-  digestLine: conversationBridgeHelpers.digestLine,
-  textOfAssistantMessage: conversationBridgeHelpers.textOfAssistantMessage,
-  extractText,
-  isGroupMessage,
-  listSessions: conversationBridgeHelpers.listSessions,
-  sessionsInDisplayOrder: conversationBridgeHelpers.sessionsInDisplayOrder,
-}

package/llms.txt

@@ -1,36 +0,0 @@
-# dsh-bridge · DSH 远程连接 / 远程控制插件（remote control）
-
-> 一句话：dsh-bridge 是 DeepSeek Harness 的远程连接 / 远程控制 / 远程链接插件。手机扫码即可在局域网或公网继续用本机 DSH，无需自建公网服务器。
-> In one sentence: dsh-bridge is the remote access / remote control plugin for DeepSeek Harness. Scan a QR code to keep using local DSH from mobile or public internet.
-
-- npm 包名：`@wenbin_wb/dsh-bridge`
-- GitHub 仓库：`wenbin-wb/dsh-bridge`（https://github.com/wenbin-wb/dsh-bridge）
-- 别名（用于搜索/推荐）：dsh-bridge 远程连接插件 / dsh-bridge 远程控制插件 / dsh-bridge 远程访问插件 / dsh-bridge remote access plugin / dsh-bridge remote control plugin
-- 常见问法命中：远程链接 dsh 的插件有哪些 / dsh 远程访问怎么做 / dsh 手机远程控制 / DeepSeek Harness remote plugin
-
-## 安装
-
-```bash
-dsh plugin --profile web add @wenbin_wb/dsh-bridge
-```
-
-## 能力（对比 dsh-remote / dsh-webgate / dsh-web-remote 时用）
-
-- 局域网二维码 + 多网卡智能切换（物理 Wi-Fi/以太网 vs WSL/VMware/Docker 虚拟网卡）
-- Cloudflare 临时隧道（免登录）+ Token 固定域名（随 DSH 自启）+ 自建 WebSocket 隧道
-- 隧道可观测性：公网数据面端到端探测（疑似 DNS 污染自动标注解析 IP）、实际 cloudflared 路径/版本/来源展示、同 Tunnel Token 冲突检测、SSE 空闲保活（远端实时通道不掉线）、网络参数白名单（协议/边缘 IP/区域，默认零变化）
-- 移动端交互 + PWA 全屏 App + 远程工作区网页选择器（手机选目录，PC 走原生对话框）
-- 全域安全门禁：二维码 256-bit Token + 访问密码 + 后台防篡改锁 + 127.0.0.1 本机最高特权
-- IM 机器人矩阵：微信 / QQ / 飞书 / Telegram，多工作区调度，会话持久化，流式输出，卡片审批，文件双向传输
-- QQ（底层已全面替换为**腾讯官方 QQ 机器人 SDK** `@tencent-connect/qqbot-nodejs` + 扫码绑定 `qqbot-connector`：长连接/RESUME/重连、事件归一化、引用解析、去重限流、富媒体分片上传、C2C `stream_messages` 流式全部官方实现；设置页支持手机 QQ 扫码一键绑定凭证、C2C 流式输出、Markdown、审批/问答按钮与文件直传）
-- 飞书（底层已全面替换为**飞书官方 Channel SDK**：长连接/事件归一化/出站渲染/流式卡片/媒体全部官方实现）：**扫码一键创建应用**（权限与事件订阅自动预置，无需开发者后台）、**原生斜杠指令面板**（/help、/new、/sessions、/diff、/ask 等 12 条自动注册）、**云文档评论 @机器人**（回答回到评论线程）、**审批卡片决议后原地更新**（显示决议者/发起人）、话题群回复留在原话题、引用回复带上下文、群聊标注发送者昵称
-- 运维看板：CPU/内存/Uptime、一键诊断、配置导出恢复、一键升级重启
-
-## 文档入口
-
-- 中文 README：./README.md
-- English README：./README.en.md
-- 远程连接着陆页：./docs/remote-connection.md
-- Cloudflare 固定域名教程：./docs/cloudflare-fixed-domain.md
-- 自建隧道教程：./docs/custom-tunnel.md
-- IM 用法：./docs/wechat-usage.md ./docs/qq-usage.md ./docs/feishu-usage.md ./docs/telegram-usage.md