dsh-qq-bridge DSH 插件

本插件通过QQ官方机器人API v2与DSH集成，让你直接在QQ里使用完整的Agent工具链、模型切换与工作区。每个QQ对话拥有独立、持久的隔离Agent会话，支持首访审批、多媒体处理、文件传输等功能。

如何安装 dsh-qq-bridge DSH 插件

dsh plugin --profile dev add ~/dsh-qq-bridge

复制不会执行命令。安装 dsh-qq-bridge DSH 插件前请核对仓库和版本。

dsh-qq-bridge DSH 插件数据来源

dsh-qq-bridge DSH 插件快照日期：2026年8月16日

discovered

dsh-qq-bridge DSH 插件能做什么

零依赖WebSocket网关，支持token刷新、心跳检测、指数退避重连和Resume补发。
每QQ对话隔离Agent会话，按工作区隔离历史，重启自动恢复。
Steering插嘴：任务运行中继续发消息，立即注入下一步骤。
完整命令体系：/help、/status、/model、/thinking、/new、/sessions、/resume、/compact、/stop、/workspace加键盘按钮。
首访审批：未授权用户自动生成审批码，管理员一键授权（支持普通用户/管理员两级）。

dsh-qq-bridge DSH 插件适合哪些场景

通过QQ与DSH Agent聊天，保留完整对话历史与工具访问。
使用QQ控制执行长期任务的Agent，支持插嘴和中止。
在QQ上管理多个工作区并切换。

dsh-qq-bridge DSH 插件适合谁

希望在手机上通过QQ与Agent交互的DSH用户。
需要将QQ机器人集成到DSH中进行测试或生产的开发者。

dsh-qq-bridge DSH 插件的限制

群聊功能在代码层面完整支持，但由于QQ开放平台沙箱限制无法在沙箱中测试，需要提审上线后才能使用。
需要自备QQ官方机器人应用（appId和clientSecret）。

dsh-qq-bridge DSH 插件的仓库 README 摘录

以下文字摘自 dsh-qq-bridge DSH 插件的上游仓库 xiaomengxinbb/dsh-qq-bridge 的 README，版权归原作者，仅作引用。

**将 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](https://github.com/xiaomengxinbb/pi-qq-bridge)（Apache-2.0）： > 宿主无关模块（网关/路由/命令/媒体/格式化）原样复用；宿主绑定层（会话创建/工具/命令）改为 DSH 官方 API。 --- ## 架构 ``` QQ 平台 WS 事件 → src/gateway/qq-gateway.ts（状态机/心跳/重连/Resume） → src/router.ts（去重 → 白名单/审批 → 命令 | FIFO 队列 → 隔离会话） → src/session/qq-session.ts（DSH 适配：ctx.agents.create/resume + followup/whenIdle） → 最终文本 → src/reply-formatter.ts（Markdown 分块 → 降级纯文本）→ QQApi 发送 ```

阅读完整 README仓库许可: Apache-2.0

dsh-qq-bridge DSH 插件常见问题

如何安装dsh-qq-bridge？

克隆仓库，在目录中执行pnpm install安装依赖。然后使用dsh plugin --profile <profile> add <路径>命令将插件添加到DSH配置文件中。开发时使用dev profile，正式使用时使用web profile。添加后，复制config.example.json到~/.dsh/qq-bridge/config.json并填写QQ机器人凭证。

dsh-qq-bridge支持群聊吗？

代码层面完整支持群聊，包括群内@回复和白名单。但由于QQ开放平台沙箱限制，个人开发者无法在沙箱中测试群聊。要正式使用，需要将机器人提审上线，设置sandbox为false，邀请机器人入群，获取群openid并加入allowGroups配置，然后重启桥。

如何批准新用户访问QQ机器人？

未授权用户发消息时，机器人会生成一个审批码。管理员在DSH Web聊天中使用/qqbot-approve命令批准。先用/qqbot-requests查看待审批列表，然后用/qqbot-approve <码> <user|admin>批准。批准admin级别需要加上--yes进行二次确认。

Agent能否发送文件到QQ？

可以，Agent可以调用qq_send_local_file工具将本地文件发回QQ。该功能有白名单和竞态防护，需要在config.json中配置outboundMedia相关设置。

使用dsh-qq-bridge需要什么前提？

需要安装DSH环境并添加本插件，以及QQ官方机器人应用的appId和clientSecret。WebSocket网关仅使用Node内置模块，无需外部依赖，但需要Node.js和TypeScript支持。