1. 临时移走本地私人素材配置，确保走占位/空视频

mv theme.config.local.json theme.config.local.json.bak

5. 发布完恢复本地素材配置，开发照旧

mv theme.config.local.json.bak theme.config.local.json

> ⚠️ 千万不要在 `theme.config.local.json` 存在的情况下直接 `npm publish`——那样私人壁纸/图标会被内联进 `lib/` 一起发出去。`.npmignore` 已屏蔽 `src/client/assets/`，但 `lib/` 里的内联素材不受其管控，所以第 1 步的移走动作是关键保险。
>
> GitHub 仓库（带 `dsh-plugin` topic）已是 dsh 社区的主要分发方式；npm 为可选二级分发。

## 素材降级

- 视频缺失 → 中区只无视频壁纸，不崩。
- 图片缺失 → 自动用 1×1 透明占位兜底，不崩。

## 目录

src/ index.ts 宿主加载入口（空壳，逻辑全在 client） client/ index.ts 插件注册点，挂各 applyX 并管理卸载 dom.ts waitForElement / applyInlineStyles / replaceSvgWithImage theme/ config.ts 视觉参数 + tokenOverrides（集中配置） generated.ts 由 build-theme.mjs 自动生成（勿手改） components/ 每界面区域一个 applyX scripts/build-theme.mjs 读 theme.config.json → 生成 generated.ts theme.config.json 用户唯一要改的文件（换图换视频）