开机动画 456erddgr/dsh-boo550wt-animation

dsh-boo550wt-animation

给 DeepSeek Harness 加一段开机动画：打开 DSH 时全屏展示一段内容，播完（或者按 Esc）才进入界面。

支持四种模式，全部可以在设置面板里改：

| 模式 | 内容 | 结束方式 |
| video | 视频（默认：自带的 550W 风格动画，16.6 秒） | 播完自动进入 |
| image | 图片 | 显示 durationMs 后进入 |
| web | 网页（URL 或本地 HTML 文件） | 页面发完成消息，或超时 |
| game | 内置内容（两部流浪地球 3D 讲解 + 五款小游戏） | 通关 / 讲完自动进入 |

素材来源有两条路：直接上传（设置面板里点选或拖入文件，存进插件自己的目录），或填绝对路径指向你已有的文件。视频默认带声音播放。

内置内容

| 内容 | 玩法 | 结束方式 |
| 贪吃蛇 | 方向键 / WASD 吃豆子 | 吃满 30 个 |
| 2048 | 方向键 / WASD 合并数字 | 拼出 2048 |
| 打砖块 | ← → 移动挡板接球 | 清空全部砖块 |
| 记忆翻牌 | 点击翻牌配对 | 8 组全部配对 |
| 打字冲刺 | 照抄单词回车提交 | 完成 12 个 |
| 流浪地球 · 行星发动机计划（3D 第一部） | 自动播放讲解运镜，鼠标接管自由查看 | 讲完自动进入，或随时 Esc |
| 流浪地球 2.0 · 从发动机到银河（3D 第二部） | 同一套底座的六章长片，可从 100 km 拉到银河 | 讲完自动进入，或随时 Esc |

跳过永远可用：按 Esc，或点右下角的「跳过」按钮。内容跑在 iframe 里会吃掉键盘，所以每一项都内置了把 Esc 转发给宿主页面的中继；右下角那个是真正的按钮，可以点。

流浪地球讲解（3D，两部）

接入开源项目 oxomkbk/earth-migration（MIT 协议）——基于 three.js r160 的电影级 WebGL 场景：真实地球贴图、云层、行星发动机群、赤道转向阵列、太空电梯、同步轨道环、护航舰队、太阳系、星际空间与银河系。整套 three.js、贴图、模型和行星数据库内置在插件里（vendor/earth-migration/，约 34 MB），不联网、不依赖 CDN。

内置两条 3D 讲解，都能在设置里选：

| 名称 | 内容 | 时长 |
| 流浪地球 · 行星发动机计划（第一部） | 地球轨道尺度的六幕：点火、刹车、太空电梯、木星弹弓、长夜 | 1 分 02 秒 |
| 流浪地球 2.0 · 从发动机到银河（第二部） | 从 100 km 一路拉到 10 万光年：行星 → 太阳系 → 日球层顶 → 星际 → 银河 → 半人马座 α | 2 分 54 秒 |

第一部 开机时自动播放一段 62 秒的中文讲解，六个章节依次推进，镜头由原项目的导演系统驱动：

| 章节 | 时间轴 | 讲什么 |
| 01 太阳的黄昏 | 2061 | 太阳步入晚年，联合政府决定带走地球 |
| 02 点火 | 纪元 0 年 | 一万两千米高的发动机，一万两千座同时点火 |
| 03 让地球自转停下 | 纪元 0 年 · 第三天 | 赤道转向发动机让 4.5 亿年来第一次停转 |
| 04 太空电梯 | 纪元 1 年 | 三万六千公里到同步轨道，终点天枢中枢 |
| 05 木星引力弹弓 | 纪元 17 年 | 借木星引力完成最后一脚 |
| 06 两千年长夜 | 纪元 2500 年 | 地表封冻，目标四光年外的比邻星 |

随时接管：动一下鼠标（或触摸、滚轮）就切到自由查看 —— OrbitControls 已配好阻尼、缩放和光标跟随缩放，可以拖动转圈、滚轮放大缩小、右键平移。想回到讲解只需重启。右下角始终有「跳过」。

第二部 是同一个底座上的另一部片子：不再只停在地球轨道，一路拉到银河系。六章：

