xiaomengxinbb/dsh-qq-bridge

README 摘要

dsh-qq-bridge 将 QQ 接入 DeepSeek Harness 的双向桥插件 ——通过 QQ 官方机器人 API v2（私聊 + 群聊）， 让你直接在 QQ 里驱动 DeepSeek Harness 的 Agent：每个 QQ 对话拥有独立、持久的隔离 Agent 会话， 像在 Web 里一样使用完整的工具链、模型切换与工作区。 ✨ 特性 - 🔌 零依赖网关 ：QQ 官方 WebSocket 协议（token 预刷新 / 心跳假死检测 / 指数退避重连 / Resume 补发），仅用 Node 内置能力 - 🧊 隔离会话 ：每 QQ 对话 ↔ 一个持久 DSH Agent（ agents.create/resume ），历史按 (对话, 工作区) 隔离，重启自动恢复 - ⚡ steering 插嘴 ：任务运行中继续发消息，立即注入下一步骤（DSH 原生） - 📚 完整命令体系 ： /help /status /model /thinking /new /sessions /resume /compact /stop /workspace + 键盘按钮 - 🔐 首访审批 ：未授权用户自动生成审批码，管理员一键授权（支持普通用户/管理员两级） - 🖼️ 多媒体 ：图片直入视觉模型、语音 ASR/STT、TXT/PDF 有界提取；安全下载（SSRF 防护） - 📤 出站文件 ：Agent 可调用 qq send local file 把本地文件发回 QQ（白名单 + 硬链接/竞态防护） - 🗂️ 多工作区 ：QQ 侧 /workspace 切换目录，会话历史按工作区隔离 - ✅ 实测可用 ：116 个单测 + 真实 QQ 沙箱文本闭环验证 移植自 pi-qq-bridge（Apache-2.0）： 宿主无关模块（网关/路由/命令/媒体/格式化）原样复用；宿主绑定层（会话创建/工具/命令）改为 DSH 官方 API。 架构 模块 说明 src/gateway/ token 管理 / WS 网关 / REST 发送与上传（宿主无关，原样移植） src/session/ DSH 隔离会话 ：每 QQ 对话 ↔ 一个持久 DSH agent（sessionId qq- - ，cwd = 桥工作区）；注册表懒创建/回收/工作区切换 src/router.ts 消息路由、steering 插嘴、回复预算（宿主无关） src/commands/ QQ 侧命令、授权矩阵、审批码、键盘（宿主无关） src/media/ 附件安全下载/嗅探/提取/STT/出站媒体（宿主无关；图片经 ctx.attachments ） src/core/ 配置（schemaVersion 4 严格校验）/ 类型 / 错误码（宿主无关） 关键宿主 API （详见 HOST-A…

分类