yang19997/dsh-live-backdrop

README 摘要

dsh-live-backdrop DSH Web GUI 动态背景 + UI 主题接管 插件： 静态图 + GIF + MP4/WebM 视频背景 ，以及 不依赖任何皮肤插件的界面外观系统 （三个视觉方向预设 + 六色五形参全部可调）。 架构参考 dsh-skins 皮肤体系（皮肤注册 / 路由 / 插槽 / 持久化机制）， 不含任何皮肤资产 ，不照搬任何现成皮肤。 特性 能力 说明 多格式背景 jpg / png / webp / avif / bmp / gif / mp4 / m4v / webm 换图方式 把素材丢进素材目录（ 可自定义到任意盘符 ，如 D 盘，默认 /.dsh/backgrounds/ ），面板点「刷新」即出缩略图， 点选即换、无需重启 选择持久化 当前背景、素材目录、所有开关与主题配置存 /.dsh/dsh-live-backdrop.json ，重启自动恢复 性能保护 标签页不可见自动暂停视频； prefers-reduced-motion 时不自动播放；低内存设备（ 为什么插件行要写在用户补丁层而不是包的 cordis.patch.yml ：DSH 宿主的 HMR 只热监听用户补丁层（profile 的 cordis.patch.yml 与 /.dsh/cordis.patch.yml），bundle 补丁层是启动时快照。写在用户补丁层可「装完立即生效、无需重启」，且重启后依然持久。若两层同时写同一 id，会因重复插件 id 导致启动失败（本包内的 cordis.patch.yml 因此留空，仅含说明注释）。 安装后刷新 GUI 页面，进入 设置 → Web UI 插件 → 动态背景 。 日常迭代（改代码后如何生效） 改动 生效方式 改 client 代码（面板/引擎/主题控制器） pnpm build → 刷新页面即生效 改 host 代码（store/routes/入口） pnpm build → 重启 GUI （DSH 宿主对 host 插件模块无热替换，需要完整重启进程） 换素材 丢进素材目录 → 面板点「刷新」 卸载： 素材目录与规格建议（性能关键） 目录： /.dsh/backgrounds/ （可用环境变量 DSH LIVE BACKDROP DIR 覆盖）。 插件的优化只能"少干活、干完就停"，真正决定 CPU/内存的是素材本身。 建议规格： 素材 建议 原因 视频（mp4/webm） ≤720p 、H.264/VP9、码率 1–3 Mbps、10–30 秒短循环 浏览器对视频做 GPU 解码，分辨率是 CPU/显存成本的主项 GIF 尽量转 mp4 （如 ffmpeg -i bg.gif -c:v libx264 -pix fmt yuv420p -crf 28 bg.mp4 ） GIF 解码后 每一帧都驻…

分类