DeepSeek Harness (DSH) adopts an “everything is a plugin” architecture. The official @tencent-connect/dsh-qqbot plugin currently provides only CLI functionality and lacks a visual Web interface. Manually modifying parameters in configuration files (such as appId, appSecret, or access control lists) is error-prone.

dsh-qqbot-panel is a companion plugin that adds a dedicated “Settings -> QQ Bot” page to the DSH Web interface. Through this page, all configurations can be managed directly in the browser, and it also supports automatically binding a QQ bot account by scanning a QR code.

Core Features

This plugin communicates with the official QQ Bot plugin through the /api/dsh-qqbot-panel route and directly reads and writes its configuration file. Main capabilities include:

  1. Web GUI Configuration Management
    Under the “Settings -> QQ Bot” page in the DSH Web interface, manage appId and appSecret, the access modes for private chats (c2c) and groups (open/allowlist/disabled), the requireMention toggle, and the agent working directory (cwd).

  2. QR Code Binding
    Click to generate a QR code, scan it with the QQ client, and appId and appSecret are populated automatically. This process is based on the QQ Bot connection task and requires no browser QR scanning page or Apple ID login.

  3. Workspace Selector
    List all workspaces with existing sessions and their session counts. Selecting a target workspace directs the QQ Bot’s agent sessions to that directory.

Installation and Activation

Before using this plugin, install the official QQ Bot plugin first.

  1. Install the official QQ Bot plugin (associated with the qqbot profile):
    dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
  1. Install the Web settings panel (associated with the web profile):
    dsh plugin --profile web add github:zhengjy01/dsh-qqbot-panel
  1. Restart dsh web, open the settings page in the browser, and navigate to “Settings -> QQ Bot” to see the configuration panel.

Typical Usage

After installation, developers no longer need to edit the ~/.dsh/profiles/qqbot/cordis.patch.yml file. All configuration changes are submitted through the Web panel, and the official plugin automatically hot-reloads its configuration.

Launch the QQ Bot directly from the command line:

dsh --profile qqbot

Use Cases and Notes

  • Dependencies: This plugin is a companion component of the official QQ Bot plugin. The official plugin must be installed and running before it takes effect.
  • Security: appSecret is always displayed in masked form in the interface and is never overwritten by an empty value, preventing service unavailability caused by accidental misconfiguration.
  • Route Restrictions: The /api/dsh-qqbot-panel route is limited to same-origin browser access (loopback-only), with no cross-origin risk.
  • Permissions and Storage: Configuration values bound via QR code scanning are stored with 0600 permissions in the QQ Bot configuration file.
  • UI Design: The plugin uses a minimalist design, relying only on inline styles and no external UI dependencies.

Summary

For developers who need to centrally manage QQ Bot parameters in the Web interface, dsh-qqbot-panel provides the necessary visualization layer. It solves the cumbersome CLI-only configuration of the official plugin while maintaining consistency with the underlying configuration file.