dsh-qqbot DSH plugin

This plugin enables you to interact with dsh agents through QQ messaging. It acts as a transport layer, converting QQ messages into agent inputs and outputting Markdown replies. Supports both private and group conversations with session isolation and idle timeout.

remote-execution

How to install the dsh-qqbot DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-qqbot DSH plugin.

dsh-qqbot DSH plugin data source

dsh-qqbot DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-qqbot DSH plugin can do

Receive and respond to QQ messages in both private chat and group chat
Built-in slash commands: /bot-reset, /bot-model, /bot-status, /bot-help
Session management with idle timeout and automatic disposal to prevent memory leaks
Markdown-aware message chunking for long outputs
Support for custom presets and model selection via configuration

Where the dsh-qqbot DSH plugin fits

Use a QQ bot to privately chat with a dsh agent as a personal assistant
Deploy a QQ group bot that responds to mentions and executes agent tasks
Integrate dsh agent workflows into team communication via QQ group messages

Who the dsh-qqbot DSH plugin is for

Users who want to access dsh agents through their QQ messaging interface
Developers building QQ-based AI assistants that leverage dsh agent capabilities

dsh-qqbot DSH plugin limitations

Requires self-provided QQ Bot AppID and AppSecret (or scan QR code during first setup)
Group chat interaction requires @bot mention by default (configurable via requireMention)
Only works with QQ IM platform; no other messaging channels supported

dsh-qqbot DSH plugin: from the repository README

Quoted from the tencent-connect/dsh-qqbot README, the upstream source of the dsh-qqbot DSH plugin. Copyright remains with the original authors.

基于 [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 -

Read the full READMERepository license: MIT

dsh-qqbot DSH plugin questions

How do I get the QQ Bot AppID and AppSecret?

You need to register a QQ bot on the QQ Open Platform (https://q.qq.com). After creating the bot, you will obtain an AppID and AppSecret. Alternatively, you can use the QR code scanning feature provided by this plugin during first startup to bind automatically.

Can I use this plugin without a QQ Bot account?

No, you must have a QQ Bot account (AppID & AppSecret) or use the built-in QR code scanning feature to bind your QQ account. The plugin acts as a bridge between dsh and QQ Bot, so a valid QQ Bot credential is required.

Does the plugin support group chat and private chat?

Yes, it supports both group chat and private chat. In group chat, the bot responds only when mentioned (@bot) by default. You can change this behavior by setting `requireMention: false` in the configuration.

What slash commands are available?

The plugin provides four built-in slash commands: /bot-reset (reset current session), /bot-model (view or switch model), /bot-status (view session status), and /bot-help (list all commands). These can be used in both private and group chats.

How do I reset the session or clear context?

Use the `/bot-reset` command in the chat. This will clear the current conversation context and start a fresh session. The command works in both private and group chats.