| 章节 | 时间轴 | 讲什么 |
| 01 流浪的地球 | 2078 年 | 一万台聚变发动机点火的全球点火序列 |
| 02 太阳系 | 2079—2093 年 | 穿过行星轨道，木星弹弓、土星环 |
| 03 越过外行星 | 2101—2156 年 | 海王星、柯伊伯带、日球层顶 |
| 04 星际航行 | 2160—2580 年 | 星际介质里的弓形激波，一百代人的冰封天空 |
| 05 银河系 | — | 从几光年的航线拉到 10 万光年的银河系 |
| 06 新的太阳 | 4578 年 | 半人马座 α，冰原上第一缕日光 |

它自带三层对数尺度（行星 63.7 km → 天文单位 → 光年），自由查看时滚动就是穿越尺度，可以从 100 km 一直拉到银河系；25 个目的地可以点选飞抵。

第二部的状态栏是原项目那套，一条都没删：左侧 PROPULSION（推力、发动机阵列矩阵、等离子体核心、赤道配平、地表均温、磁层）、右侧 NAVIGATION（速度、对数航迹图、距离/光行时/到达时间/航向/区域、光学、事件日志）、顶部 MISSION STRIP（船时、阶段/章节进度、链路延迟），以及底部章节条与右下角模式按钮。

入口与出口：讲解进行中点右上 EXPLORE 或按 F 才切自由查看；回到讲解点 FILM 或再按 F。鼠标移动不会打断讲解 —— 早先版本是「一动鼠标就切自由相机」，那会把解说当场吞掉，已经改掉。

音乐：第二部不再用上游的程序化合成配乐，改为播放内置的一首录音（assets/audio/theme.m4a，7 分 05 秒，循环，音量压在解说之下）。Electron 允许无手势自动播放；普通浏览器若拒绝，页面会提示「点击画面任意处开启声音」，点一下即恢复。

这条路由必须给 两样东西，缺一样就哑：audio/mp4 这个 MIME（早先回落成 application/octet-stream，浏览器根本不认），以及 Range 支持（早先整份 10 MB 一口气倒出去、无视 bytes=0-，媒体元素拿到 200 就中止加载）。现在目录型场景的静态服务和视频路由共用同一个 parseRange，200 / 206 / 416 三种情形一致。

字幕与进度用真实时间驱动，而不是帧累计：渲染被节流或机器较慢时，讲解不会变成慢放。

打开 DSH ─▶ 黑底 + 动画 ─▶ 播完 / 讲完 / 按 Esc ─▶ 淡出 ─▶ 正常界面

关键在于交接时机：遮罩在 DSH 结算「启动就绪」之前就已经挂上去了，所以应用是在遮罩底下正常渲染的，等动画结束再把界面让出来 —— 而不是先看到界面再盖一层。

效果预览

自带素材的分镜（2.0s / 6.0s / 12.0s / 15.0s）：

开机动画分镜：550W 标志、量子计算机控制系统、剩余进度 69%、剩余进度 100%

真实播放时的样子 —— 画面铺满窗口，右下角在 4 秒后浮现跳过提示：

实际播放画面，右下角显示「按 Esc 跳过」

流浪地球讲解（自动运镜 + 自由查看）

开机自动播放第一段讲解 —— 第二章「点火」，字幕正在说一万两千座发动机同时点燃：

第二章 点火：一万两千座发动机自赤道点火

第四章「太空电梯」，镜头贴着发动机基座群仰拍，字幕讲天枢中枢空间站：

第四章 太空电梯：发动机基座群与天枢中枢

动一下鼠标就交给自由查看 —— 地球夜景、太阳、护航舰队，可以拖动转圈、滚轮缩放：

自由查看：拖动旋转后的地球与舰队

第二部 的开场：全球点火序列，一万台发动机在背光半球逐个亮起 —— 左侧 PROPULSION、右侧 NAVIGATION、顶部 MISSION STRIP、底部章节条，都是原项目那整套状态栏：

第二部开场：全球点火序列，状态栏完整保留

第五章拉到银河系尺度 —— 回头再看，整段航程只是几光年长的一条线：

第二部第五章：银河系视角，整段航程缩成一条线

