dsh-startup-animation
DSH 启动动画 + 主界面壁纸：多层动效的启动页 + 主界面壁纸，两张图可在设置里自由更换并实时预览
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:KylinQ01/dsh-startup-animation#d96314352fd4dcfb540112e5c0fa3d5dc86fbdd1Startup Animation 以 dsh-startup-animation 发布，当前版本为 2.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一次开机，演这么一出小戏 🎬
| 时刻 | 画面 |
|---|---|
0.0s | 主界面被 <head> 里的早脚本提前藏好，不会先闪一下白底主界面 |
~0.1s | 背景图缓缓推近 · 三团极光来回漂 · 一束放射光慢慢转 · 星尘一闪一闪 · 光点往上飘 · 流星偶尔掠过 |
~0.2s | 头像「啵」地弹进来，套一圈爆闪环 + 四周迸出星火 + 两圈涟漪，还有一道玻璃反光扫过 |
~0.3s | 「欢迎回来」一个字一个字浮上来，下面一条渐变细线展开 |
| 全程 | 两圈加载环一顺一逆慢慢转 · 头像自己极慢地推近 · 鼠标一动整屏按远近分层视差跟着晃、头像跟着轻轻 3D 倾斜，还有一盏暖光跟着指针走 🐾 |
| 加载好了 | 背景被"镜头收住"：从推近状态收回到 1:1 并拉掉虚化（看得见的那一下），舞台同时撤走、整层淡出，主界面从 1.035 归位淡入 —— 一起做完 |
| 进去之后 | 主界面壁纸就是同一张背景图，所以过场看起来像"背景由虚转实"，接得很顺 🍃 |
最短演 1.5 秒，最多挡你 5 秒；点一下或者按任意键就能跳过。
而且——两张图都能在设置里自己换，换完当场就能预览，不用重启 👇
| 位置 | 做什么 |
|---|---|
| 顶部「实时预览」 | 把开机那一份启动动画原样嵌在小窗里播放（连主界面壁纸一起，收尾的交接也看得到）。换完图自动重放，「重播」手动重放，「新标签打开」放大看 |
| 头像卡片 | 开机动画正中那张。点「选择图片」，或者直接把图拖到卡片上。圆角方框显示，不会把猫耳朵裁掉 🐱 |
| 背景图卡片 | 开机背景 + 主界面壁纸。建议横图，界面里按 cover 铺满 |
| 恢复默认 | 删掉自定义图，回到包里自带的图 |
| 在真实界面里看一遍 | 清掉"刚看过"的标记再刷新，真的在 DSH 里重放一遍 |
$DSH_HOME/dsh-startup-animation/，删掉文件或点「恢复默认」即可还原git clone https://github.com/KylinQ01/dsh-startup-animation.git
然后把依赖写进 profile 的 package.json（link: 指向刚 clone 下来的目录）：
// ~/.dsh/profiles/<profile>/package.json
"dependencies": {
"dsh-startup-animation": "link:/绝对路径/dsh-startup-animation"
}
dsh plugin --profile desktop install --offline # 建好 node_modules 链接，并自动加进 dsh.profile.bundles
dsh --profile desktop --dump-config | Select-String startup-animation # 看到 id: dsh-startup-animation 就对了
然后重启 DSH（DSH Desktop 或 dsh web）。宿主日志里会出现：
[dsh-startup-animation] dsh-startup-animation: 启动动画 + 主界面壁纸已挂载，图片目录 …
⚠️ Windows 上路径里带空格的话，别用
dsh plugin add传路径 —— 它经 cmd 转发会把参数切碎， 手动写进package.json再install就好。
卸载：从 profile 的 package.json 里删掉依赖，再跑一次 dsh plugin install，bundles 会被自动回收。
（插件目录别删也别改名 —— profile 通过 link: 指着它呢。）
| 想改 | 改哪里 |
|---|---|
| 节奏：最短/兜底时长、就绪判定、过场时长、星尘光点数量 | assets/boot.js 顶部那几个常量（SPARKS 是入场星火数） |
| 头像大小圆角、文字、进度条 | assets/boot.css 的 .dshs-avatar / .dshs-hello / .dshs-bar |
| 背景虚化程度、推近速度 | .dshs-bg 的 filter 和 dshs-drift |
| 极光颜色与浓淡 | .dshs-aurora i:nth-child(1~3) 的三组 radial-gradient |
| 星尘 / 光点 / 流星 | .dshs-star / .dshs-petal / .dshs-streaks |
| 光束转速与明暗 | .dshs-rays 的 conic-gradient 和 dshs-spin |
| 两圈加载环 | .dshs-orbit（大小、粗细、转速、颜色都在这里；第二圈是 .dshs-orbit + .dshs-orbit） |
| 跟随指针的暖光 | .dshs-cursor 的 radial-gradient 与 translate 里的 50vw/50vh |
| 头像 3D 倾斜幅度 | .dshs-portrait 的 rotateY/rotateX 里那两个 6deg/5deg |
| 鼠标视差幅度 | boot.css 顶部三条 translate: calc(var(--dshs-px) * Npx)，改那个 N 就是改纵深 |
| 主界面壁纸浓淡 / 侧栏透明度 | assets/wallpaper.css 的 --dshs-wall-veil-a/b（越大越淡）与 --dsw-specific-sidebar-fill |
改 lib/index.js（路由、注入）要重启宿主；只改 client/client.js 由客户端 HMR 热更。
过场是"一条 700ms 的时间轴"，三处要成对改：boot.css 里 #dshs.is-out 的
opacity .7s、html.dshs-boot-out #root 的 transition，都要和 boot.js 的 OUT_MS = 700
一致，否则主界面会早于或晚于启动页出现。
别给过场加 transition-delay，也别加 will-change：主界面这时正在首次渲染，
主线程一忙，走主线程的 opacity 过渡会比合成器上的位移晚开始；延时只会让它对不齐，
而 will-change: opacity 挂在这么大的合成层上只会更慢。（这是实测踩出来的。）
收尾靠三处对齐才不会"跳"，动其中任何一处都要三处一起看：
.dshs-bg 不留 inset 富余，object-fit: cover 的取景＝主界面壁纸的 center/cover；.dshs-bg 收到 scale(1) + 去虚化 + 视差归零（用 transition 收，不要用 animation：
animation 一旦被撤掉会瞬间跳到目标值，那一下就看不见了）；.dshs-handoff 用壁纸同一组白纱变量补齐白度（否则图片对上了、白度对不上，还是会闪一下）。摘节点的时机不能写死：boot.js 是等 transitionend（opacity 跑完）才移除启动页，
定时器只做兜底。写成固定 OUT_MS + 120 的话，主线程一卡就会把还没淡完的启动页硬切掉 ——
看起来就是"没有转场"。
check.mjs会逐个核对 boot.js 用到的类名在 boot.css 里有没有规则（新增画面层时漏写直接报错）， 也会检查上面这三处对齐有没有被改坏 🔍
node check.mjs # Node 18+
它会把路由、注入落点、幂等、脚本语法、上传/回退的完整来回、设置页组件全跑一遍，
最后生成 preview/index.html —— 双击就能完整看一遍动画与过场，不用装进 DSH。
💡 用无头浏览器截图核对画面时注意：headless Chromium 默认把
prefers-reduced-motion报成reduce， 会关掉星尘/光点/循环动效，你看到的是"静音版"。要走 CDPEmulation.setEmulatedMedia显式模拟no-preference才是真实效果。
刷新页面怎么不放动画？ 同一标签页 60 秒内重复刷新会自动跳过（自动重载循环不该每次都演一遍），只看壁纸变化。 想看：点设置里的「在真实界面里看一遍」，或者开个无痕窗口。
切深色主题为什么没壁纸了？
故意的。浅色图配浅色文字会糊成一片，所以深色主题保持原样。真想要：删掉
wallpaper.css 里的 :not([data-ds-dark-theme])，然后自己想好文字对比度怎么办 🙈
会不会白屏？
不会。任何一步抛异常都会立刻撤掉启动页、把主界面放出来 —— 最坏情况是"没有动画"，
绝不是"打不开"。另外 <head> 里还留了 8 秒自动放行的保险。
系统开了「减少动态效果」怎么办？ 只保留入场和过场，常驻循环、星尘、光点、视差全部关掉。
MIT © KylinQ01
愿你每次打开它，都被好好欢迎一次。 🌙