lx-music-for-dsh
LX Music 增强控制插件：内置音源引擎（SDK 搜索 + 音源脚本隔离子进程）、侧边栏迷你播放卡（含播放模式切换）、细粒度 LLM 音乐工具集（music_search/play/playlist/prev/next/control）、设置窗口音源管理。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add lx-music-for-dsh@1.0.1Lx Music For Dsh 以 lx-music-for-dsh 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →LX Music 增强控制插件 —— 为 deepseek_harness Web 模式提供 LX Music 播放控制界面与 LLM 点歌能力。
music_search（搜索）/ music_play（播放）/ music_playlist
（播放列表管理）/ music_prev / music_next / music_control（暂停、音量、音质、播放模式等），
另保留兼容入口 search_and_play（一步点歌）；内置滑动窗口防刷（默认 6 次/分钟）与带 action 的操作日志。状态持久化（播放列表/音量/音质/播放模式/点歌日志/音源脚本）走 DSH storage domain （
$DSH_HOME/storages/lx_music.json）；storage domain 不可用时降级为内存 + 音源文件兜底， 并在启动日志与 stderr 明确告警。
Buffer.constructor('return process')）、死循环——
都被限制在子进程内，下一次调用自动重启，宿主进程不受影响。PlaybackService（Typert Remote lxPlayback，播放权威状态 + 播放模式 + storage 持久化）、
细粒度音乐工具集（music_search/music_play/music_playlist/music_prev/music_next/music_control
及兼容 search_and_play）、内置 SDK 搜索、音源脚本子进程沙箱（导入/启用/排序/删除本地管理）、
可选 lxserver 客户端（超时 10s / 重试 2 次 / 音质与平台降级链）。sidebar.footer.action slot）+ HTML5 Audio 播放引擎，
轮询 host 状态（500ms）diff 应用，进度节流上报（1s）。providerMode）：auto（默认，有地址用 lxserver 否则内置引擎）/ engine（强制内置引擎）/
lxserver（连接 lxserver 同步服务器）/ mock（内置演示数据，用于无网络演示）。npm install && node scripts/link-dsh.mjs # 镜像全局 DSH 运行时（版本不一致会自动刷新）
npm run lint && npm run typecheck && npm run build && npm test
# 可选：真实网络冒烟（五平台搜索）
node scripts/compile-tests.mjs && node scripts/smoke-live.mjs
安装到 DSH（要求 @deepseek-ai/dsh ≥ 0.1.5-rc.1）：
node scripts/install-to-dsh.mjs # 打包 + dsh plugin add + 旧版残留迁移校验
# 然后重启 dsh web 并刷新浏览器
插件包用 dsh.bundle.patch 声明为 profile 组合层，dsh plugin add 会自动激活，
无需手工编辑 profile 的 cordis.patch.yml。详见 docs/development.md（§6）。
端到端验证（真实浏览器，需要本机有 Chrome/Edge）：
node scripts/browser-smoke.mjs "http://127.0.0.1:3099/?token=<token>"
解析失败时错误会出现在三个位置：
[lx-music] 直链解析失败: ...，包含完整错误消息与最近 5 条音源脚本 HTTP 请求（状态码:URL(耗时)）。dsh web 所在终端）：每个脚本的完整错误堆栈 + [lx-music sandbox] 音源脚本请求 HTTP <code>: <url> 非 2xx 告警。按状态码判断根因：
HTTP 403：第三方 API 拒绝（IP 封禁 / 风控 / UA 校验）——换网络或换音源。HTTP 503：第三方 API 不可用（onrender 免费实例休眠、配额耗尽或宕机）——重试或稍后再试；手机端能播多半是缓存了旧直链或使用了其他音源。timeout / ERR：网络不可达。HTTP 200 但仍报错：API 返回结构异常或脚本逻辑问题（可看宿主端脚本堆栈定位到具体行）。音源健康检查：node scripts/compile-tests.mjs && node scripts/smoke-source.mjs <音源URL> [平台] [关键词]
package.json npm 包 + dsh.bundle / dsh.client 声明
cordis.patch.yml 组合层 patch（dsh plugin add 后自动生效的插件行）
manifest.json 插件清单（元数据：入口、生命周期、工具、配置项）
src/index.ts host 入口
src/client.ts client 入口
src/ui/ React 组件
tests/ 单元测试（127 例）
docs/ 开发文档 / DSH 与 LX Music 研读笔记
| 插件版本 | DSH 版本 |
|---|---|
| 1.0.1 | @deepseek-ai/dsh@0.1.5-rc.1（dsh.bundle 组合层，一条命令安装） |
| 1.0.0 | @deepseek-ai/dsh@0.1.0-rc.6（需手工写 profile patch 行） |
从 1.0.0 升级要处理两件事（第 2 件自动完成）：
cordis.patch.yml 里手工 insert 的 id: lx-music 行
（或用 scripts/install-to-dsh.mjs 自动迁移并备份），否则同一 id 会让 dsh 启动失败
（duplicate loader entry id: lx-music）。open 都失败，插件静默降级为内存存储
—— 播放列表/设置/播放模式/日志都不落盘。修好后 domain 里的音源快照会比旧版兜底文件
$DSH_HOME/storages/lx-music-sources.json 更旧，插件会自动做一次非破坏性合并，并把该文件
改名为 .migrated-<时间戳>。启动日志确认状态：[lx-music-for-dsh] 插件已加载，provider: engine，storage: durable
（storage: memory 表示持久化不可用）。细节见 docs/development.md §10。