前言¶
DSH 以插件扩展 Web 客户端能力。ncm-player 解决的是在 DSH Web 页面中顺手听歌、搜歌、看歌词的需求：不需要另开播放器，也能在页面里保留一个可拖拽、可隐藏的网易云音乐浮窗。
下面介绍它的定位、核心功能、安装方式与使用限制。
这是什么¶
ncm-player 是一个运行在 DeepSeek Harness（DSH）Web 界面里的网易云音乐浮窗播放器。维护者为 WolfGenerals，许可证为 MIT。
它把播放控制、搜索与发现、歌词、播放队列、账号登录和设置放在同一个浮窗中。安装并重启 DSH Web 后，页面右下角会出现音符按钮，点击即可展开播放器。
核心功能¶
播放与队列¶
支持：
- 播放/暂停、上一首/下一首、进度拖拽、音量与静音
- 顺序、单曲循环、随机三种播放模式
- 播放队列添加、移除、清空
- 重启后恢复队列、进度、播放模式、音量
搜索与账号¶
支持：
- 搜索单曲、歌单、专辑
- 热门歌单推荐
- 网易云 App 扫码登录或粘贴 Cookie 登录
- 登录后查看创建、收藏、喜欢的歌单与收藏的专辑
歌词¶
支持：
- 逐行同步歌词高亮
- 点击歌词跳转进度
- 歌词翻译（有翻译时显示）
- 迷你模式显示当前歌词，超长歌词自动横向滚动，字号可调
浮窗与设置¶
支持：
- 展开、迷你条、隐藏三种浮窗形态且可拖拽
- 界面颜色自动跟随 DSH 皮肤主题
- 音质、歌词翻译开关、迷你歌词开关、滚动和字号设置自动持久化
安装与启用¶
在 DSH Web 插件环境中执行：
dsh plugin --profile web add @wolfgenerals/ncm-player
执行后重启 DSH Web。页面右下角出现音符按钮，点击展开播放器。
ncm-player 以当前 dsh 进程权限运行。安装前建议检查源码与许可证；项目许可证为 MIT。插件运行依赖本机 PATH 上的 Node.js 运行时，以及可访问 music.163.com 的网络。
典型用法¶
- 安装插件并重启 DSH Web 后，点击页面右下角音符按钮，展开播放器。
- 在「发现」页搜索单曲、歌单、专辑，或选择热门歌单；点击任意一首歌开始播放。
- 在「播放」页切歌、拖进度、调音量、切换播放模式。
- 在「歌词」页查看逐行歌词与翻译；仅当歌曲有翻译数据时显示翻译。
- 在「设置」页使用网易云 App 扫码登录或粘贴 Cookie，解锁「我的音乐」与收藏。
- 点击窗口右上角
-收起为迷你条，点击×隐藏；再次打开点击右下角音符按钮。
数据保存¶
登录态与播放队列保存在本机浏览器 localStorage，键为 ncmply-settings，不写入磁盘文件。
- 换浏览器或清除站点数据会丢失登录态/队列，需重新登录。
- 浏览器隐私模式下 localStorage 不可用时，功能照常，但仅不持久化。
- 升级自 ≤1.0.7 的用户：旧文件
~/.dsh/ncmply-settings会在启动时被只读读取一次并自动迁入 localStorage，随后不再写入。
使用限制¶
- 部分歌曲受版权/会员限制无法播放。
- 歌词翻译仅当歌曲有翻译数据时显示。
- 收藏受网易云账号风控影响，失败时会有提示，属正常现象。
- 登录 Cookie 只用于请求
music.163.com，不发送给任何第三方。 - 仅供个人学习使用，请遵守网易云音乐服务条款与当地法律法规。
结尾¶
ncm-player 提供的是一个轻量级的 DSH Web 网易云音乐浮窗：播放、搜索、歌词、队列、登录和设置都集中在同一个浮窗里。
GitHub 地址：https://github.com/WolfGenerals/ncm-player.git
