Introduction

DeepSeek Harness (DSH) adopts a plugin architecture to modularize agent control capabilities. After running an Agent on a local computer, remotely controlling it from a mobile device is a common requirement. Traditional solutions often require configuring a reverse proxy or exposing a public IP, increasing deployment complexity. dsh-qq-plugin connects to the official Tencent QQ bot platform and provides a solution that requires no extra network configuration and allows direct control of the local DSH Agent through QQ messages.

Plugin Introduction

This is a DSH plugin named dsh-qq-plugin. It allows users to use mobile QQ to scan a QR code and bind to the official Tencent bot platform, enabling bidirectional interaction with the DSH Agent running on the desktop. The plugin is maintained by user xcisxc29 and is licensed under the MIT License.

Core Features

The plugin provides the following core capabilities:

  • Bidirectional Text and Multimedia: QQ messages are directly used as DSH prompts, and Agent replies are returned to QQ; supports bidirectional transfer of images, videos, voice, and files.
  • Long Reply Handling: Overly long replies are automatically converted into .md files and sent, avoiding message truncation.
  • Multi-Session Management: Supports managing multiple DSH sessions through commands such as /new, /list, and /switch.
  • Model and Reasoning Level Switching: Switch models and reasoning levels via the /model command.
  • Permission and Question Interaction: Agent permission requests and multiple-choice questions can be answered through QQ numeric options.
  • Proactive Push: The Agent can proactively send notifications to QQ.
  • Scheduled Tasks: Supports setting scheduled tasks through QQ (e.g., “Wake me up at 23:12”).

Installation and Enablement

Before installation, ensure that the DSH desktop version is 0.2.0-rc.2 or newer. The plugin requires DSH’s workspace, tool, and UI services to run.

  1. In the DSH sidebar, navigate to the plugin entry and select “Add Plugin”.
  2. Enter the package name dsh-qq-plugin (make sure not to omit the -plugin suffix).
  3. Or run the command in the terminal:
    dsh plugin --profile desktop add dsh-qq-plugin
  1. After installation, click “Enable Now” and restart DSH.

Typical Usage

After enabling it, open Settings -> QQ, click “Start Scanning”, and use mobile QQ to scan the QR code to confirm binding. Binding completes registration, and there is no need to apply for an additional AppID.

  • File Transfer: Say in QQ, “Send me that DSH self-portrait on my desktop,” and the file will be delivered directly.
  • Session Switching: Say “Switch to another” in QQ or use /switch.
  • Model Switching: Send /model 2 in QQ.
  • Scheduled Task: Say “Wake me up at 23:12” in QQ.

Use Cases and Notes

This plugin is suitable for scenarios where you need to temporarily control a DSH Agent running on a computer using a phone. Note: unverified bots can only be used by the administrator; proactive push works under the assumption that there is no quota limit, and if a message is blocked, it will be queued and retried.

Conclusion

The plugin provides DSH users with a lightweight QQ-based channel to control desktop Agents from mobile devices. For more details, refer to GitHub.