dsh-boot-animation

dsh-boot-animation

给 DSH 换掉原生启动页，并给闲置的界面加一层屏保。两个功能各自独立开关，不改 DSH 本体源码，升级 DSH 不受影响。 特性 素材按扩展名支持四类：视频（.mp4 .m4v .webm .mov）、静态图（.png .jpg .jpeg .avif）、动图（.gif .webp）、Live2D 模型（含 .model3.json 的文件夹）。.svg 与 .mkv 一律忽略。 片头池多片随机，先把池子里每条轮一遍再重来，不会连着重复同一条；底部进度条跟内核真实的启动进度走。 启动路径上每个走不下去的地方都有上界：素材清单 10 秒不应答就当作没有素材、某段片子 6 秒出不来画面就换下一段、时长未知走 20 秒兜底、内核 15 秒不就绪就提示「启动较慢，点击继续」；Esc / 空格 / 回车随时直接进。 设置全在「设置 → 插件」的「启动动画」卡片里，不用重启 DSH：屏保那几项立刻生效，启动动画那几项下次启动生效。 屏保两个触发条件任一满足即出现：整机闲置（Windows 读系统闲置计数）与窗口失去焦点。 屏保收回必须点一下或按一个键；鼠标移动不算「回来」，也不会重置窗口失焦的计时（只有 Windows 的整机闲置计数会因为它归零）。 屏保退出三种特效：粒子消散 / 重力下坠 / Glitch 宽带位移，默认每次随机挑一个；关掉是普通淡出。特效是透明的，碎开时露出的是你的界面。 屏保可轮换（15 秒 / 30 秒 / 1 分钟 / 5 分钟，默认不轮换）：到点就换下一条，带交叉溶解，且不会连着放同一条。 不改 DSH 源码：只往 注入脚本，再提供一张设置卡片。 指针互动特效（水波涟漪 / 星屑吸附）的实现仍在代码里，但卡片上已不提供入口——这个效果在桌面版上一直没能稳定工作，所以入口被撤了。设置字段与实现都保留，现有配置不会丢。细节见 MANUAL.md。 环境要求 装法

三条路，选一条。细节与撤销办法见 INSTALL.md。

路 A：官方命令

这条路会让 pnpm 把依赖也装好，装完重启一次 DSH。桌面版（DSH Desktop）的 profile 叫 desktop，而这条命令不允许直接改它，桌面版请走路 B 或路 C。

路 B：Windows 脚本（免重启）

路 C：macOS / Linux 脚本

路 B / 路 C 是同一件事：找 DSH 的位置（先看 DSH_HOME，再找 ~/.dsh）、在 profile 的 node_modules 里建目录链接、往 cordis.patch.yml 追加一行、并把设置卡片需要的 @deepseek-ai/schemastery（DSH 自带那份，要 3.18.4 及以上）链上。不碰 package.json，不跑 pnpm。 找不到 profile 会明确报错并列出有哪些 profile，装之前自动备份 cordis.patch.yml；大多数 profile 会热加载，不热加载的脚本会提醒你手动重启。撤销用 tools/uninstall.ps1 / tools/uninstall.sh，参数同上。 装完刷新浏览器：看到深海底背景 + 一条短片铺满窗口就是装好了。左侧菜单里没有「启动动画」这一项，几乎只有一个原因——插件旁边链接的 schemastery 太旧（缺 .volatile()），卡片会静默消失，控制台留一条 boot-animation: 开头的告警。 启动动画

打开页面时依次是：深海底背景 + 一条从片头池随机取来的素材铺满窗口 → 底部一条细进度条跟内核的启动进度走 → 片尾开始溶解进界面 → 覆盖层整个移除。

短片以静音开始（Chromium 不允许没有用户手势的带声音自动播放）。点一下画面才开声音，这一下故意不进入——手势解锁需要时间起效，绑成一次点击就是「刚出声就进界面」。进入交给片尾；想早点进，点一下或按 Esc / 空格 / 回车。

进入方式三选一： 三种方式（「点击才进」除外）都还要等内核就绪——淡入就是界面显形的过程，内核没好就溶解出一个还没搭好的界面。片头放完但内核还没跟上时，画面停在最后一帧等它。