视频开机片头 xufu5438-netizen/dsh-boot-video

dsh-boot-video

给 DeepSeek Harness（DSH）加一段视频开机片头。 启动客户端时全屏播放你的 mp4，播完淡出、露出真正的界面；点击画面或按 Esc 随时跳过。

Full-screen video boot splash for DSH.

桌面版实机预览：视频铺满窗口，左下角「打开声音」、右下角「点击画面跳过」

特性

- 🎬 一段 mp4 = 一次开机片头：全屏播放，播完淡出进界面，不是"加载完成就切走"
- ⏭️ 随时跳过：点击画面或按 Esc
- 🔊 桌面版直接带着声音播出（Electron 默认允许未静音自动播放）；网页版会被浏览器拦下，于是自动降级成静音并亮出「打开声音」按钮（点它只开声、不跳过）
- 🖥️ 盖住 DSH 自己的开机卡片：首帧由宿主半边在文档解析阶段注入，HARNESS / Loading plugins… 不会露脸
- 🔀 不跟别的片头插件打架：各写自己的 localStorage 键，同时装也不会互相干扰
- 🖼️ 不裁画面：始终按完整比例居中显示；片源自带的那圈黑边在压制素材时就裁掉了
- 📦 零运行时依赖：宿主半边只用 node: 内建模块，浏览器半边只有一条
- ⚙️ 设置单开一页：设置侧边栏里的「开机动画」，开关 / 素材 / 预览都在那儿，不挤在「通用设置」里
- 🩺 自检行：设置页底部写着"客户端半边是什么时候加载的、上次开机到底播成功没有"——改了没生效 / 视频打不开，看一眼就知道
- 🔄 导入的视频会自动转码：解不了的编码（典型是 HEVC / H.265）不用你自己动手转——插件自己下 ffmpeg（国内镜像）转成 H.264 再收下，转完先验一遍能不能播

安装

从 npm 安装（推荐）
dsh plugin --profile web add dsh-boot-video

从 GitHub 安装（仓库带构建产物，没有安装期脚本，不触发构建授权）
dsh plugin --profile web add github:xufu5438-netizen/dsh-boot-video

或从本地目录安装（把路径换成你解压出来的目录）
dsh plugin --profile web add <本目录绝对路径>

装完必须重启一次 DSH（bundle 在启动时装配），然后 Ctrl+Shift+R 硬刷新—— DSH 的客户端 bundle 带 max-age=31536000, immutable，普通 F5 会一直用第一次抓到的副本。

桌面版（Electron）：也可以在应用里走「设置 → 插件 → 添加插件」贴本目录路径（插件管理器原生支持本地路径 / registry / git / tarball 四种 spec）。桌面版的 index 注入表在宿主启动时收集一次，所以那里装完必须完全退出并重新打开，刷新页面不够。

卸载

命令行装的
dsh plugin --profile web remove dsh-boot-video

桌面版在「设置 → 插件」里点卸载即可。卸载后开机会恢复成 DSH 自己的启动画面——本插件不留下任何全局改动（只写自己那几个 localStorage 键；想彻底还原则在控制台删掉 dsh-boot-video:source / dsh-boot-video:asset / dsh-boot-video:last-boot 三个键）。

自己打"发布包"（只带已授权的那段）

npm run pack:release

它会临时把「月读世界」那段从包内容里排除、打完立刻还原清单，并核对包里到底有什么 （一旦混进没授权的素材，它会删掉包并以非零码退出）。当前结果：11.37 MB，只含 assets/hdd.mp4 + 代码 + 一张预览图。

使用

设置 → 侧边栏「开机动画」（0.3.0 起是独立一页，不再挂在「通用设置」里）：

| 控件 | 档位 | 效果 |
| 启动时播放 | 我的视频（默认） | 启动时全屏播一短片头，播完淡出进界面 |
| | 不播放 | 启动直通界面（想恢复：设置页里点回「我的视频」，或在控制台删掉 localStorage['dsh-boot-video:source']） |
| 片头素材 | HDD（默认） | assets/hdd.mp4，10.47 MB |
| | 月读世界 | assets/yuedu.mp4，29.01 MB，4K/60fps 重压（CRF 24、PSNR 46.2 dB，肉眼无差） |
| 导入自己的视频 | ⬆ 导入视频 | 挑一段你自己的 mp4（上限 512 MB），存进插件的 assets/user/，以后随时能选、能删 |
| 预览 | ▶ 播放一遍 | 不重启就看看效果；正在播时点它会从头重播 |

