dsh-boot-animation-pro

dsh-boot-animation-pro

给 DSH 加一段开机动画：打开 DSH、新对话、或你钉住的会话时，视频铺满整个窗口播放。 这是 NativeDog1/dsh-boot-animation 的二次开发版， 增加播放控制、触发规则、片库管理、画面特效、分时段片头和中英双语界面。 出处、许可与差异见 FORK.md。English: README.en.md

如果你用上了，点个 ⭐ Star 让我知道有人在用 —— 这是这个项目唯一想要的回报。

一条命令安装（复制即用）： 桌面版 App 把 web 换成 desktop。装完完全退出 DSH 再重开才生效。 装好之后长什么样 上面两张是真实浏览器渲染实测截图（Headless Chrome 2560×1313 视口，1280×720 片源， scripts/verify-letterbox.mjs 测量）：铺满模式黑边 0px，完整显示模式左右各 113px。 安装 仓库里已提交构建产物 lib/，也没有 prepare 生命周期脚本，所以这条命令不编译任何东西， 不触发 pnpm 的 allowBuilds 构建授权。

装完必须重启一次 DSH（bundle 层在启动时装配）：

从源码目录安装（开发用）

scripts/dsh-link.mjs 写的东西和 dsh plugin add 完全一致：profile 的 node_modules/ 下一个符号链接、 dependencies 一行、dsh.profile.bundles 一项。可逆，且重复执行是幂等的。 装完看不到效果？先做这件事

DSH 的客户端 bundle 响应带 cache-control: max-age=31536000, immutable。装好或升级后请 完全退出 DSH 再重开；如果是浏览器窗口，按 Ctrl+Shift+R（Mac 上是 Cmd+Shift+R）硬刷新。 DSH 桌面版没有绑定 Cmd+Shift+R。用 Cmd+Q 退出再打开即可 —— 进程换了之后启动页会重新取， 而 rev 是内容哈希，内容变了 URL 就变了，不会命中旧缓存。 用法 什么时候播（触发规则）

侧边栏左下角点 🎛 → 「触发」标签页，五种模式： 冷却时间：距上次播放不足 N 分钟就不自动播（0 = 不限）。它和会话名单是否决条件，对以上每种模式都生效。 会话名单：不限制 / 只在这些会话播 / 这些会话不播。当前会话可以一键加入或移出。 钉住某个会话（让它每次都播）

侧边栏点 🎞 → 变绿 🎬 = 已钉住，之后每次进这个会话都播。再点一下取消。 换自己的视频

最省事：把 mp4 丢进 ~/.dsh/boot-animation-pro/videos/，点 🎛 →「刷新」→ 点「选它」。

片库面板里每条都有： 手动方式（仍然有效，host 按此顺序解析，每次请求都重新解析，换片子不用重启）： 上一个版本（dsh-boot-animation）的 ~/.dsh/boot-animation/ 目录会被只读扫描， 所以升级后你原有的片子还在、还能列出来，但本插件不会去删它。 播放控制

🎛 →「播放」：音量、开片静音、倍速、进度条、倒计时自动跳过、片尾淡出、铺满/完整显示、随机播放。 关于声音：浏览器禁止带声音自动播放，所以动画一律静音起播。 点一下画面即可开启声音并进入全屏 —— 这是唯一符合浏览器策略的做法。 想让它一开始就尝试有声，关掉「开片时静音」；被浏览器拒绝时会显示「点击播放」而不是黑屏。 画面美化