dsh-plugin-bootanim
给 DeepSeek Harness 的 Web GUI / 桌面客户端加一段开机动画：
- 打开 DSH 时播放你选的那一条视频
- 刷新页面不会重播（同一次会话只播一次）
- 在「设置 → 插件」里直接换片、上传自己的视频、删除
- 不改 DSH 源码，纯官方钩子
安装
要求 DSH >= 0.2.0-rc.2（桌面版和 Web 版的插件系统都在这个范围内）。
-
打开侧边栏 插件 → 添加插件
-
填入包名：
dsh-plugin-bootanim
-
安装完成后打开开关启用
-
完全退出并重启客户端（插件树是启动时读的，刷新页面不算）
首次安装会并行探测 npmjs 与 npmmirror，国内网络会自动选镜像。依赖会一并安装好，不需要额外操作。
也可以填 Git 仓库地址或本地目录：
# Git
git+https://github.com/Gqwu01/dsh-plugin-bootanim.git
# 本地目录（需先在该目录执行过一次 pnpm install，否则依赖缺失）
C:\path\to\dsh-plugin-bootanim
用法
重启后打开侧边栏的 插件 页，点进本插件，配置区就在描述下方：
| 控件 | 说明 |
|---|
| 启用开机动画 | 总开关。关掉则不注入任何东西，回到内核自己的启动页 |
| 播放的视频 | 下拉选择。自动 表示用最近改动过的一条素材 |
| 上传… | 导入本地 mp4 / webm / m4v / mov，上限 256MB |
| 删除 | 只能删你自己上传的，内置素材不可删 |
| 同一个标签页只播一次 | 默认开。关掉则每次刷新都播 |
| 必须点击才进入 | 默认关。开启后片子放完也停在最后一帧，等你点 |
播放中可以随时 点击 / Esc / 空格 / 回车 立即进入。
素材放哪
- 内置素材：本包的
assets/videos/
- 你上传的素材：
<DSH profile>/data/dsh-plugin-bootanim/videos/
升级插件不会覆盖你上传的视频——它们在 profile 数据目录里，不在 node_modules 里。
设置项（cordis.patch.yml 里也可手写）
- id: bootanim
config:
enabled: true
clip: 'custom/xxxx_my-intro.mp4'
fadeMs: 800
playOnce: true
clickToEnter: false
所有字段都是 volatile：改完立即生效，不需要重启。
它是怎么工作的
- 宿主半区注册三条路由：素材清单、素材本体（支持 HTTP Range）、上传。
- 每次渲染
index.html 时，把「选中素材的 URL + 配置」写成一段全局变量，并把
src/boot-screen.js 的原文内联进 <head>。脚本在 React 挂载之前执行。
- 脚本自己建一层全屏遮罩并播放视频；浏览器半区在内核就绪时调
globalThis.__DBV__.clientReady()。
- 放行条件是「片子放完」且「内核就绪」，避免露出半成品界面；
另有 12 秒硬兜底，任何异常都会立即放行。
安全边界
- 不读取会话内容、不接触模型数据
- 没有任何对外网络请求
- 上传 / 删除只接受本机回环地址发起
- 素材路径做单层 + 扩展名 + 目录包含三重校验
开发
# 直接链接进 profile 调试，不用发包
cd <你的 profile 目录>
pnpm add link:<本仓库路径>
- 改
src/boot-screen.js：刷新页面即可生效（每次 index 渲染重读）
- 改
entry.js / lib/client.js：需要重启宿主
许可
MIT
