Introduction

In the development and usage scenarios of DeepSeek Harness (DSH), obtaining music services directly within the Web interface often requires manual redirection or the use of external players, leading to a fragmented experience. The DSH plugin ecosystem provides a solution to this problem by injecting services into the host environment through low-level protocol integration.

What Is This

dsh-tencent-music is a QQ Music player plugin tailored for DeepSeek Harness (DSH). It is maintained by user L-1124. It solves the problem of invoking QQ Music protocols directly within the DSH environment, providing an end-to-end service that covers search, playback, and personalized recommendations, while deeply integrating with DSH’s Agent tool system.

Core Features

  1. Seamless Web UI Integration: Provides a top-bar shortcut to launch the player and a collapsible floating player panel, supporting progress seeking, volume control, and multiple repeat modes.
  2. Agent-Powered Music Requests: Registers a music agent tool, allowing users to control the player with natural language (such as requesting a song, skipping to the next track, adjusting volume, and starting a radio station).
  3. Personalized Radio and Recommendations: Built-in radio modes such as “Guess What You Like,” “Radar Recommendations,” and “New Releases,” with seamless playlist fetching.
  4. Comprehensive Search and Import: Supports in-depth search by single track, artist, album, playlist, or lyrics, and allows one-click import directly via a QQ Music playlist ID or shared link (for example, entering 201 imports “My Favorites”).
  5. Full-Range High-Fidelity Audio Quality: Supports all audio tiers, ranging from 128k MP3 and 320k HQ to SQ lossless (FLAC), Hi-Res, and Premium Master (AI Master).
  6. Quick and Secure Login: Provides embedded QR-code login via QQ or WeChat inside the player, persists multi-endpoint OAuth credentials, and automatically restores the session after restart.

Installation and Activation

It is recommended to perform local installation and mounting using the DSH CLI tool:

dsh plugin --profile web add ./dsh-tencent-music

After installation, restart dsh web and refresh the browser. You can then see the music player icon in the top bar of the page.

Typical Usage

By sending natural-language instructions to the Agent in the chat box, you can easily control the player:
- Play Jay Chou’s “Sunny”
- Start the “Guess What You Like” radio
- Play today’s recommended songs
- Next track / Pause / Resume
- Turn the volume up
- Help me import playlist 201
- Tell me what song is currently playing

Applicable Scenarios and Notes

  • Environment Dependencies: This plugin depends on @deepseek-ai/cordis and the DSH Web UI injection framework. Before use, ensure that your DSH host environment version is compatible.
  • VIP Fallback Strategy: When the player encounters VIP songs without playback permission, the system automatically performs a smooth fallback, fetches and plays the 30-second official preview clip (RS02), and ensures that the playback queue is not interrupted.
  • Permission Review: The plugin runs with the permissions of the current dsh process. Before installation, we recommend reviewing the source code and license.

Summary

By deeply integrating QQ Music protocols with DSH’s Agent ecosystem, this plugin provides developers and users with a solution to manage end-to-end music services without navigating away from the application.
- Plugin Directory: https://www.skillhub.cn/plugins/L-1124/dsh-tencent-music
- GitHub: https://github.com/L-1124/dsh-tencent-music