Repolode
Submit
tencent-connect

tencent-connect/dsh-qqbot

A plugin that connects the DeepSeek Harness (dsh) AI agent to QQ private and group chats through the official QQ Bot API.

View on GitHub
Stars
550
Forks
68
Open issues
36
Last commit
4 days ago

What is it?

dsh-qqbot is a plugin for deepseek-harness (dsh) that lets an AI agent respond to messages in QQ. Each QQ private chat user and each group chat gets its own isolated agent session, and replies are sent back as Markdown, with long messages split into chunks.

Setup can be done from the desktop app by scanning a QR code with mobile QQ, or from the command line with npx. Once bound, credentials are saved to the profile so later launches skip the scan. Access can be restricted per private chat or group with open, allowlist, or disabled modes, and group chats can require an @mention to trigger.

The plugin also covers multimedia and interaction: it can analyze images and videos sent by users, send local files back to users with a path allowlist, ask multiple-choice questions through inline buttons, and request approval for sensitive actions. Built-in slash commands handle new sessions, context compaction, model switching, and presets.

Key features

  • 01Connects DeepSeek agents to QQ private chats and group chats via the QQ Bot API.
  • 02Isolates each private user and group into its own agent session.
  • 03Scan-to-bind QR login with saved credentials for later launches.
  • 04Per-chat access control with open, allowlist, and disabled modes.
  • 05Image and video understanding plus sending local files back to users.
  • 06Inline buttons for questions and approval requests.

Use cases

  • Running a DeepSeek-powered assistant bot in a QQ group for a community.
  • Offering a private AI helper to individual QQ users with an allowlist.
  • Building a QQ bot that answers questions using local project files.
  • Prototyping conversational bots on the QQ platform.

Quick start

  1. 1

    Install the plugin into a dsh profile

    npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
  2. 2

    Start the bot and scan the QR code with mobile QQ to bind credentials

    npx @deepseek-ai/dsh --profile qqbot

Things to know

  • Requires a deepseek-harness (dsh) runtime to run.
  • Binding needs a QQ Bot account and mobile QQ for QR scanning, or AppID and AppSecret set manually.
  • Group chats require an @mention by default.

In collections

AI chatbots & chat clients

Topics

#qq-bot#deepseek#llm#chatbot#agent#typescript#messaging#dsh#dsh-plugin#qqbot

FAQ

What is dsh-qqbot?
A plugin that connects the DeepSeek Harness (dsh) AI agent to QQ private and group chats through the official QQ Bot API. dsh-qqbot is a plugin for deepseek-harness (dsh) that lets an AI agent respond to messages in QQ. Each QQ private chat user and each group chat gets its own isolated agent session, and replies are sent back as Markdown, with long messages split into chunks.
Is dsh-qqbot free to use? What license does it have?
dsh-qqbot is open source under the MIT license. Check the license terms before using it in commercial products.
Is dsh-qqbot still maintained?
Actively maintained. The last commit to dsh-qqbot was on Nov 3, 2026.
What can I use dsh-qqbot for?
Running a DeepSeek-powered assistant bot in a QQ group for a community. Offering a private AI helper to individual QQ users with an allowlist. Building a QQ bot that answers questions using local project files. Prototyping conversational bots on the QQ platform.
How do I install dsh-qqbot?
Install the plugin into a dsh profile: npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot Start the bot and scan the QR code with mobile QQ to bind credentials: npx @deepseek-ai/dsh --profile qqbot
Where can I get dsh-qqbot?
The source code and installation instructions are on GitHub: https://github.com/tencent-connect/dsh-qqbot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects