MIT 开源、以一等公民方式原生接入 dsh 的官方 QQ Bot 插件（通过 `dsh plugin ... add` 安装）：在 QQ 里运行 DeepSeek Harness Agent，支持 per-peer 会话隔离、Markdown 分块回复、斜杠命令与扫码绑定凭据。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-28
许可证
MIT
01它能帮你完成什么？
在 QQ 私聊与群聊中直接与 DeepSeek Harness Agent 对话
dsh 的官方 QQ Bot 聊天渠道：消息经 QQ WebSocket 进入 dsh agent loop，支持 per-peer 独立 Agent、Markdown 分块回复、斜杠命令、扫码绑定凭据与 preset 挂载
希望直接在 QQ 私聊或群聊里使用 DeepSeek Harness（dsh）Agent 的开发者与普通用户
在 QQ 对话中直接管理 Agent 的会话、模型与 preset
内置斜杠命令：/new（别名 /reset /clear）、/compact、/model、/preset、/stop、/bot-ping、/bot-version、/bot-status、/bot-help
需要在聊天界面内控制会话上下文、切换模型或 preset、中止生成的 QQ bot 使用者
02如何接入 DeepSeek Harness？
前置条件
- 能通过 npx 运行官方 dsh CLI 的环境——README 中所有安装命令都基于 `npx @deepseek-ai/dsh`
- 在 QQ 开放平台创建好的 Bot：AppID / AppSecret，或通过 `QQBOT_APPID` / `QQBOT_SECRET` 环境变量提供
安装步骤
- 01
安装到 profile：`npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot`
$ npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- 02
启动：`npx @deepseek-ai/dsh --profile qqbot`
$ npx @deepseek-ai/dsh --profile qqbot
- 03
首次启动按终端扫码引导绑定凭据；也可以先 `export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"`
- 04
本地路径安装（可选）：`cd /path/to/dsh-qqbot && pnpm install && pnpm build`，再执行 `npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot`
$ npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot
验证接入成功
- 在 QQ 聊天里发送 `/bot-ping`——README 将其列为连通性测试
03DSH 适配与能力边界
dsh 一等公民插件：通过 `npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot` 安装到 dsh profile，用 `npx @deepseek-ai/dsh --profile qqbot` 启动；纯 Cordis 插件，遵循 dsh「Plugins, not loop changes」原则
QQ 私聊 / 群聊消息接入
QQ 私聊消息，或开启 `requireMention` 时群聊中 @bot 的消息→消息经 QQ WebSocket 传输进入 dsh agent loop；助手回复通过 QQ sendMarkdown 发送
首次启动未配置凭据时会进入终端扫码引导，并把凭据保存到 profileMarkdown 分块回复
Agent 的长回复文本→回复以 Markdown 格式发送，按代码块 / 表格感知切分；`textChunkLimit`（默认 4500）限制单条消息最大字符数
长回复会按 `textChunkLimit` 拆分成多条消息斜杠命令
/new、/compact、/model、/preset、/stop、/bot-ping、/bot-version、/bot-status、/bot-help→开始新会话、压缩会话历史、切换模型 / preset、中止生成、连通性测试、状态与帮助输出
/compact 会用摘要替换旧记录来压缩会话历史per-peer 会话隔离与恢复
一个 QQ peer——即一个私聊用户或一个群聊→每个 peer 各有一个独立 Agent；sessionKey（`qqbot:${appId}:${scope}:${peerId}`）由 SHA-256 确定性派生，重启后可恢复
闲置 Agent 超时自动 dispose，防止内存泄漏（默认 30 分钟）Preset 挂载
agent preset id，通过 `agent-presets` 服务挂载→应用预设的工具集、prompt 等 Agent 配置；preset 在新会话中生效
ask_user_question 问答互动
Agent 在对话中途向用户提出的问题→单选生成内联按钮（点一个其余变灰）、多选回复编号，逐题推进并带问题级超时
待答问题超过 `askTimeoutMs`（默认 300000ms / 5 分钟）会超时
04适合谁？何时不该用？
适合
- 希望直接在 QQ 私聊或群聊里使用 DeepSeek Harness（dsh）Agent 的开发者与普通用户
- 需要在聊天界面内控制会话上下文、切换模型或 preset、中止生成的 QQ bot 使用者
不适合
- 需要 QQ 开放平台的 Bot 凭据：`appId` 与 `appSecret` 均为必填（或通过 `QQBOT_APPID` / `QQBOT_SECRET` 环境变量提供）。首次启动未配置凭据时，插件会进入终端扫码引导，用手机 QQ 扫码绑定。
05兼容性、维护与安全提示
- 需要 QQ 开放平台的 Bot 凭据：`appId` 与 `appSecret` 均为必填（或通过 `QQBOT_APPID` / `QQBOT_SECRET` 环境变量提供）。首次启动未配置凭据时，插件会进入终端扫码引导，用手机 QQ 扫码绑定。
- 群聊默认需要 @bot 才触发（`requireMention` 默认 `true`）；单条回复消息受 `textChunkLimit` 限制（默认 4500 字符），超长回复会被拆分。
- README 提示建议升级至 `0.4.0` 以上版本再扫码，因为该版本支持点击链接在浏览器打开，可避免部分终端二维码渲染错位的问题。
MIT · 活跃维护中（最新版本 0.4.0，2026-08-16；最近推送 2026-08-26）
06常见问题
怎么把 dsh-qqbot 安装进 DeepSeek Harness？
用 `npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot` 安装到 dsh profile，再用 `npx @deepseek-ai/dsh --profile qqbot` 启动。也可以本地构建后通过本地路径安装：`npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot`。
QQ Bot 凭据怎么绑定？
首次启动未配置凭据时，插件会自动进入扫码引导：终端输出二维码 → 手机 QQ 扫码绑定 → 凭据自动保存到 profile，后续启动无需再次扫码。也可以直接用 `QQBOT_APPID` / `QQBOT_SECRET` 环境变量（对应配置 `appId` / `appSecret`）。
每个 QQ 会话都是独立的 Agent 吗？
是的，会话隔离是设计原则之一：每个 QQ 私聊用户 / 群聊各有一个独立 Agent。sessionKey（`qqbot:${appId}:${scope}:${peerId}`）由 SHA-256 确定性派生，重启后可恢复；闲置 Agent 会自动 dispose，防止内存泄漏。
内置了哪些斜杠命令？
`/new`（别名 `/reset` `/clear`）、`/compact`、`/model`、`/preset`、`/stop`、`/bot-ping`、`/bot-version`、`/bot-status`、`/bot-help`。例如 `/compact` 用摘要替换旧记录来压缩会话历史，`/bot-ping` 用于连通性测试。
长回复在 QQ 里怎么处理？
回复以 Markdown 格式发送，按代码块 / 表格感知切分；`textChunkLimit`（默认 4500）限制单条消息最大字符数。问答互动支持 `ask_user_question`：单选生成内联按钮（点一个其余变灰）、多选回复编号，逐题推进并带问题级超时。
07相关的 DSH 工作流
awesome-gpt-image-2
作者 freestylefly
Prompt as Code | GPT Image 2 / 2.5 提示词与案例库，530+ 个案例、20+ 套工业级模板与可复用 Skills，新增 2.5 同提示词对比专区，附完整提示词与生成记录，持续更新。
voyager
作者 voyager-crew
Enhancement suite for Gemini, AI Studio, Claude, ChatGPT & DeepSeek — plus a prompt manager for any website, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude、ChatGPT 与 DeepSeek 的增强套件；其中的提示词管理器可用于任意网站，如 DeepSeek Harness。
dsh-im
作者 xmanrui
通过扫码或机器人凭据把IM机器人接入DeepSeek Harness（支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp）。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
wegent
作者 wecode-ai
开源、可自托管的 AI 工作空间，用于规划、构建和交付代码、协作与自动化任务。
08数据与来源
**基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot 插件，将 DeepSeek AI 助手接入 QQ 私聊与群聊。*…
npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- **纯 Cordis 插件** — 遵循 dsh "Plugins, not loop changes" 原则
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-28。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。