dsh-opening-animation：为 DeepSeek Harness 网页加载加上开场动画

它是做什么的？

linke-e/dsh-opening-animation 是 DeepSeek Harness（DSH）的开场动画插件，在每次 dsh web 页面加载时用全屏遮罩播放你选定的开场内容，结束后再把画面交还主界面。它解决的是 Web 端启动瞬间画面生硬、缺少仪式感的问题，让图片动画或视频成为进入工作台的过渡。插件由 linke-e 维护，采用 MIT 协议，用 TypeScript 编写，形态与 dsh-custom-skin 同构，可与它同场运行。

核心功能

• 图片开场：支持 jpg/png/webp/gif/avif，单张不超过 20 MB、库上限 8 条，提供 tap-reveal、wipe-reveal、glitch、grid-reveal-spread 四种揭示动画。
• 视频开场：支持 mp4/webm/mkv，单条不超过 256 MB，导入时探测解码支持，静音自动播放、播完收场，长视频不截断。
• 收场过渡：cross-fade、dip-to-bg、zoom-fade 三种效果，速度可调，动画期间主界面被遮罩按住不闪帧。
• 随时跳过：点击任意处或按 Esc 即可结束开场，第一击总是开始揭示，Esc 才是跳过。
• 设置页：在「个性化 › 开场动画」中上传、选择、删除、清空媒体，切换动画与过渡，调整高级参数、预览并恢复默认。
• fail-open 兜底：存储打不开、媒体缺失、解码失败、加载超时 8s、图片时长上限、视频无进度 10s 等情况都会立即无过渡撤除遮罩，主界面永远可用。

怎么使用这个插件？

在 DSH 的 Web profile 中启用后，打开设置页的「个性化 › 开场动画」，上传或选择一张图片、一段视频作为开场素材，再挑选动画类型与收场过渡即可。图片动画会先以主色为底等待点击，点击处圆形扩散或从图片左边缘揭示，主色提取会跳过近黑近白像素，深色壁纸也能取到鲜明主色；视频则静音自动播放，缩放与水平、垂直偏移按屏幕宽高百分比调节，默认缩放 1、偏移 0 居中。播放中点击任意处或按 Esc 可跳过，收场过渡结束后遮罩还原、主界面浮现。若开启与 dsh-custom-skin 的联动（默认关闭），上传的图片会单向同步复制进壁纸库，不改动皮肤偏好。

报错怎么排查？

开场内容没有出现时，先确认媒体文件仍在库中且格式、体积在限制范围内，图片不超过 20 MB、视频不超过 256 MB，超出上限会被直接跳过。若画面长时间停在遮罩上，通常是加载超时或视频无进度触发保护，插件会立即无过渡撤除遮罩，此时检查媒体是否可正常解码，必要时重新导入让插件探测解码支持。存储打不开或解码失败同样会走 fail-open 撤除遮罩，按官方说明修复后重新选择素材即可。