DeepSeek Harness (DSH) is a plugin-based framework that allows the user interface and functionality to be extended through plugins. Developers often need to listen to music to stay focused while working, and the dsh-netease-music plugin integrates Netease Cloud Music playback directly into the DSH web version. It provides a mini player that remains at the top and an expandable full panel, includes a built-in NeteaseCloudMusicApi local service that starts automatically, and supports controlling playback through AI conversations.

Core Features

  • Top-bar mini player: Persistently displays the cover, song title, artist, and playback control buttons.
  • Expandable playback panel: Includes Daily Recommendations, My Playlists, Private FM, Search, Play Queue, Play History, and Settings.
  • Playback control: Supports sequential/list loop/single-song loop/random playback; allows dragging the progress bar and adjusting the volume.
  • Resume playback: Automatically records the last played song, playlist, and progress, and restores them after restarting.
  • QR code login: Log in by scanning a QR code with the mobile app; the login state is persisted.
  • AI control tool: Registers the netease_music tool, allowing direct control of the player in conversations.

Installation and Enabling

Environment Requirements

  • DeepSeek Harness (dsh web)
  • Node.js, pnpm

Installation Steps

# 1. 进入 web profile 目录
cd "$env:USERPROFILE\.dsh\profiles\web"

# 2. link 安装本插件（<路径> 替换为插件目录的绝对路径）
pnpm add 'link:C:/<路径>/dsh-netease-music'

# 3. 安装插件运行时依赖 NeteaseCloudMusicApi
pnpm add NeteaseCloudMusicApi

# 4. 编辑 package.json，在 dsh.profile.bundles 末尾追加 "dsh-netease-music"

After completing the above steps, restart dsh web (the Host side needs to restart the process to load it). Refresh the page to see the player in the top bar.

Typical Usage

  • Expand the panel: Click the cover or arrow on the left side of the top-bar mini player, or use the shortcut Ctrl+Shift+M.
  • Search and play: Enter a keyword in the panel’s “Search” page, then select a song or playlist to play.
  • AI conversation control: Enter natural language commands in the conversation, for example, “Help me play Jay Chou’s Sunny Day.”
  • Command control: Use tool commands, such as next (next song), previous (previous song), pause, and volume (adjust volume).

Applicable Scenarios and Notes

  • Applicable scenarios: Developers or users in a DSH Web environment who need to integrate music playback into their development workflow.
  • Notes:
    1. First-play restriction: Due to browser autoplay policies, the first play action requires a manual click.
    2. Local service security: The local API service (default port 3000) listens only on the local machine and must not be exposed to the public internet.
    3. Data isolation: The login cookie is stored only in the local profile directory and is not distributed with the plugin.
    4. Copyright restrictions: Some songs cannot be played due to copyright or VIP limitations, and audio quality is automatically downgraded for non-VIP users.

This plugin integrates the local API and AI tools to seamlessly incorporate music playback into the DSH workflow. The author is JasonCHTT, and it is released under the MIT License.