这几张图都是修完之后重拍的。早先第一部拍出来是「一盏灯照在黑球上」、发动机只剩剪影 —— 原因不是模型不行：目录型场景到达时少了末尾斜杠，页面里所有 assets/... 相对路径都解析高了一级，25 个贴图与模型全部 404。现在 /game/<id> 会 308 跳到 /game/<id>/，云层、大陆、夜景灯光、发动机光柱才是它真实的样子。

五款小游戏

| 贪吃蛇 | 2048 |
| 贪吃蛇：吃到豆子后蛇身变长 | 2048：滑动合并数字 |

| 打砖块 | 记忆翻牌 |
| 打砖块：挡板与彩色砖块 | 记忆翻牌：翻开的牌面 |

打字冲刺 —— 照抄单词回车提交：

打字冲刺：目标词与已输入的单词

截图都是从真实运行里截的，不是效果图：经插件的路由服务页面，用 Chromium 采集 WebGL 与 DOM 画面（tools/browser-check.mjs --shot=、tools/screenshots.mjs）。

怎么用

1. 装

DSH 的插件用它自己的命令行安装（desktop 是保留配置档，由 Electron 应用托管）：

先拿到仓库
git clone https://github.com/456erddgr/dsh-boo550wt-animation.git

再用 DSH 自带的命令行装进 desktop 配置档 $env:ELECTRON_RUN_AS_NODE = '1' & "<你的安装目录>\DeepSeek Harness.exe" --expose-internals "<你的安装目录>\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js" plugin --profile desktop add "<clone 出来的目录>"

<你的安装目录> 默认是 %LOCALAPPDATA%\Programs\DeepSeek Harness。

这条命令会做三件事：加一条 link: 依赖、在 node_modules 里建好入口、把 bundle 追加进 dsh.profile.bundles。

add 底层是 pnpm，所以也接受 git 形式： plugin --profile desktop add github:456erddgr/dsh-boo550wt-animation

2. 重启 DSH

必须重启。 Host 半侧的代码只在 DSH 启动时被 import 一次，热更新不会加载它。设置面板的修改在重启后生效。

3. 在设置里改开机动画

重启后，打开 设置 → 开机动画，可以改：

- 类型：视频 / 图片 / 网页 / 内置 3D（四张卡片直接点选）
- 内置 3D：七项内容的按钮网格 —— 两部流浪地球 3D 讲解 + 五款小游戏，点一下切换
- 素材：在虚线框里点击选择或拖入文件，上传后自动选中；也能看到已上传列表、点一下切换、点 × 删除
- 路径兜底：不想上传就填绝对路径，指向你已有的文件
- 网页地址：填 URL，或本地 HTML 文件绝对路径
- 播放声音：视频模式的开关，默认开（浏览器拒绝自动播放时自动退回静音并提示点一下开启声音）
- 显示时长 / 硬上限 / 淡出 / 提示延迟 / 跳过提示文字
- 全屏预览：不用保存、不用重启，直接把屏上这份设置拿去跑真正的开机遮罩 —— 视频、图片、网页、小游戏、两部 3D 讲解都能预览；按 Esc 或点「跳过」结束，不改配置
- 恢复默认：一键还原所有参数（不会删已上传的素材）

全屏预览走的是一条自己的路由 /boot-animation/preview?c=<设置>：它由 Host 用与真实开机同一份注入脚本、同一份样式、同一套媒体路由渲染成文档，只把「要显示什么」换成 URL 里带来的那份设置。所以预览看到的就是开机时会看到的，而不是面板里仿造的一个近似品。

上传的文件存在 ~/.dsh/boot-animation-uploads/，设置存在 ~/.dsh/boot-animation-settings.json。改完点保存，下次启动生效。

上传的几个细节（照 wallpaper-engine 的做法）：
- 流式落盘：边收边写 .tmp，完成后 rename 发布，不会把整个文件缓冲进内存（上限 512 MB）
- 内容去重：同一份文件再传一次不会堆副本，直接返回已有条目
- 中途断开清理：关标签页/断网会清掉 .tmp，不留残file
- 路径穿越防护：只认 up- 开头的自生成文件名，../ 之类的请求一律 404

4. 跳过 / 卸载

