dsh-music-dock 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-music-dock 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-music-dock 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-music-dock 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/10/21。

侧栏音乐播放条 CNCharon/dsh-music-dock

DeepSeek Harness

CNCharon0 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

在侧栏同步网易云与 QQ 音乐歌单并滚动显示歌词

31.5/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/22 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add CNCharon/dsh-music-dock

该包不可直接 npm 安装，改从 GitHub 源安装（原因见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · platform

装得上吗

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 0 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 14 处，展示前 14 条）

发起网络请求
client.js:254
const response = await fetch(`${API}/${action}${suffix}`, { headers: { accept: 'application/json' } })
发起网络请求
client.js:261
const response = await fetch(`${API}/${action}`, {
写入剪贴板
client.js:1917
navigator.clipboard.writeText(text).then(done, done)
发起网络请求
lib/routes.js:242
const upstream = await fetch(url, { headers, redirect: 'follow' })
读取本地文件
lib/store.js:32
const raw = readFileSync(storePath(), 'utf8')
写入本地文件
lib/store.js:45
mkdirSync(dir, { recursive: true })
写入本地文件
lib/store.js:47
writeFileSync(file, `${JSON.stringify(accounts, null, 2)}\n`, 'utf8')
写入本地文件
lib/store.js:49
chmodSync(file, 0o600)
读取本地文件
lib/update.js:26
const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
请求外部主机api.github.com
lib/update.js:53
const response = await fetch(`https://api.github.com${path}`, {
发起网络请求
lib/update.js:53
const response = await fetch(`https://api.github.com${path}`, {
发起网络请求
lib/http.js:26
response = await fetch(url, { ...init, signal: controller.signal, redirect: init.redirect || 'follow' })
发起网络请求
lib/http.js:91
response = await fetch(url, { ...init, signal: controller.signal, redirect: init.redirect || 'follow' })
读取本地文件
lib/vendor-loader.js:9
const source = readFileSync(fileURLToPath(new URL('./vendor/qrcode.js', import.meta.url)), 'utf8')

扫描于 2026/10/22（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

涉及外部主机：api.github.com

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告WorkBuddy 天津胜凌

WorkBuddy 官方授权合作伙伴 · 天津胜凌

官方授权渠道商 · 代理合作 / 直接购买均可洽谈 · 致电 185 2226 8817

致电联络→

README

由 DeepSeek 最新模型翻译生成

音乐播放条 · DSH Music Dock 一个音乐播放条（Dock），嵌在左侧菜单栏底部：接入网易云音乐 / QQ 音乐，登录后同步你收藏与创建的全部歌单，支持上一首、暂停、下一首、播放模式（顺序 / 随机 / 单曲循环），并显示歌手、歌名与滚动歌词。安装尚未发布 NPM 包，用源码方式安装： dsh plugin --profile web add github:CNCharon/dsh-music-dock 装好后重载插件（或在设置里关闭再开启「音乐播放条」），左侧栏底部就会出现播放条。要求 DSH 0.2.x，带 webServer 服务的 Web profile；Windows、macOS、Linux 均可。更新插件会在设置页检查新版本；发现更新时，按提示执行： dsh plugin --profile web add github:CNCharon/dsh-music-dock 然后重启 DSH。账号与登录状态保存在本机 profile 目录，更新不会丢失。也可以随时关注 Releases 获取版本说明。功能 - 嵌在侧栏里：播放器嵌在左侧栏底部、其他插件按钮的上方，宽度与侧栏内容对齐——侧栏变窄成 56px 导轨时，播放器退化为底栏里的一个按钮。

展开完整文档（README 剩余 1 节）

音乐播放条 · DSH Music Dock

一个音乐播放条（Dock），嵌在 左侧菜单栏底部：接入 网易云音乐 / QQ 音乐，登录后同步你收藏与创建的全部歌单，支持上一首、暂停、下一首、播放模式（顺序 / 随机 / 单曲循环），并显示歌手、歌名与滚动歌词。

安装

尚未发布 NPM 包，用源码方式安装：

dsh plugin --profile web add github:CNCharon/dsh-music-dock

装好后重载插件（或在设置里关闭再开启「音乐播放条」），左侧栏底部就会出现播放条。要求 DSH 0.2.x，带 webServer 服务的 Web profile；Windows、macOS、Linux 均可。

更新

插件会在设置页检查新版本；发现更新时，按提示执行：

dsh plugin --profile web add github:CNCharon/dsh-music-dock

然后重启 DSH。账号与登录状态保存在本机 profile 目录，更新不会丢失。也可以随时关注 Releases 获取版本说明。

功能

- 嵌在侧栏里：播放器嵌在左侧栏底部、其他插件按钮的上方，宽度与侧栏内容对齐——侧栏变窄成 56px 导轨时，播放器退化为底栏里的一个按钮。
- 缩小化：平时显示封面、歌名和当前歌词（底部一条播放进度）；鼠标移入后歌词淡出、换成 上一首、播放暂停、下一首、播放模式 与展开按钮，移出又淡回歌词。点封面/歌词或展开按钮可展开完整面板（封面、歌名、歌手、进度、歌词、歌单），再点向下箭头或点击面板外任意处即可收起。
- 曲目类型标识：播放条歌名前的圆点在会员 / 付费曲目上是红色，在普通曲目上是蓝色（未选曲目时灰色）。
- 歌词优先：完整面板里，鼠标移出显示歌词行，移入切换为控制按钮（进度条、音量、播放模式）。
- 两个平台
- 网易云音乐：扫码登录或粘贴 Cookie，同步「创建的歌单」「收藏的歌单」，逐首播放与歌词。
- QQ 音乐：扫码登录或粘贴 Cookie，同步创建歌单、收藏歌单与「我喜欢的音乐」；会员曲目按 qm_keyst 鉴权，播放地址走 vkey 接口。
- 登录即同步：登录成功立即拉取歌单；账号保存在本机，重启后自动恢复并后台刷新。
- 歌词偏移：−0.5s / +0.5s 按曲目记忆，解决歌词整体超前或滞后。
- 设置页：设置 → 音乐播放条，集中管理两个平台的登录与歌单浏览。

登录方式

插件通过 Host 侧的同源反向代理访问各平台接口（浏览器直连会被 CORS 拦截，Cookie 也不应暴露给页面脚本）。

网易云音乐

1. 在浏览器打开 music.163.com 并登录；
2. 开发者工具 → Network → 任意请求 → 复制请求头里的 Cookie（必须含 MUSIC_U）；
3. 粘贴到插件「Cookie 登录」。

也可以点「扫码登录」，用网易云 App 扫描弹窗里的二维码。

QQ 音乐

点「扫码登录」，用 QQ 或微信扫描弹窗里的二维码，手机上确认即可——插件走 QQ 官方的 ptlogin2 票据流程，扫码成功后自动换回 uin / p_skey 等登录凭据，不需要复制 Cookie。

若扫码后 QQ 音乐没有下发凭据（极少数账号会遇到），弹窗会提示改用 Cookie 登录：

1. 在 y.qq.com 登录；
2. 复制完整 Cookie（必须含 uin，以及 p_skey / qm_keyst 之一）；
3. 粘贴到「Cookie 登录」。

播放能力说明

能否播放取决于平台返回的地址，插件不会伪造：

- 免费曲目通常可直接播放；
- 会员 / 版权受限曲目会显示「需要会员」等具体原因，顺序播放时自动跳过；
- 网易云对未授权曲目返回 -110，QQ 返回 result 104003——都会在播放器里给出可读提示。

技术结构

dsh-music-dock/
├─ index.js Host 半：注册 /music/player 前缀路由 ├─ lib/ │ ├─ routes.js 同源 HTTP 接口 + 音频流转发（支持 Range） │ ├─ service.js 平台适配器注册、账号态、同步 │ ├─ http.js 带超时的 fetch 封装 │ ├─ store.js 账号持久化（仅 Cookie 与账号名） │ ├─ qr.js 网易云扫码；二维码用随包 MIT 编码器绘制 │ ├─ vendor/ qrcode-generator（MIT，见文件头） │ └─ providers/ netease.js / qq.js ├─ client.js Client 半：侧栏底部播放器 + 设置页（单文件模块） ├─ locale/zh.json 插件显示名与描述 ├─ icon.svg 插件图标 └─ test/ 路由 / 适配器 / 静态检查

Host 接口（同源）

| 方法 | 路径 | 用途 |
| GET | /music/player/state | 两个平台的登录态与歌单 |
| GET | /music/player/hydrate | 恢复账号后重建歌单 |
| GET | /music/player/adapters | 平台清单 |
| GET | /music/player/login/qr/create?provider= | 生成二维码 |
| GET | /music/player/login/qr/check?provider=&key= | 轮询扫码状态 |
| POST | /music/player/sign-in | Cookie 登录 |
| POST | /music/player/sign-out | 退出 |
| POST | /music/player/sync | 重新拉取歌单 |
| POST | /music/player/tracks | 歌单曲目 |
| POST | /music/player/lyric | 歌词 |
| POST | /music/player/audio | 解析播放地址 |
| GET | /music/player/stream | 同源转发音频（含 Range） |

自检

node test/routes-smoke.mjs # HTTP 契约、错误信封、音频字节
node test/host-smoke.mjs # 适配器直连各平台
node test/client-lint.mjs # Client 静态检查（槽位、i18n、组件解析）

数据与隐私

- 账号 Cookie 只保存在 Host 进程与 <profile>/.dsh-music-player/accounts.json（仅 Cookie + 账号名，权限 0600；目录名沿用旧名，避免升级后丢失已有登录）；
- 页面脚本无法读取 Cookie，所有平台请求都由 Host 转发；
- 路由只接受同源请求。

已知限制

- 会员曲目需要对应平台的有效会员 Cookie 才能播放；
- QQ 空间「背景音乐」是 dir 目录而不是普通歌单，网页 Cookie 登录读不到它的曲目，点开时会给出说明；
- 极少数 QQ 账号扫码后拿不到 qm_keyst，此时回退到 Cookie 登录（弹窗会提示）；
- 插件通过各平台非官方接口取数，平台改版可能导致登录或取链失效。

许可

MIT。随包附带的二维码编码器 lib/vendor/qrcode.js 为 Kazuhiko Arase 的 MIT 实现（见文件头）。