换素材会立刻用新素材重播一遍——不用为了确认换了没有去重启。

导入自己的视频（0.8.0 起默认开启）

点「⬆ 导入视频」挑一段 mp4，它会被原样存进插件的 assets/user/（不转码、不重封装——导进去什么样，播出来什么样），然后自动选上、播一遍，并弹出起名窗口。这是本插件的主功能之一；不想让插件能写盘的话，跑 DSH 时设 DSHBV_IMPORT=0 就能把它关掉（客户端那侧对应 IMPORT_ENABLED）。

- 素材带里点它 = 换成它；旁边的小「×」= 从插件里删掉这一份（你自己的原片不受影响）
- 下面的「我导入的视频」列表负责「改名」与「删除」；改名只改显示名（磁盘文件名不动），留空 = 回到原始文件名
- 网页版与桌面版都能导，插件内部走的是两条路：
- 网页版：文件本体流式传给 DSH（带进度条），宿主边收边写盘
- 桌面版：Electron 能把「你刚选的那个文件」翻成绝对路径，于是宿主直接复制，几百 MB 也很快；这条路不通（旧版 Electron / 跨盘 / 没权限）会自动回退到上传那条
- 想手动清也可以：直接删掉 assets/user/ 里那几个 u-*.mp4（清单是按目录推导的，不会留残影）；自定义名字在同目录的 labels.json 里，删掉它就全回到原始文件名
- 导入的内容只在你机器上：发布包里没有别人的视频，别人导入的也不会传到你这儿

⚠️ 只收 mp4；编码不支持的会自动转码

导入只认 .mp4（不是 mp4 会在选择器与本地校验那里就拦住）。至于「里面是什么编码」—— 不用你操心：

| 你手上的文件 | 会发生什么 |
| .mp4 + H.264（剪映/手机导出、B 站下载的常见形态） | ✅ 直接导入 |
| .mp4 + HEVC（不少「4K 片源」） | 🔄 导入时会问一句「要不要自动转换」，点一下插件自己把 ffmpeg 下下来（约 28MB，国内镜像）转成 H.264，转完自动收进素材列表 |
| 其它容器（.mkv / .webm / .mov） | ❌ 被拒；先剪成 mp4（剪映导出选 mp4 + H.264 最省事） |
| 不是视频的文件 | ❌ 被拒（「没找到视频轨」） |

转码用的是 libx264 -crf 20、保持原分辨率与帧率、音频 AAC 192k、+faststart；转完插件自己先验一遍能不能播才收下。命令行等价物（不想用界面时）：

node scripts/import-hevc.mjs "D:\视频素材\你的母带.mkv"

⚠️ 导入的视频就在插件文件夹里，所以重装/升级插件时可能被覆盖——重装前先把 assets/user/ 里那几个文件挪出去，装完再放回来。

画面不做裁切：始终按完整比例居中显示。窗口比例与片子比例不一致时上下（或左右）会留黑边——这是「保留全部画面」的代价。片源自带的那圈黑边已经在压制素材时裁掉了，剩下的黑边只是比例差。

曾经做过「铺满 / 完整」两档，看过两档之后决定删掉「铺满」：16:9 窗口播一条 2.35:1 的片子，铺满要裁掉左右各约 12%，那是画面少了一块，不是更饱满。

- 桌面版（Electron）自动带声音播放；网页版浏览器会拦未静音自动播放，于是自动降级静音、左下角亮出「打开声音」按钮（点它只开声，不跳过）。同一份代码，两边各得其所。

想让网页版也自动带声音？

做不到由插件说了算——网页里的 JS 绕不过浏览器的自动播放策略，只有 Electron 这种「自己就是浏览器」的宿主能设 no-user-gesture-required。但可以手动给这个站点开声音白名单，开完插件一个字都不用改（它本来就是「先试带声、被拒才降级」）：

