dsh-music
音乐播放器卡片插件：在 DeepSeek Harness 对话中把 ```dsh-music 围栏渲染为可交互播放器。支持网易云 / QQ 音乐双后端（搜索、播放、歌词）、玻璃拟态悬浮歌词、气泡交互特效与多主题（glass / neon / paper / vapor / 自定义）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:jh-Evil/dsh-music#bf40dafcec7b337afce807c9b6d134f08332f291Music 以 dsh-music 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness（DSH） 的音乐播放器卡片插件：模型在回复里输出一个 dsh-music 围栏，对话流里就地渲染一张可交互的播放器卡片——网易云 / QQ 音乐双后端、玻璃拟态悬浮歌词、节拍气泡特效、多主题。
采用与 dsh-genui 相同的部署形态：Node 宿主半区（教模型围栏语法 + 注册 music skill + 提供搜索/直链/歌词代理路由）+ 浏览器半区（DOM channel 观察 ```dsh-music 围栏并挂载卡片，零 React 依赖）。不装插件的会话永远不发围栏，一切如常。
glass 玻璃拟态（封面氛围光 + 毛玻璃）｜ neon 霓虹发光｜ paper 纸感｜ vapor 蒸汽波，以及自定义主题对象（accent / bg / text / radius / bubbles / coverBlur）bubble 悬浮玻璃歌词气泡（当前句 + 下一句，随播放浮动换行）｜ bar 内嵌三行滚动歌词栏（带翻译）｜ noneprefers-reduced-motiondsh-music 围栏（需要宿主提供 sessions 服务，否则按钮不出现）# 本地开发（链接安装）
dsh plugin --profile web add link:/path/to/dsh-music
# 已发布到 npm 后
dsh plugin --profile web add dsh-music
装完重启 DSH web 界面即可。零运行时依赖，Node ≥ 20。
对模型说：
{"theme":"vapor","keyword":"深夜 lo-fi"}lyricMode:"bar"{"theme":{"accent":"#f9a8d4","bg":"#3b0764"}}围栏示例（模型自动生成，也可手写测试）：
{"theme":"glass","backend":"netease","keyword":"周杰伦 晴天","autoplay":true,"lyricMode":"bubble"}
{"title":"深夜电台","theme":{"accent":"#f0abfc","bg":"#2b1055"},"playlist":[
{"title":"晴天","artist":"周杰伦"},
{"title":"Lemon","artist":"米津玄師"}
]}
完整字段规范见 SKILL.md。
| 变量 | 作用 |
|---|---|
DSH_MUSIC_NETEASE_COOKIE | 网易云 Cookie：提高 VIP 歌曲/高码率直链成功率（默认 appver=2.9.7 匿名） |
DSH_MUSIC_QQ_COOKIE | QQ 音乐 Cookie：填用户自己的 Cookie 后，QQ 侧免费歌曲有机会直接拿到直链 |
所有音乐请求经宿主 Node 侧代理（同源 /plugins/dsh-music/api/*），浏览器无跨域问题；插件不收集任何凭据，Cookie 仅随请求发往对应音乐站点。
node dev/gen-fixture.mjs # 生成测试音频/封面/歌词 fixtures
node dev/server.mjs # http://127.0.0.1:4531/preview.html?spec=glass
?spec=glass|neon|paper|vapor|custom 切主题；搜索词带 demo 前缀走本地 fixtures（确定性预览），否则走真实音乐接口（失败自动兜底 fixtures）。
index.js 宿主半区：systemPrompt 区段 + music skill + /plugins/dsh-music/api 路由
src/backends/*.mjs 网易云 / QQ 音乐公开接口适配（搜索 / 直链 / 歌词）
client.js 浏览器半区：DOM channel 围栏渲染器 + 播放器卡片 + 主题 + 气泡粒子引擎
SKILL.md music skill：围栏字段规范与模型行为准则
cordis.patch.yml bundle 插入声明（dsh plugin add 时并入 profile）
dev/ 预览服务器与 fixtures
关键机制：
language-dsh-music 代码块（或 label+pre 结构兜底）且 JSON 解析完整后，把围栏表面替换为卡片；流式阶段先显示"装载中"骨架，15 秒未完成自动还原代码块；宿主重渲染后自动重挂载，播放不中断（音频为全局单例）。[music-action] 消息。autoplay 可能需要用户点一次播放按钮（卡片会提示）。