JasonCHTT/dsh-netease-music ↗★ 0
dsh-netease-music
DSH 网页版网易云音乐播放器插件:常驻迷你播放器与展开面板,支持扫码登录、私人FM、歌词显示及 AI 对话控制播放。
AI 分析
核心用途是在 DSH 界面内集成网易云音乐播放与控制。适合习惯边工作边听歌、并希望通过 AI 语音或对话直接控制音乐播放的用户。需安装 NeteaseCloudMusicApi 依赖。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:JasonCHTT/dsh-netease-music说明文档
阅读完整 README ↗使用说明
登录
- 面板「推荐 / 歌单 / 私人FM」页或「设置 → 账号」中点击 「扫码登录」
- 手机网易云音乐 App 扫码并确认登录
- 登录状态显示在设置页;「退出登录」可注销
播放一首歌
- 点击顶部条播放器左侧封面 / 箭头展开面板(也可用快捷键
Ctrl+Shift+M) - 切换到 「搜索」 页,输入歌名 / 歌手 / 专辑 / 歌单,回车
- 搜索结果分「歌单」和「歌曲」两个区块展示:
- 点歌单 → 进入歌单详情,可「播放全部」或点单曲播放
- 点歌曲(或行尾 ▶ 按钮)→ 直接播放
每日推荐
登录后打开面板 「推荐」 页 → 「播放全部」或点击单曲。
我的歌单
面板 「歌单」 页 → 显示账号下全部歌单(创建 + 收藏)→ 点击进入详情播放。
私人 FM
面板 「私人FM」 页 → 「开始播放」获取专属推荐流 → 「换一批」刷新推荐。
播放控制
| 操作 | 位置 |
|---|---|
| 上一首 / 播放暂停 / 下一首 | 顶部迷你播放器、面板底部播放条 |
| 播放模式(顺序 / 列表循环 / 单曲循环 / 随机) | 迷你播放器与面板的模式按钮,点击循环切换 |
| 进度拖动 | 面板底部进度条 |
| 音量调节 | 面板底部音量滑块(可在设置中隐藏) |
| 歌词 | 面板底部滚动歌词框 + 顶部条单行滚动歌词(随行上下滚动、居中、宽度自适应顶栏剩余空间) |
| 播放队列 | 面板「队列」页:点击跳转、清空 |
| 播放历史 | 面板「历史」页:本机保留最近 50 首 |
断点续播
插件会自动记住你关闭页面前的状态,重新打开 dsh web 后继续收听:
- 记住的内容:正在播放的歌曲、歌单(播放队列,最多 300 首)、播放位置(播放中每 5 秒自动保存一次)、播放模式
- 恢复方式:打开页面后自动恢复歌曲与队列,并从上次位置继续播放;若浏览器自动播放策略拦截(新页面首次播放需要一次点击),歌曲会停在原位置并提示,点一下播放按钮即可继续
- 存储位置:仅保存在本机浏览器 localStorage;清空播放队列后记忆随之清除
设置项
打开面板「设置」页(或 DSH 设置 → 网易云音乐):
| 分组 | 项目 | 说明 |
|---|---|---|
| 显示模块 | 每日推荐页 / 歌单页 / 私人FM页 / 歌词显示 / 播放历史页 / 音量调节 | 勾选即时生效,控制面板页签与控件显隐 |
| 播放 | 音质 | 标准 / 高音质 / 极高音质(非 VIP 自动降级为标准) |
| 播放 | 播放模式 | 顺序 / 列表循环 / 单曲循环 / 随机 |
| 账号 | 状态 / 扫码登录 / 退出登录 | — |
| 本地服务 | NeteaseCloudMusicApi 状态、重启按钮 | 默认端口 3000 |
用 AI 控制播放
插件注册了模型工具 netease_music,在对话中直接说即可,例如:
- 「帮我播放周杰伦的晴天」
- 「播放每日推荐」「播放我的歌单」「下一首」「暂停」
- 「把音量调到 50%」「切换为随机播放」
工具动作一览:
| action | 说明 |
|---|---|
search | 按关键词搜索歌曲,返回结果列表(含歌曲 id) |
play | 按 songId 播放一首歌 |
pause / toggle | 暂停 / 播放暂停切换 |
next / previous | 下一首 / 上一首 |
setMode | 设置播放模式:sequence / loop / single / shuffle |
volume | 设置音量 0~1 |
state | 查询当前播放状态(歌曲 / 模式 / 音量 / 队列) |
daily | 播放每日推荐 |
playlists | 列出账号歌单(含歌单 id) |
playPlaylist | 按 playlistId 播放歌单 |