DSH Plugin HubDSH 插件市场
WolfGenerals/ncm-player 预览 preview

WolfGenerals/ncm-player

Plugin插件 Native原生 ⭐ 3 MIT UI & Themes界面与主题

ncm-player是一个运行在DeepSeek Harness (DSH) Web界面里的网易云音乐浮窗播放器。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native DeepSeek Harness plugin that adds a draggable floating NetEase Cloud Music player directly to the DSH web interface. It supports core music features including play/pause, next/previous track, progress seeking, volume control, and three playback modes: order, repeat one, and shuffle. It also lets users search and browse songs, playlists, and albums, view synchronized lyrics with translation, manage play queues, and log into NetEase Cloud via QR code or cookie. The player's UI color automatically adapts to your active DSH theme.

To install the plugin, you can run the recommended npm command dsh plugin --profile web add @wolfgenerals/ncm-player, which adds the plugin to your DSH web profile bundle, and it will activate after you restart DSH Web. Alternatively, you can install it directly from the GitHub repository using the command dsh plugin --profile web add github:WolfGenerals/ncm-player, which also activates after a full DSH Web restart. For local development, you can clone the repository directly to your local machine to test your custom changes before deployment.

All user settings, login state, and play queue data are saved locally to the user's browser localStorage, so clearing site browser data or switching to a different browser will result in permanent loss of saved data. The plugin requires a working local Node.js environment available in your system PATH and an active network connection that can access music.163.com to function properly. Login cookies are only used to access NetEase Cloud APIs and are never sent to third parties. It is released under the open MIT license, intended for personal learning only, so all users must comply with NetEase Cloud's terms of service and local applicable laws.

这是一款专为DeepSeek Harness（DSH）Web界面开发的原生插件，提供可拖拽、可折叠、可隐藏的网易云音乐浮窗播放器。它支持单曲、歌单、专辑的搜索与浏览，逐行同步歌词及翻译，播放队列管理，支持扫码或Cookie登录网易云账号，界面颜色可自动跟随DSH皮肤主题变化。

推荐通过npm命令安装，执行dsh plugin --profile web add @wolfgenerals/ncm-player后重启DSH Web即可生效。也可通过GitHub拉取源码安装，本地开发也支持直接克隆仓库使用。安装完成后，点击页面右下角的音符按钮即可展开播放器，搜索或选择热门歌单后点击歌曲就能开始播放。

登录状态和播放设置保存在浏览器本地localStorage中，更换浏览器或清除站点数据会导致数据丢失。插件依赖本地Node.js环境和可访问网易云音乐的网络，仅供个人学习使用，需遵守网易云音乐服务条款和当地法律法规，采用MIT开源许可。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：ncm-player（WolfGenerals/ncm-player）
仓库：https://github.com/WolfGenerals/ncm-player
本站详情页：https://www.yhbd.top/plugins/wolfgenerals-ncm-player/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-08-28 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3，几乎没人在用，遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装 

dsh plugin --profile web add @wolfgenerals/ncm-player

把 WolfGenerals/ncm-player 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.5 KB · 缓存于 2026-08-28 05:31:58 · 4.5 KB

ncm-player — 网易云音乐浮窗

一个运行在 DeepSeek Harness (DSH) Web 界面里的网易云音乐浮窗播放器：可拖拽、可折叠、可隐藏，支持单曲/歌单/专辑浏览与搜索、逐行同步歌词与翻译、播放队列、扫码/Cookie 登录，界面颜色自动跟随 DSH 皮肤主题。

预览

播放 歌词
播放 歌词
发现 · 热门 发现 · 我的
发现-热门 发现-我的
专辑浏览 播放队列 迷你模式
专辑内容浏览 队列 mini窗口

