dsh-qqbot：让 DeepSeek Harness 通过 QQ Bot 对话的官方 DSH plugin
tencent-connect/dsh-qqbot
将 QQ Bot 接入 DeepSeek Harness 的官方插件，让 QQ 消息驱动 dsh agent 对话。
把 DeepSeek Harness 接入 QQ 消息平台，让用户直接在 QQ 里与 dsh agent 对话，无需终端或网页。
dsh plugin --profile web add github:tencent-connect/dsh-qqbot- 分类
- 集成与连接
- 平台
- DSH-Plugin
- 作者
- tencent-connect
- 分发方式
- 插件
dsh-qqbot 核心特性
dsh-qqbot 仓库信息
dsh-qqbot 仓库简介
dsh-qqbot 是 DeepSeek Harness（DSH）的官方 QQ Bot 插件（DSH plugin），由 tencent-connect 维护，采用 MIT 协议，基于 TypeScript 开发。它把 QQ 消息平台作为 dsh agent 的前端协议驱动，让用户可以直接在 QQ 里与 DeepSeek Harness 对话，无需打开终端或网页。该插件解决了 QQ 用户无法便捷使用 dsh 的问题，核心能力包括扫码登录、会话隔离、模型切换、Markdown 回复等。
dsh-qqbot 这个 DSH plugin 支持哪些核心特性？
dsh-qqbot 支持通过 QQ WebSocket 与 dsh agent 双向通信，每个私聊用户或群聊拥有独立 Agent 会话，支持 /new、/compact、/model、/stop 等斜杠命令，回复以 Markdown 格式发送，并自动切分长文本。会话闲置超时后自动回收，防止内存泄漏。
dsh-qqbot 怎么安装？
安装命令如下，首次启动会触发扫码引导，手机 QQ 扫码后凭据自动保存。
dsh plugin --profile web add github:tencent-connect/dsh-qqbot
也可以使用本地路径安装或 --patch 开发模式，具体见 README。
dsh-qqbot 有哪些配置项？
主要配置项包括 appId 和 appSecret（必填，可通过环境变量 QQBOT_APPID、QQBOT_SECRET 设置）、provider（默认 deepseek-official）、model（默认 deepseek-chat）、requireMention（群聊是否需要 @bot）、textChunkLimit（单条消息最大字符数，默认 4500）、sessionIdleTimeout（会话闲置超时，默认 30 分钟）等。
dsh-qqbot 的会话路由机制是怎样的？
会话 key 为 qqbot:${appId}:${scope}:${peerId}，通过 SHA-256 派生 SessionId，重启后可恢复。解析策略依次为进程内复用、持久化恢复、全新创建。
dsh-qqbot 的设计原则是什么？
遵循 dsh 的 "Plugins, not loop changes" 原则，作为纯 Cordis 插件，通过 inject = ['agents'] 声明式依赖，不直接耦合其他插件。支持通过 agent-presets 服务挂载预设，实现工具集和 prompt 的灵活配置。
dsh-qqbot 兼容哪些 DeepSeek Harness 版本和平台？
该插件基于 deepseek-harness 开发，建议升级至 0.4.0 以上版本以支持扫码链接在浏览器打开。适用于 QQ 桌面端和移动端，通过 WebSocket 连接。