lx_music-for-dsh 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。

lx_music-for-dsh 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。

lx_music-for-dsh 有中文文档吗？

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

lx_music-for-dsh 还在维护吗？

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

洛雪音乐控制台 CyberryRe/lx_music-for-dsh

DeepSeek Harnessv1.3.0

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

在 GitHub 查看 ↗

LX Music 增强控制插件 —— 为 deepseekharness 提供侧边栏播放卡片、播放/音源管理界面与…

32.9/100

综合分

GitHub 星标

181

npm 周下载

—/5

用户评分

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

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

dsh plugin --profile web add lx-music-for-dsh

npm 源 · lx-music-for-dsh 的发布者账号已校验与本仓库一致

状态速览

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

信任档位：已验证

是什么

dsh 原生插件 · other

装得上吗

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

非静态推断

L4 · 真实安装等级说明 →

安全吗

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

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

还在维护吗

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

档位由哪些信号合成

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

验证判据与等级说明 →

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

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包lx-music-for-dsh @ 1.3.0

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/17 12:41:42

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

v2.7.0

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

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

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

可执行外部命令读写/删除本地文件发起外部网络请求

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

读取本地文件
lib/index.js:586
if (existsSync(p))
读取本地文件
lib/index.js:670
if (!existsSync(runnerPath)) {
执行外部命令来自配置/变量
lib/index.js:685
const proc = spawn(process.execPath, [runnerPath], {
发起网络请求
lib/index.js:875
const res = await fetch(url, {
发起网络请求
lib/index.js:900
return this.request(path, init, attempt + 1);
发起网络请求
lib/index.js:914
await this.request('/api/status', { method: 'GET' });
发起网络请求
lib/index.js:934
const list = await this.request(`/api/music/search?${params.toString()}`);
发起网络请求
lib/index.js:970
return this.request('/api/music/url', {
发起网络请求
lib/index.js:981
return this.request('/api/music/lyric', {
读取本地文件
lib/index.js:3663
if (!existsSync(file))
读取本地文件
lib/index.js:3667
data = JSON.parse(readFileSync(file, 'utf8'));
写入本地文件
lib/index.js:3702
renameSync(file, `${file}.migrated-${String(Date.now())}`);
读取本地文件
lib/index.js:3778
const text = readFileSync(this.file, 'utf8');
写入本地文件
lib/index.js:3849
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
lib/index.js:3851
await writeFile(tmp, snapshot, 'utf8');
写入本地文件
lib/index.js:3852
await rename(tmp, this.file);
读取本地文件
lib/index.js:7346
if (existsSync(domainDir))
删除本地文件
lib/index.js:7390
rmSync(path, { recursive: stat.isDirectory(), force: true, maxRetries: 3 });
写入本地文件
lib/index.js:8419
renameSync(file, target);
写入本地文件
lib/index.js:8431
renameSync(stashed, defaultDomainFile(source));
发起网络请求
lib/runner.cjs:198
const req = transport.request(url, { method, headers }, function (res) {

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

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

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

用户评分

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

广告精选好物

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

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

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

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

侧边栏播放卡片
播放与音源管理

这个插件让 DeepSeek Harness 拥有 lx music 的能力。

最近更新

在 GitHub 查看全部 →

v1.3.02026-10-04

· 重点更新

· 系统媒体控件（SMTC）支持增强
Windows 媒体面板现在能正确显示歌名 / 歌手 / 专辑 / 专辑封面与播放状态、播放进度；面板与键盘上的播放·暂停 / 上一首 / 下一首 / 快进快退也会接回播放器。修掉了"面板只显示会话名、没有封面"的问题（此前没写 MediaMetadata，Chromium 只能用页面标题兜底）。进度按 throttle + 阈值上报，不会每帧都去更新系统面板；内核不支持时整体降级为不做任何事，不影响播放。

· 音量调节
侧边栏卡片上的喇叭图标点开即弹出一根竖滑块（不再常驻占一行）。拖动期间只本地预览、抬手才同步给 host，避免一次拖动打几十个 remote 调用。面板是独立组件（手写 DOM portal + fixed 定位），不会被卡片裁断，窗口变矮时自动翻到按钮下方。

· 一并并入：滚动歌词
当前句高亮并自动居中、逐字（卡拉OK）高亮、翻译/音译、点任意一行跳转、字号调节、「回到当前」。来源降级：音源脚本 lyric → 内置五平台歌词 → lxserver → 演示数据；带 6 小时缓存。拿不到歌词不是错误：窗口会直接写明原因。

· 已知问题 / 行为变更

· 歌词入口当前先隐藏（原「词」按钮的位置换成了喇叭）。歌词链路完整保留，需要时把 src/ui/Card.tsx 里那段按钮加回来即可恢复。
· 静音入口目前只在 host 侧（music_control 工具 / 设置窗口），卡片面板里刻意没有放静音按钮。
· ⚠️ 1.2.2 及更早版本的用户：若你在 profile 的 cordis.patch.yml 里手写过 cleanupOnUninstall: true，请改成 false（或删掉该行用默认值），否则升级/热重载会清掉 $DSH_HOME/storages/lx_music/（播放列表、设置、音源一起没了）。

· 安装

方式一：npm

npm i lx-music-for-dsh@1.3.0
dsh plugin --profile add lx-music-for-dsh@1.3.0

方式二：下载下面的预构建包（离线可用，不需要构建）

dsh plugin --profile add

装好后请彻底退出并重启 DSH（关窗口不算）。只改了 client 半边（本版的卡片 / 音量面板）时刷新页面即可；改到 host 半边才必须重启进程。

确认是否生效：看 $DSH_HOME/lx-music-plugin-status.json（存在即说明 host 半边被调用过）。

· 兼容性

DSH 0.2.0（也兼容 0.1.7 / 0.1.5）。升级到 1.3.0 不需要动 DSH 版本，存储布局迁移自动完成（旧 lx_music.json 会改名保留，可随时回退）。没有新增配置项、没有新增 npm 依赖。

· 产物

lx-music-for-dsh-1.3.0.tgz — 233253 字节，sha256 b9bedbe0e094905bcadf086b977d2ac0b2b6e0895cb05b73eb5ac152e3e08740

v1.1.02026-09-25

· lx-music-for-dsh 1.1.0

一份产物，同时兼容 DSH 0.1.5 与 0.1.7，并修掉桌面版上音源脚本完全不可用的问题。

从此不再需要"按 DSH 版本挑插件版本"。本版本同时挂在 npm 的 latest 与 lts dist-tag 上。

· 🐛 修复：桌面版（Electron 宿主）音源校验 / 导入全部失败

症状（设置窗口「音源管理」导入任何 .js）：

校验失败：音源 temp_validate 子进程在初始化期间退出（code=0）
导入失败：音源 长青SVIP音源(二改修复版).js 子进程在初始化期间退出（code=0）

根因：桌面版里插件跑在 Electron 主进程，process.execPath 是 Electron 主程序而不是
node。原来的实现直接 spawn(process.execPath, [runner])，于是又起了一个 GUI 实例，撞上
单实例锁后立刻以 code=0 退出——而 code=0 看起来"正常退出"，所以报错信息也很有误导性。

修法：给子进程环境显式注入 ELECTRON_RUN_AS_NODE=1（DSH 自己启动内部 Node 脚本用的
也是这一招），让同一个可执行文件以纯 Node 模式运行 runner。注意子进程环境是白名单，
所以这个变量必须显式注入、不能靠透传。

实测通过的真实音源（F:\Tools\0912-update）：星海音乐源 v2.3.11、lx-music-source-v6 (修复)、
长青SVIP音源(二改修复版) v1.2.0、野花音源、HYWmusic_beta_公益测试 v0.74.0 —— 全部 init OK。

· 🔄 双契约：client 面同时携带两代 codec

0.1.5 与 0.1.7 的 Typert strict codec 契约正好相反：

| | 0.1.5 | 0.1.7 |
|---|---|---|
| 校验 | typeof codec.schema.parse === 'function' | typeof codec.create === 'function' |
| 解码 | codec.schema.parse(v) | codec.create().parse(v) |

只满足一边，ctx.remote.$mount() 就会抛 strict codec has no create() factory
（0.1.5 侧则是 has no parse() method），整个 client 插件无法激活
（GUI 报 web boot: N entries did not activate，侧边栏卡片不出现），而 host 端日志完全正常。

1.1.0 的做法是两个字段同时提供——两代运行时都只读自己那一个字段，多出来的字段不会被拒绝：

const schema = build() // 0.1.5 直接读它，无法懒加载
return { mode: 'strict', typeSymbol, schema, create: () => schema }

已对着 0.1.5-rc.2 与 0.1.7-rc.2 的 validateCodec / decode 源码逐字核对，并由
tests/remote-contribution.test.ts 逐字复刻两套校验+解码路径作为回归锁。

· 📦 安装 / 升级

· npm（latest 与 lts 都指向 1.1.0）
npm i lx-music-for-dsh@1.1.0
dsh plugin --profile web add lx-music-for-dsh@1.1.0

· 或本页 Assets 里的预构建包（无需构建、无需 allowBuilds）
pnpm add

升级无需迁移数据：插件配置与 $DSH_HOME/storages/lx_music.json 格式都没变；
从 1.0.1 / 1.0.2 升到 1.1.0 也不需要动 DSH 版本。

旧版本仅作参考（互斥）：1.0.2 只能用于 DSH 0.1.7+；1.0.1 只能用于 DSH 0.1.5-。

· 为什么不要写 github:CyberryRe/lx_music-for-dsh#v1.1.0

pnpm ≥ 10.26 默认禁止 git 依赖执行 prepare，而本仓库的 lib/ 不在 git 里、必须现场构建；
allowBuilds 的 key 还要精确到 commit + 抓取 URL（实测只写包名无效，且形式会变）。详见
docs/development.md §6.4。

· 🧪 

v1.0.22026-09-25

· lx-music-for-dsh 1.0.2

兼容性发布：适配 @deepseek-ai/dsh 0.1.7（桌面版内置运行时 0.1.7-rc.2）。

· ⚠️ 破坏性变更：必须「先升 DSH，再升插件」

0.1.7 把 Typert strict codec 从 schema 字段改为 create()：

| | 0.1.5 | 0.1.7 |
|---|---|---|
| 消费 codec | codec.schema.parse(v) | codec.create().parse(v) |
| 校验 codec | typeof codec.schema.parse === 'function' | typeof codec.create === 'function' |

1.0.1 的 bundle 在 0.1.7 上会在浏览器侧 ctx.remote.$mount() 抛
strict codec has no create() factory，导致整个 client 插件无法激活
（GUI 报 web boot: N entries did not activate，侧边栏卡片直接不出现），
而 host 端日志完全正常，极易误判为「插件没问题」。

· **0.1.7 / 0.1.7-rc.\* 用户：升级到 1.0.2；
· 0.1.5 及更早用户：请留在 1.0.1，不要升 1.0.2（同一变更的反向不兼容）；
· 升级无需处理数据迁移：插件配置与 $DSH_HOME/storages/lx_music.json 格式都没变。

· 🔧 修复与改进

· client 面契约适配：strictCodec() 工厂产出惰性 + 记忆化的 create()，
 schema 只在首次边界使用时物化（协议要求 schema 来自 bundle 自身的 zod realm）；
· 协议类型直绑：手写 descriptor 的类型改为直接引用 @deepseek-ai/dsh-typert-protocol
 的真实协议类型（import type，构建时被擦除、不进 client bundle）。协议再漂移会在
 tsc 阶段报错，而不是等到浏览器里 $mount 失败；
· 回归测试（新增 4 例）：锁定 strict codec 契约（必须提供 create()、不再暴露 schema、
 create() 可 parse 且记忆化、descriptor 通过 wire 校验规则），并交叉校验 client 面与
 PlaybackService 的 @Remote 方法双向一致（方法名 + 形参个数），避免以后加
 @Remote 方法忘了同步 client 面；
· 开发工具链：scripts/link-dsh.mjs 支持 --from / $DSH_RUNTIME_DIR 显式指定运行时，
 并读取桌面版 app.asar 的版本做漂移防护**（镜像来源与桌面版不一致时直接拒绝，
 --allow-drift 可跳过）；其他 scope 改为按包粒度填缺，不再整目录覆盖 npm 的 @types/*；
 自动跳过 >40 MB 的平台二进制包；
· scripts/build.mjs 产物大小按 UTF-8 字节上报（原为 UTF-16 字符数，中文注释会使其偏小）；
· 依赖 zod ^4.4.3 → ^4.6.5，对齐 0.1.7 运行时提供的版本。

· 📦 安装 / 升级

前置条件：DSH ≥ 0.1.7-rc.2（0.1.5 及更早请留在 1.0.1）

· 方式一：npm（推荐）
npm i lx-music-for-dsh@1.0.2
dsh plugin --profile web add lx-music-for-dsh@1.0.2

· 方式二：本页 Assets 里的预构建包（无需构建、无需 allowBuilds 配置）
pnpm add

装完重启 dsh / 桌面版并刷新浏览器：侧边栏「设置」上方出现迷你播放卡片即表示 client 插件已激活。

· 为什么不要写 github:CyberryRe/lx_music-for-dsh#v1.0.2 这种 git 依赖

pnpm ≥ 10.26 出于供应链安全默认禁止 git 依赖执行 prepare 脚本，而本仓库的构建产物
（lib/）不在 git 里、必须现场构建，于是这条路上有两道坎：

1. 必须在 profile 的 pnpm-workspace.yaml 里放行，且 key 要精确到 commit + 抓取 URL
 （实测只写包名无效；key 的形式还会随 pnpm 实际抓取方式在
 gi

数据来自仓库的 GitHub Release，可能与插件实际版本不一致。

README

由 DeepSeek 最新模型翻译生成

lx-music-for-dsh LX Music 增强控制插件 —— 为 deepseek_harness 提供侧边栏播放卡片、播放/音源管理界面与 LLM 点歌能力。开箱即用，不需要任何外部服务。功能 - 侧边栏迷你播放卡片（位于「设置」按钮上方）：封面、歌名-歌手、可拖动/点击跳转的进度条、上一首/播放暂停/下一首、音量调节、播放模式切换（列表循环/单曲循环/随机/顺序，点击循环切换）、播放列表弹窗、设置齿轮。音量：点喇叭图标弹出一根竖滑块（不常驻占位）；面板由独立组件 src/ui/VolumePopover.tsx 手写 DOM portal 挂到 <body> 并用 fixed 定位，因此不会被卡片裁断，窗口变矮时还会自动翻到按钮下方。拖动中只本地预览、抬手才同步给 host（避免一次拖动打几十个 remote 调用）。（歌词入口当前先隐藏：原「词」按钮的位置换成了喇叭；歌词链路本身完整保留，需要时把 src/ui/Card.tsx 里那段歌词按钮加回来即可恢复。） - 滚动歌词窗口（入口当前隐藏，链路完整保留）：当前句高亮并自动居中、逐字（卡拉OK）高亮、翻译/音译、点任意一行跳到那一句、字号调节、「回到当前」、手动滚动后不再抢滚动条。

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

lx-music-for-dsh

LX Music 增强控制插件 —— 为 deepseek_harness 提供侧边栏播放卡片、播放/音源管理界面与 LLM 点歌能力。开箱即用，不需要任何外部服务。

功能

- 侧边栏迷你播放卡片（位于「设置」按钮上方）：封面、歌名-歌手、可拖动/点击跳转的进度条、上一首/播放暂停/下一首、音量调节、播放模式切换（列表循环/单曲循环/随机/顺序，点击循环切换）、播放列表弹窗、设置齿轮。
音量：点喇叭图标弹出一根竖滑块（不常驻占位）；面板由独立组件 src/ui/VolumePopover.tsx 手写 DOM portal 挂到 <body> 并用 fixed 定位，因此不会被卡片裁断，窗口变矮时还会自动翻到按钮下方。拖动中只本地预览、抬手才同步给 host（避免一次拖动打几十个 remote 调用）。
（歌词入口当前先隐藏：原「词」按钮的位置换成了喇叭；歌词链路本身完整保留，需要时把 src/ui/Card.tsx 里那段歌词按钮加回来即可恢复。）
- 滚动歌词窗口（入口当前隐藏，链路完整保留）：当前句高亮并自动居中、逐字（卡拉OK）高亮、翻译/音译、点任意一行跳到那一句、字号调节、「回到当前」、手动滚动后不再抢滚动条。歌词来源按「音源脚本 lyric action → 内置五平台歌词接口 → lxserver → 演示数据」降级；拿不到歌词时窗口里直接说明原因（不是每个平台每首歌都有歌词）。
- 系统媒体控件（SMTC / 硬件媒体键）：把歌名、歌手、专辑、专辑封面与播放进度/状态推给 Windows 媒体面板（Electron/Chromium 的 navigator.mediaSession），并把面板与键盘上的播放/暂停/上一首/下一首/快进快退接回播放器。修掉了"面板一直显示会话名、没有封面"的问题（那时插件没写 MediaMetadata，Chromium 只能用页面标题兜底）。歌词窗口底部与设置窗口「音质策略」页各有一行自检信息，告诉你到底推出去了什么（系统面板没有回读 API）。
- 主窗口（点击卡片主体打开，可调大小、记忆位置）：搜索（关键词/歌手/平台过滤）、搜索结果（音质/时长、+队尾 / +下一首）、播放列表管理（拖拽排序、删除、清空、导出文本）。
- 设置窗口（点击齿轮）：音源管理（文件/URL/粘贴导入并自动启用、启停/删除/排序）、音质策略（默认音质、平台优先级）、自动拉取规则（切歌自动最高音质、降级策略）。
- 细粒度 LLM 音乐工具集：music_search / music_play / music_playlist / music_prev / music_next / music_control，以及兼容入口 search_and_play；内置滑动窗口防刷（默认 6 次/分钟）。
- 音乐画像（实验性 · 默认关闭）：music_profile 读口味画像与"可直取"的曲目候选；music_play_song 精确点播一首确定的歌（优先用画像里已确认的平台 id 零搜索播放，退化到按曲名+艺人严格确认，确认不到就明确失败——不会拿翻唱或别的版本顶替）；music_taste 读写口味（like/dislike/forget/note/summary）。另随插件注册 skill taste-aware-picking，把"先查画像 → 挑一首确定的歌 → 精确播放"流程版本化。

⚠️ 实验性功能，默认关闭：开启入口在 设置 →「实验性」页 → 红色警示 →「了解风险并开启…」→ 确认框。未开启时：不采集任何收听行为、不写点歌日志、不注册 skill、卡片上不显示 ♪ 入口。数据全部在本机处理、不上传；本插件不会在卸载/升级时自动删除数据，需要清理时用「设置 → 实验性 → 清理本机数据」（详见 技术说明 §4）。

快速开始

方式一：npm（推荐）

npm i lx-music-for-dsh@latest
dsh plugin --profile <你的profile> add lx-music-for-dsh@latest

方式二：下载 Release 里的预构建包（离线可用，不需要构建、不需要 allowBuilds）

从 Releases 下载 lx-music-for-dsh-<版本>.tgz，然后：

dsh plugin --profile <你的profile> add <下载下来的 .tgz 完整路径>

装好后 彻底退出并重启 DSH（关窗口不算）——本版本修改插件代码后必须完全重启才会加载新代码，插件页/卡片会一直显示上一次启动时的旧状态。这是已知问题，会在下个大版本修复。

只改了 client 半边（本版的音量面板、卡片 UI 都属于此类）时，刷新页面即可看到新代码；改到 host 半边（工具注册、歌词/直链解析、SMTC 桥等）才必须重启进程。

确认是否生效：看 $DSH_HOME/lx-music-plugin-status.json（存在即说明 host 半边被调用过，里面按阶段记录了 storage 是否就绪、音源落盘后端（sourceStore: domain|file）、注册了几个工具）。sourceStore 必须是 domain —— 若是 file，说明音源只写进了兜底文件 $DSH_HOME/storages/lx-music-sources.json。排查步骤见 技术说明 §5.2。

DSH 版本兼容性对照表

| 插件版本 | 目标 DSH | 状态 |
| 1.3.0 | 0.2.0 | 推荐（npm latest / lts）。新增：① 卡片音量调节；② 滚动歌词（逐字卡拉OK，五平台歌词 + 音源脚本 lyric）；③ 系统媒体控件（SMTC）元数据/封面与硬件媒体键。也兼容 0.1.7 / 0.1.5 |
| 1.2.3 | 0.2.0 | 仍可用（无歌词/音量 UI/SMTC）。修：音源持久化、切歌竞态、不再在升级/卸载时删数据 |
| 1.2.2 | 0.2.0 | ⚠️ 不建议再用：导入的音源只写进兜底文件、重启后可能"消失"；升级插件可能清空本机数据 |
| 1.1.0 | 0.1.7 | 仍在 0.1.x 的用户用它（也兼容 0.1.5）。⚠️ 0.2.0 及以上无法激活（插件不工作）；能升级 DSH 就换 1.3.0 |
| 1.0.x | 0.1.7 之前 | 历史版本。（例外：1.0.2 只配 0.1.7 及以后；1.0.1 只配 0.1.5 及更早） |

怎么选：DSH 0.2.0+ → 1.3.0｜DSH 0.1.7 → 1.1.0（或直接升 1.3.0）｜DSH ≤ 0.1.5 → 1.0.1。

- 全部已发布版本、每个版本的可用性说明、发布流程与 dist-tag 规则： docs/versioning.md。
- 升级到 1.3.0 不需要动 DSH 版本；存储布局迁移自动完成（旧 lx_music.json 会改名为 lx_music.json.migrated-<时间戳> 保留，可随时回退）。
- 1.2.2 → 1.2.3 的一个手工动作：若你在 profile 的 cordis.patch.yml 里手写过 cleanupOnUninstall: true，请改成 false（或删掉该行用默认值）——1.2.2 的随包 patch 把它设成了 true，会让每次升级/热重载在 8 秒后删掉 $DSH_HOME/storages/lx_music/（播放列表、设置与音源一起没了）。
- 1.3.0 的歌词/SMTC 是"装了就有"：没有新增配置项，也没有新增 npm 依赖。
歌词拿不到时窗口会写明原因；SMTC 在当前内核不支持时自动降级为不做任何事（不影响播放）。

文档

| 文档 | 内容 |
| 架构与阅读指南 | 先看这个：文件职责表、四条主数据流、不能碰的硬约束、"我要改 X 该动哪里"、已知技术债 |
| 技术说明 | 架构、音源脚本沙箱与安全模型、Electron 宿主、codec 双契约、存储与本地数据、排查手册 |
| 版本台账 | 插件 × DSH 对照、每次 DSH 跳跃的断裂点、发布流程与 dist-tag 规则 |
| 开发文档 | 本地构建/调试/打包/测试、按 DSH 版本安装、验收清单 |
| 画像设计 | 音乐画像的算法设计与验证结论 |