随机开屏动画 muning0214/dsh-custom-splash

dsh-custom-splash

给 DeepSeek Harness 加一段开屏动画：每次启动从三段里随机播放一段，播完自动淡出。

preview

上图就是随包的三段，从左到右各取一帧：

| 文件 | 时长 | 码率 | 画面 |
| assets/stardust.mp4 | 8.06s | 2659 kbps | 闭眼半身特写，柔光星尘 |
| assets/datastream.mp4 | 7.05s | 2951 kbps | 左侧 DEEPSEEK 大字 + 右侧脸部 + 数据流 |
| assets/gaze.mp4 | 7.05s | 2106 kbps | 深色字标 + 青色瞳孔特写 |

安装

dsh plugin --profile desktop add github:muning0214/dsh-custom-splash

- 桌面版用 --profile desktop，Web 版用 --profile web
- 装完完全退出 DSH 再重开（bundle 在启动时装配）
- 仓库里没有构建产物依赖、也没有 prepare / postinstall 脚本，pnpm add 不会编译任何东西，不会触发构建授权

特性

- 随机播放：上面三段，每次加载（= 每次重启）用 Fisher–Yates 洗牌取一段
- 随时跳过：Esc 或点击画面；播完自动淡出
- 隐藏标题栏按钮：Windows 右上角那三个按钮是系统画的，CSS 盖不住，这里改成让它们融进画面
- 实时锐化：SVG feConvolveMatrix 补偿低码率源的糊感，可在 index.mjs 里调强度
- 绝不卡启动：素材坏一个自动换下一个；全部失败、解码报错、播放被拒、超过 20 秒，都立刻放行

换成你自己的视频

1. 把 mp4 放进 assets/
2. 改 index.mjs 顶部的 ASSETS 表：

const ASSETS = new Map([
['stardust.mp4', 'video/mp4'],
['datastream.mp4', 'video/mp4'],
['gaze.mp4', 'video/mp4']
])

加一行就多一段，删一行就少一段。

视频需要 faststart（moov 在 mdat 之前），否则浏览器要下完整个文件才能播。
修复：ffmpeg -i in.mp4 -c copy -movflags +faststart out.mp4

可调参数

| 位置 | 作用 | 默认 |
| MAX_HOLD | 最多遮挡多久（毫秒），兜底放行 | 20000 |
| fade | 淡出时长（毫秒） | 420 |
| kernelMatrix | 锐化卷积核，中心值越高越锐，超过 3.2 开始出白边 | 2.4 / -0.35 |
| CAPTION_CSS | 标题栏按钮透明规则 | 见源码 |

实现

只用了宿主的三个公开扩展点，没有改任何打包文件。

1. 视频路由 — connection.fetch.register()

ctx.connection.fetch.register({
path: '/api/dsh-splash/stardust.mp4',
methods: ['GET', 'HEAD'],
requestBody: 'buffered',
fetch: (request) => serveAsset(request, 'stardust.mp4')
})

必须支持 Range，否则 Chromium 无法流式解码视频。只读白名单里的文件，路径不可穿越。

2. 注入播放器 — webserver/index-inject

往 index.html 的 body 开头注入一段自包含脚本，在应用外壳挂载之前用 Shadow DOM 盖一层全屏 。样式与页面完全隔离，卸载时随宿主一起消失。

3. 隐藏标题栏按钮 — 借用 preload 的色探针

DSH 桌面用 titleBarStyle: "hidden" + titleBarOverlay，按钮由系统绘制在网页之上，z-index 再高也盖不住。但 preload 里有一个隐藏 span，其 background-color / color 被读出来，经 IPC dsh-desktop:windows-appearance 交给主进程 setTitleBarOverlay()。

preload 监听 document.head 的变动，所以注入一条把该探针改成 transparent 的 就会自动触发重发：

[data-windows-titlebar] body:has(> #dsh-custom-splash)
span[style*="--dsw-specific-sidebar-fill"]{
background-color: transparent !important;
color: transparent !important;
}

移除这条 时，按钮配色自动还原。

已知限制

- 分辨率 1280×720：这是素材源文件本身的分辨率，不是压缩掉的。1080p 以上的屏幕会放大显示，靠实时锐化补偿
- 码率 2106–2951 kbps：高于视频平台常见的 720P 档（约 1–1.5 Mbps），但暗场与发丝细节仍有损失
- 只在 Windows 桌面版验证过；macOS / Linux 上标题栏处理会跳过，其余功能照常
- 三段的时长不一致（8.06s / 7.05s / 7.05s），所以开屏时长会略有浮动

参考

本项目的思路同时参考了下面两个项目，特此致谢：

- NativeDog1/dsh-boot-animation —— 原始项目，DSH 开机动画的最初实现，BSD-3-Clause。这个插件后来所有的变体都是从它长出来的
- Yiheng-guo/dsh-boot-animation-pro —— 上面那个项目的二次开发版，补了播放控制、触发规则、片库管理、画面特效和分时段片头，功能最完整

代码是独立写的，没有基于这两个仓库 fork；参考的是思路与实现路线。

素材来源与许可

代码以 MIT 发布。

但 assets/ 里的动画片段不在此许可范围内：它们是第三方动画素材，版权归原作者所有，随仓库附带仅用于演示本插件的效果。如需公开分发或商用，请把 assets/ 替换为你自己拥有权利的素材。

卸载

dsh plugin --profile desktop remove dsh-custom-splash