dsh-qqbot DSH 插件

该插件允许你通过 QQ 消息与 dsh agent 进行交互。它作为传输层，将 QQ 消息转换为 agent 输入，并以 Markdown 格式回复。支持私聊和群聊，具备会话隔离和闲置超时回收功能。

如何安装 dsh-qqbot DSH 插件

dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot

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

dsh-qqbot DSH 插件数据来源

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

discovered

dsh-qqbot DSH 插件能做什么

接收并回复 QQ 私聊和群聊消息
内置斜杠命令：/bot-reset、/bot-model、/bot-status、/bot-help
会话管理，支持闲置超时自动释放 Agent，防止内存泄漏
智能分块发送长 Markdown 消息（含代码块、表格感知）
支持通过配置指定预设（preset）和模型，可挂载工具集

dsh-qqbot DSH 插件适合哪些场景

在 QQ 私聊中与 dsh agent 对话，作为个人 AI 助手
在 QQ 群中 @机器人触发 agent 执行任务，共享结果
将 dsh agent 的工作流集成到团队 QQ 群中，实现协作自动化

dsh-qqbot DSH 插件适合谁

希望通过 QQ 消息界面使用 dsh agent 的用户
需要构建基于 QQ 的 AI 助手，并利用 dsh agent 能力的开发者

dsh-qqbot DSH 插件的限制

需要自行提供 QQ Bot 的 AppID 和 AppSecret（首次启动也可扫码绑定）
群聊默认需要 @机器人才触发（可通过配置 requireMention 关闭）
仅支持 QQ 平台，不兼容其他即时通讯软件

dsh-qqbot DSH 插件的仓库 README 摘录

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

基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot IM 插件，将 QQ 消息平台作为 dsh agent 的前端协议驱动。中文 | [English](./README_EN.md) ## 架构 ``` QQ 用户 → QQ WebSocket → dsh-im-qqbot → ctx.agents → dsh agent loop → LLM ↑ │ └── session/event ──────────┘ (assistant reply → QQ sendMarkdown) ``` ## 安装 ### 方式一：手动执行 ```bash # 安装到 profile npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot # 启动 npx @deepseek-ai/dsh --profile qqbot ``` 首次启动时，插件检测到凭据未配置会自动进入扫码引导：终端输出二维码 → 手机 QQ 扫码绑定 → 凭据自动保存到 profile，后续启动无需再次扫码。 <img src="./docs/assets/qrcode.png" alt="二维码扫码示意图" width="280" /> > **提示**：建议升级至 `0.4.0` 以上版本扫码，支持点击链接在浏览器打开，避免部分终端二维码渲染错位的问题。 ### 方式二：本地路径安装 ```bash # 构建 cd /path/to/dsh-qqbot pnpm install && pnpm build # 安装到 profile（本地路径） npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot # 启动 export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret" npx @deepseek-ai/dsh --profile qqbot ``` ### 方式三：--patch 开发模式 ```bash export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret" npx @deepseek-ai/dsh web -

阅读完整 README仓库许可: MIT

dsh-qqbot DSH 插件常见问题

如何获取 QQ Bot 的 AppID 和 AppSecret？

你需要在 QQ 开放平台（https://q.qq.com）注册一个 QQ 机器人，创建后即可获得 AppID 和 AppSecret。另外，该插件首次启动时支持扫码绑定，无需手动配置凭据。

没有 QQ 机器人账号可以用这个插件吗？

不可以。你必须拥有一个 QQ 机器人账号（AppID 和 AppSecret），或者使用插件内置的扫码功能绑定。插件是 dsh 与 QQ Bot 之间的桥梁，需要有效的 QQ Bot 凭据。

插件支持群聊和私聊吗？

支持。插件既支持私聊也支持群聊。在群聊中，默认只有 @机器人时才会触发回复。你可以通过配置 `requireMention: false` 让机器人响应所有群消息。

有哪些内置的斜杠命令？

插件提供了四个内置斜杠命令：/bot-reset（重置当前会话，清除上下文）、/bot-model（查看或切换模型）、/bot-status（查看当前会话状态）、/bot-help（查看所有命令）。在私聊和群聊中均可使用。

如何重置会话或清除上下文？

在聊天中输入 `/bot-reset` 命令即可。该命令会清除当前会话的上下文，开始一个全新的对话。在私聊和群聊中都有效。