功能特性

  • 🎵 播放：播放/暂停、上一首/下一首、进度拖拽、音量与静音；支持顺序、单曲循环、随机三种模式（图标 + 文字标识，单曲循环带 "1" 角标）
  • 📃 发现：搜索单曲 / 歌单 / 专辑（三种分类），热门歌单推荐；登录后进入「我的」，查看创建、收藏、喜欢的歌单与收藏的专辑
  • 📝 歌词：逐行同步高亮、点击歌词跳转进度、歌词翻译（有翻译时显示）；迷你模式同样显示当前歌词，超长歌词自动横向滚动，字号可调
  • 🔄 队列：添加、移除、清空管理；自动持久化——重启后恢复队列、进度、播放模式、音量
  • 👤 账号：网易云 App 扫码登录，或粘贴 Cookie；登录后可查看「我的音乐」并使用收藏功能
  • 🪟 浮窗：展开 / 迷你条 / 隐藏三种形态，均可拖拽；隐藏后为右下角音符按钮，页面打开时默认隐藏于此；颜色跟随 DSH 皮肤主题
  • ⚙️ 设置：音质（标准 128k / 高品质 320k）、歌词翻译开关、迷你歌词开关 / 滚动 / 字号；所有设置自动持久化

安装

方式一：从 npm 安装（推荐）

dsh plugin --profile web add @wolfgenerals/ncm-player

该命令会在 web profile 中安装依赖，并把 @wolfgenerals/ncm-player 加入 dsh.profile.bundles 列表（见 $DSH_HOME/profiles/web/package.json）。重启 DSH Web 后生效。

方式二：从 GitHub 安装

dsh plugin --profile web add github:WolfGenerals/ncm-player

同样会把 @wolfgenerals/ncm-player 加入 dsh.profile.bundles 列表，重启 DSH Web 后生效。

本地开发

git clone https://github.com/WolfGenerals/ncm-player.git

快速上手

  1. 安装插件并重启 DSH Web 后，页面右下角出现音符按钮，点击展开播放器
  2. 「发现」页搜索或选择热门歌单，点任意一首歌开始播放
  3. 「播放」页可切歌、拖进度、调音量、切换播放模式；「歌词」页查看逐行歌词与翻译
  4. 在「设置」页扫码登录（网易云 App 扫一扫）或粘贴 Cookie，解锁「我的音乐」与收藏
  5. 点击窗口右上角 - 收起为迷你条，× 隐藏；再次打开点击右下角音符按钮

数据保存（浏览器 localStorage）

登录态与播放队列保存在本机浏览器 localStorage（key：ncmply-settings），不写入磁盘文件：

{
  "account": { "cookie": "...", "uid": 123, "nickname": "..." },
  "state": {
    "queue": [ { "id": 1, "name": "...", "artists": "...", "album": "...", "cover": "...", "duration": 0 } ],
    "index": -1, "mode": "order", "vol": 0.8, "quality": 320000, "time": 0,
    "showTrans": true, "showMiniLrc": true, "miniLrcScroll": true, "miniLrcSize": 11
  }
}
  • 换浏览器或清除站点数据会丢失登录态 / 队列（需重新登录）
  • 升级自 ≤1.0.7 的用户：旧文件 ~/.dsh/ncmply-settings 会在启动时被只读读取一次并自动迁入 localStorage，随后不再写入（文件保留但不更新）
  • 浏览器隐私模式下 localStorage 不可用时，功能照常、仅不持久化

注意事项

  • 依赖本机 PATH 上的 Node.js 运行时，以及可访问 music.163.com 的网络
  • 登录 Cookie 只用于请求 music.163.com，不发送给任何第三方
  • 收藏（点 ❤）受网易云账号风控影响，失败时会有提示，属正常现象
  • 部分歌曲受版权 / 会员限制无法播放；歌词翻译仅当歌曲有翻译数据时显示
  • 仅供个人学习使用，请遵守网易云音乐服务条款与当地法律法规

License

MIT

致谢

实现借鉴了 sanwuhundun/dsh-netease-music 的网易云音乐 API 对接与登录方案。

渲染基于仓库 WolfGenerals/ncm-player 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev dsh-chat-nav 下一个 Next catalog-capabilities-zh →