DeepSeek Harness（DSH）是一个插件化框架，允许通过插件扩展界面与功能。开发者在工作中常需听音乐保持专注，dsh-netease-music 插件直接在 DSH 网页版中集成了网易云音乐播放功能。它提供常驻顶部的迷你播放器与可展开的完整面板，内置自动启动的 NeteaseCloudMusicApi 本地服务，并支持通过 AI 对话控制播放。
核心功能¶
- 顶部条迷你播放器：常驻显示封面、歌名、歌手及播放控制按钮。
- 展开播放面板：包含每日推荐、我的歌单、私人 FM、搜索、播放队列、播放历史及设置。
- 播放控制：支持顺序/列表循环/单曲循环/随机播放，可拖动进度条、调节音量。
- 断点续播：自动记录上次播放的歌曲、歌单及进度，重启后恢复。
- 扫码登录：通过手机 App 扫码登录，状态持久化。
- AI 控制工具：注册
netease_music工具，可在对话中直接控制播放器。
安装与启用¶
环境要求¶
- DeepSeek Harness（
dsh web） - Node.js、pnpm
安装步骤¶
# 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"
完成上述步骤后，重启 dsh web（Host 端需要重启进程加载），刷新页面即可在顶部条看到播放器。
典型用法¶
- 展开面板：点击顶部条迷你播放器左侧的封面或箭头，或使用快捷键
Ctrl+Shift+M。 - 搜索播放：在面板的「搜索」页输入关键词，选择歌曲或歌单播放。
- AI 对话控制：在对话中输入自然语言指令，例如「帮我播放周杰伦的晴天」。
- 命令控制：使用工具命令，如
next（下一首）、previous（上一首）、pause（暂停）、volume（调节音量）。
适用场景与注意¶
- 适用场景：DSH Web 环境下的开发者或用户，需要在开发工作流中接入音乐播放。
- 注意事项：
- 首次播放限制：由于浏览器自动播放策略，首次播放需要手动点击一次。
- 本地服务安全：本地 API 服务（默认端口 3000）仅监听本机，不可暴露到公网。
- 数据隔离：登录 Cookie 仅保存在本机 profile 目录，不会随插件分发。
- 版权限制：部分歌曲因版权或 VIP 限制无法播放，非 VIP 音质会自动降级。
该插件通过集成本地 API 和 AI 工具，将音乐播放无缝融入 DSH 工作流。作者为 JasonCHTT，采用 MIT 许可证。
