dsh-deepseek-splash
DeepSeek 开屏动画 —— 点开软件的第一眼 就是这段鲸鱼片头。
DSH Desktop 启动画面：鲸鱼成形 + 启动进度
DeepSeek opening animation for DeepSeek Harness — the whale line-draw / signal-dots / fill /
wordmark intro, rendered as DSH Desktop's own launch screen, with the same animation available
as an opt-in full-screen client overlay (a plain DSH client plugin).
默认只放桌面版的启动画面那一次；进界面那次浮层是静音的（紧接着又放一遍读起来像卡带），
需要时一行配置就能让它回来。
同一套动画有两个落点，共用一份视觉源码（src/splash.css + assets/whale.svg）：
| 落点 | 载体 | 出现时机 |
|---|
| 启动画面 | DSH Desktop 自己的 resources/splash.html（由 tools/build_splash.py --apply 写入） | 双击图标、窗口刚出现就播；播完鲸鱼保持点亮，三颗信号点持续脉动当作加载指示，直到应用切到界面 |
| 界面开屏（默认静音） | 本插件的 shell.overlay 浮层（客户端半边） | 需要显式 opt in；开启后界面加载完成时整窗播放一次，约 2.8 秒 |
动画本身四拍：
- 描边：蓝色高光沿着鲸鱼轮廓逐段画出（
pathLength=1 + stroke-dashoffset），
屏幕与尾鳍同时被"勾"出来；
- 点灯：鲸鱼头顶的三颗信号点依次亮起并回弹，随后进入呼吸式脉动；
- 成形：填充自左向右涌入，白光扫过一遍，描边淡出，鲸鱼轻轻落定；
- 落款：
DeepSeek 字标上浮、深 度 求 索 副标淡入；
- 散场（仅界面开屏）：整幕淡出并卸载，把界面交还给应用。
深浅两套主题都跟随外壳（<html data-theme>：桌面版按 ?theme= 传进来，
GUI 里读外壳自己的主题），并尊重 prefers-reduced-motion（此时只保留一次极简淡入）。
交互
界面开屏（浮层，默认静音）：
启动画面已经在打开软件时放过同一段动画，紧接着进界面又放一遍，读起来是卡带而不是欢迎。
所以浮层默认什么都不渲染；确实想在 GUI 里也看到它时（在普通浏览器里打开界面、或者就是想看第二遍），
在页面里 opt in 一次即可：
window.__DSS_SPLASH__ = { overlay: true }; // 或 { disabled: false }
开启之后：
- 随时跳过：点击 / 触摸任意位置，或按任意键，立刻结束动画。
- 自动收场：无论动画是否被打断，CSS 都会在约 2.9 秒后把浮层淡出，
即使脚本异常也不会挡住界面。
- 只在首屏播放：同一标签页内的后续路由切换不会再放。
- 可见即播：窗口一旦可见就拉开帷幕，不要求窗口拿到焦点——桌面版
抬窗口时是"不抢焦点"的，等一次没人点的点击就等于永远不放。
启动画面（桌面版 splash）：
- 不可跳过：它背后还没有可以交还的界面，所以点击 / 按键都不会把它关掉。
- 一直亮着：鲸鱼成形后停在终态，三颗点继续脉动，直到应用把窗口切到界面。
- 启动进度：桌面版会把每一步写进
#progress（写一次就淡入一行），
标题与副标题沿用官方文案并跟随系统语言切中文。
桌面启动画面的安装与还原
python tools/build_splash.py --apply # 渲染并写入 DSH Desktop 的 resources/splash.html
python tools/build_splash.py --status # 看目标文件现在装的是哪一版
python tools/build_splash.py --restore # 还原官方页面
- 首次
--apply 会把官方页面原样备份成 splash.html.dsh-deepseek-splash.bak
（之后不会覆盖这份原版备份）。
- 应用更新会覆盖 splash.html：更新后重跑一次
--apply 即可，
用 --status 可以确认（ours: True/False）。
- 目标路径默认是
D:\deepseek\Data\DSH Desktop\resources\splash.html，
换机器或换安装目录时用 --target <路径> 指定。
- 页面完全自包含（内联样式 + 内联 SVG，无外部图片、无联网）。
预览
docs/preview.gif —— 整段动画的逐帧预览（20 帧）。assets/preview.html —— 免安装预览页，直接用浏览器打开即可；
地址栏加 #t=1300 可以停在动画的第 1300 毫秒。dist/splash.html —— 启动画面的渲染产物，也能直接用浏览器打开
（加 ?theme=light 看浅色）。
配置与诊断
页面里（控制台或 window.__DSS_SPLASH__）可以覆盖任意参数：
window.__DSS_SPLASH__ = {
overlay: true, // 界面开屏那次也放（默认静音，只在桌面启动画面放）
disabled: true, // 本次加载不放动画
holdMs: 2760, // 定格时长
title: "DeepSeek", // 主字标
subtitle: "深度求索", // 副标（给空串则隐藏）
hint: "点击任意位置跳过"
};
动画状态写在 <html data-dss-splash> 上：waiting（窗口还没可见，帷幕待命）、
playing（幕布放下）、done（已收场）、skipped（本次加载没有播放）。
样式表本身是 <style id="dss-splash-style">，两者都可以用来确认插件是否真的加载了。
启动画面里同样的东西挂在 window.__DSS_LAUNCH_SPLASH__。
测试
node tools/smoke_client.mjs # 客户端 bundle 的注册契约（13 项，含"默认静音"约定，无需浏览器）
python tools/build_splash.py # 渲染启动画面并校验外壳契约（#title/#status/#progress、无外链图片）
安装
插件是一个普通的 DSH 客户端插件包，装进某个 profile 即可：
# 直接从这个仓库装（npm 的 git 规格）
dsh plugin --profile web add "github:zmr234234-jpg/dsh-deepseek-splash"
# 或者先克隆，再按本地目录装（link: 规格）
git clone https://github.com/zmr234234-jpg/dsh-deepseek-splash
dsh plugin --profile web add "link:/绝对/路径/dsh-deepseek-splash"
DSH Desktop 里也可以直接用插件管理装本地目录（不依赖 CLI）。
装完刷新界面即可（客户端 bundle 在页面加载时注入）；
桌面启动画面那半还需要额外跑一次 tools/build_splash.py --apply，见上。
结构
package.json dsh.bundle.patch + dsh.client.platform=web
cordis.patch.yml 宿主插件行（id: deepseek-splash）
lib/index.js 宿主半边：空实现（无服务、无工具、无文件访问）
lib/client.js 客户端半边（构建产物，勿手改）
src/splash.css 视觉与时间轴（全部动画都在这里）
src/splash.js 标记生成 / 主题读取 / 跳过与收场（两个落点共用）
src/overlay.js 极小的 React 挂载层（shell.overlay 插槽、默认静音开关、可见性把关）
src/desktop-splash.html 启动画面页面模板
src/desktop-splash.css 启动画面的外壳样式（背景、启动信息块）
src/desktop-splash.js 启动画面引导（不可跳过、长驻、复用同一套动画）
assets/whale.svg 鲸鱼矢量图（由 tools/trace_whale.py 从官方图标描出）
assets/preview.html 免安装预览页（用浏览器直接打开）
dist/splash.html 启动画面渲染产物
tools/ 素材与构建脚本
重新构建
python tools/trace_whale.py # 官方 icon.png -> assets/whale.svg
python tools/build_client.py # src/* -> lib/client.js + assets/preview.html
python tools/build_splash.py --apply # src/desktop-splash.* -> 桌面版启动画面
说明
插件本身不改动宿主、不写任何文件、不联网；它只注册一个 shell.overlay 插槽，
而浮层默认不渲染任何东西（动画在桌面启动画面里放），插件侧的开销为零。
唯一的例外是显式执行
tools/build_splash.py --apply 时对 resources/splash.html 的替换，原文件会留下备份，
--restore 可以随时还原。
License
MIT © 2026 zmr234234-jpg