| 浏览器 | 操作 |
| Chrome / Edge（推荐，不用手输网址） | 在 DSH 页面上点地址栏左边的站点图标 → 「网站设置」→ 找到「声音」→ 改成允许 → 硬刷新 |
| Chrome | chrome://settings/content/sound → 「允许播放声音」→ 添加 http://127.0.0.1:3080 |
| Edge | edge://settings/content/sound → 「允许播放声音」→ 添加；或在 edge://settings/content/mediaAutoplay 里把「媒体自动播放」设为允许（这一条是全局放宽，所有网站都会自动放声，不如前两个精准） |

生效后硬刷新页面，播放时左下角的「🔊 打开声音」按钮不再出现，就是已经在自动带声播了（地址要写全，别漏端口）。
- 点击画面 / 按 Esc 跳过，跳过后仍然走同一段淡出，不会硬切
- 每次客户端加载都会播（刷新页面也算）
- 播放期不会等待 DSH 的加载状态：播完就淡出，无论应用早就绪还是在加载

换成你自己的视频

node scripts/make-asset.mjs <你的母带.mp4> --height 1440 --crf 22

片源自带的黑边要在这一步裁掉，播放器再怎么 object-fit 也去不掉「画出来的黑边」。
先用 ffmpeg -vf cropdetect=24:16:0 -f null - 看出黑边高度，再传给 --crop：

node scripts/make-asset.mjs <你的母带.mp4> --crop 2560:1086:0:177 --crf 22

脚本用 devDependency @ffmpeg-installer/ffmpeg（纯 npm 包，国内镜像可装，不需要访问 GitHub）把母带转成 H.264 + AAC + yuv420p + faststart 的 mp4：浏览器与 Electron 都能直接播，体积通常压到 5–10 MB。

也可以直接手工替换 assets/hdd.mp4，只要满足：

| 项 | 要求 |
| 容器/编码 | .mp4，H.264 视频 + AAC 音频（H.265/HEVC 在 Chromium 里多半放不出） |
| 体积 | 建议 ≤ 15 MB（这个文件要随包分发，别人下载的是它） |
| 时长 | 建议 ≤ 20 秒，且一定要能跳过 |
| 分辨率 | 1080p/1440p 都行，播放时按 object-fit: contain 等比铺满 |

兼容与限制

- 要求 DSH >= 0.2.0-rc.1（package.json#dsh.engines）：宿主半边依赖 webserver/index-inject 的行渲染行为与 webServer.register 的原始 (req, res) 契约
- 只能在 Web UI 加载之后覆盖全屏，做不到早于 Electron 窗口首帧（窗口本身仍有一瞬间空白）
- 首帧是一块纯色（#000000），不是视频的第一帧画面——它只负责在插件求值前占住屏幕
- 网页版不可能自动播放还带声音：浏览器拦未静音自动播放，只能静音起步、点一下开声
- 视频文件随包走（不是内联 base64），由宿主路由流式返回，支持 Range / 206 / 304

素材与许可

代码 MIT。

内置素材分两段，授权状态不同，发布包只带第一段：

| 素材 | 来源 | 状态 |
| assets/hdd.mp4（HDD 开机动画） | B 站 UP 主 @露霁luki_yo 的《Hollow Deep Dive System》(HDD) | ✅ 已获作者授权，可随包分发 |
| assets/yuedu.mp4（欢迎来到月读世界） | 从电影片段剪出的几秒 | ⛔ 未获授权——只在本机自用，不进发布包 |

所以对外发布的那份只有 HDD 一段（用 npm run pack:release 打，见下）。
yuedu.mp4 不在仓库里，你自己那份请保留在 assets/，本地两段都能用。

文档

| 文档 | 内容 |
| 视频开屏方案.md | 立项方案：路线对比、素材实测、限制清单（本机文档，不在仓库内） |
| CHANGELOG.md | 版本记录 |

致谢

- HDD 开机动画素材由 B 站 UP 主 @露霁luki_yo 授权提供——《Hollow Deep Dive System》(HDD) 是他的作品，插件内置的那段片头就是它（压缩与裁边见 scripts/make-asset.mjs）。
- 首帧抢屏与"盖住开机卡片"的做法，最初由 dsh-550c-boot （Ziyang Song / Voidpoket）验证并记录；本插件沿用同一套宿主契约。

MIT