- 跳过：随时按 Esc，或点右下角「跳过」按钮。小游戏和网页模式下按钮立即出现（它们的 iframe 会吃掉键盘，按钮是唯一可靠出口）；视频模式下按钮延迟 4 秒出现，免得打断片头。
- 声音：视频默认带声音播放；如果引擎拒绝对自动播放，会自动退回静音并在角上提示「点击开启声音」，点一下即可恢复。
- 兜底：内容解不开时，遮罩 0.9 秒后放弃；任何情况下都有 maxSeconds 硬上限。遮罩里只有一个硬上限计时器：注入行给的那份只是开机瞬间的兜底，读到 /config 和媒体元数据后都会重新装表，且重装前一定先取消旧表。
- 卸载：

plugin --profile desktop remove dsh-boo550wt-animation

原理

这个插件是 Host-only + 浏览器设置面板：

1. webserver/index-inject 注入行 —— 一条 style、一条 body script。DSH 会把注入行应用到页面上，时机早于 __DSH_BOOT_READY__ 结算、也早于客户端模块加载器启动，这正是遮罩能成为屏幕上第一个东西的原因。脚本启动时拉一次 /config，用你最新保存的设置来决定显示什么。
2. /boot-animation 下的路由 —— 带 Range、HEAD、416 处理，交给浏览器自己的媒体栈去解码；配置、图片、视频、网页、内置内容、上传的素材都是经同一套路由提供的。
3. /boot-animation/preview 路由 —— 设置面板的「全屏预览」用的就是这个。Host 用同一个 bootScript()、同一份 BOOT_STYLE 渲染出一个独立文档，把 URL 里带来的那份未保存设置作为种子（preview: true 让它跳过 /config，播完回一条 __bootPreviewDone 让面板收框）。它不会写设置文件。
4. 设置面板 —— 通过 settings.section slot 挂进 DSH 设置界面（和 dsh-better-sidebar 等插件同一套契约），读写同一份 /config，并管理上传目录。

客户端脚本是把一个真函数 toString() 出来的（lib/inject.js），所以注入的 JavaScript 是当普通源码被解析和检查的，也保证不含尖括号和 </script。

自检工具

| 命令 | 能证明什么 |
| node tools/selftest.mjs | 配置读写、注入行、硬上限重装必须取消旧表、Range 服务（视频+图片+配乐 m4a 的 206/416）、七项内置内容与中继、目录游戏的末尾斜杠跳转、贴图真实可达、预览路由不落盘、上传/去重/删除/穿越防护、路由与状态码 —— 61 项 |
| node tools/browser-check.mjs | 真实 Chromium 里：视频（含声音未被静音）/图片/网页/内置 3D 四种模式、跳过按钮可点、iframe 内 Esc 能转发、七项内容逐个加载（含两部 3D 场景）、预览路由用 URL 里的设置挂载真遮罩并回报完成 —— 21 项 |
| node tools/screenshots.mjs <绝对路径>/lib/games.js <输出目录> | 经插件真实路由逐项截图，含两部 3D 场景；每张都开一个干净浏览器，避免 WebGL 上下文串味 |
| ELECTRON_RUN_AS_NODE=1 <DeepSeek Harness.exe> --expose-internals tools/verify-install.mjs | 用 DSH 自己的 profile 加载器验证：bundle 被组合进去了（loaded 而不是 skipped），Host 入口能解析 |

说明与限制

- 视频的 moov atom 在文件尾部，所以首帧之前浏览器要把整个 12 MB 抓下来；走 loopback 基本无感。素材如果真的变大，用 -movflags +faststart 重新封装就能消掉这个等待。
- 声音：视频默认带声播放（Electron 允许无手势自动播放）。Web 端浏览器可能拒绝有声自动播放，此时插件自动退回静音并在角上提示，点一下即可带声重来。也可在设置里直接关掉「播放声音」。
- 跳过和硬上限是刻意的设计：开机动画永远不应该有能力锁死窗口。
- 遮罩追加到 body，从不碰 #root，所以 React 的挂载点不受影响；拆除时它会连同自己的监听器和定时器一起收干净。
- web 模式加载的是你给的网页：如果你在设置里填了外网 URL，开机时 DSH 会去访问它。这是有意为之的能力，不是默认行为（默认是视频）。
- 上传目录没有配额限制，超大视频会占磁盘；不用了请在设置面板里点 × 删除。
- assets/boot.mp4 与本仓库的示例素材只作 550W 风味参考，与《流浪地球》官方无关。如果要公开分发本仓库，请自行确认你对该素材拥有相应权利。