dsh-qqbot: The Official DSH plugin for Conversing with DeepSeek Harness via QQ Bot
tencent-connect/dsh-qqbot
Official plugin bridging QQ Bot to DeepSeek Harness, enabling QQ messages to drive dsh agent conversations.
Connect DeepSeek Harness to the QQ messaging platform, letting users chat with the dsh agent directly in QQ without a terminal or web UI.
dsh plugin --profile web add github:tencent-connect/dsh-qqbot- Category
- Integrations & Connections
- Platform
- DSH-Plugin
- Author
- tencent-connect
- Distribution
- Plugin
dsh-qqbot Key Features
dsh-qqbot Repository
dsh-qqbot Repo Summary
dsh-qqbot is an official QQ Bot plugin (DSH plugin) for DeepSeek Harness (DSH), maintained by tencent-connect under the MIT license, developed in TypeScript. It turns the QQ messaging platform into a frontend protocol driver for the dsh agent, allowing users to chat with DeepSeek Harness directly within QQ without opening a terminal or web UI. This plugin solves the problem of QQ users not being able to conveniently use dsh, with core capabilities including QR code login, session isolation, model switching, and Markdown replies.
What core features does the dsh-qqbot DSH plugin support?
dsh-qqbot supports bidirectional communication with the dsh agent via QQ WebSocket, giving each private chat user or group chat an independent Agent session. It supports slash commands like /new, /compact, /model, and /stop, sends replies in Markdown format, and automatically splits long text. Idle sessions are automatically evicted to prevent memory leaks.
How to install dsh-qqbot?
The installation command is as follows. On first launch, a QR code guide is triggered; after scanning with the mobile QQ app, credentials are saved automatically.
dsh plugin --profile web add github:tencent-connect/dsh-qqbot
You can also install via a local path or use --patch development mode, as detailed in the README.
What configuration options does dsh-qqbot have?
Key configuration options include appId and appSecret (required, can be set via environment variables QQBOT_APPID and QQBOT_SECRET), provider (default deepseek-official), model (default deepseek-chat), requireMention (whether group chats need @bot), textChunkLimit (max characters per message, default 4500), and sessionIdleTimeout (session idle timeout, default 30 minutes).
How does dsh-qqbot's session routing mechanism work?
The session key is qqbot:${appId}:${scope}:${peerId}, and a SessionId is deterministically derived via SHA-256, allowing recovery after restart. The resolution strategy is in-process reuse, then persistent recovery, then fresh creation.
What are the design principles of dsh-qqbot?
It follows dsh's "Plugins, not loop changes" principle, acting as a pure Cordis plugin with declarative dependencies via inject = ['agents'], without directly coupling to other plugins. It supports mounting presets through the agent-presets service for flexible configuration of tool sets and prompts.
Which DeepSeek Harness versions and platforms are compatible with dsh-qqbot?
This plugin is developed based on deepseek-harness. It is recommended to upgrade to version 0.4.0 or above to support opening the QR code link in a browser. It works on both QQ desktop and mobile platforms via WebSocket connection.