启动画面序列 gxz19940730-blip/dsh-boot-sequence-NICE

dsh-boot-sequence-nice

| English

给 DeepSeek Harness（DSH）的可配置启动序列：在应用 UI 之前铺一层全屏画面，按你配置的顺序播放视频/图片，最后黑场收尾、让界面缓缓亮起。

默认抽象底

- 只有宿主半边，不注册客户端条目
- 首帧早于应用 UI（查询期注入 ）
- 只动 opacity / transform，不触发布局
- 随时可跳过；支持 prefers-reduced-motion；跑完把节点和样式拆干净
- 不附带任何第三方美术资源：默认底是 CSS 生成的抽象画面，视频/图片由你自己放进 media/

安装

从 GitHub 安装（推荐，不需要 npm 账号）：

跟随最新提交
dsh plugin --profile desktop add github:gxz19940730-blip/dsh-boot-sequence-NICE

或锁定版本
dsh plugin --profile desktop add github:gxz19940730-blip/dsh-boot-sequence-NICE#v0.1.0

本地开发：

dsh plugin --profile desktop add file:<本仓库绝对路径>

国内网络直连 GitHub 常常失败。装之前先给 git 配代理，例如：
git config --global http.https://github.com/.proxy http://127.0.0.1:7890

npm 版本（可选，发布后可用）：dsh plugin --profile desktop add dsh-boot-sequence-nice

配置

插件根目录的 boot.config.json，改完刷新页面即可（宿主按配置签名自动重新合成，无需重启）。

{
"mediaBase": "/dsh-boot-sequence-nice/media",
"fadeMs": 600,
"minShowMs": 1200,
"oncePerSession": false,
"skip": { "click": true, "keys": ["Escape", " ", "Enter"] },
"ending": { "blackoutMs": 450, "holdMs": 250, "revealMs": 900 },
"phases": [
{ "type": "video", "src": "intro.mp4", "fit": "cover", "duration": 12000 },
{ "type": "image", "src": "keyart.jpg", "duration": 1500 },
{ "type": "blank", "duration": 600 }
],
"brand": { "show": false, "text": "DEEPSEEK HARNESS" },
"hint": "点击或按 Esc 跳过" }

字段

| 字段 | 默认 | 说明 |
| phases | [{type:"blank",duration:1400}] | 播放顺序；type 为 video / image / blank |
| phases[].src | — | 相对 media/ 的文件名；也接受 / 或 http(s) 开头的绝对地址 |
| phases[].fit | cover | cover 铺满 / contain 完整显示 |
| phases[].duration | 视频 30s 上限，图片 2400ms | 单段时长；视频默认播到 ended，duration 是硬上限 |
| fadeMs | 600 | 段间交叉淡化 |
| minShowMs | 1200 | 最短展示时间，避免一闪而过 |
| oncePerSession | false | 同一标签页只播一次（sessionStorage） |
| skip.click / skip.keys | true / Esc Space Enter | 跳过方式；click:false 可关闭点击跳过 |
| ending.blackoutMs | 450 | 结束前淡到纯黑的时长 |
| ending.holdMs | 250 | 黑场停留 |
| ending.revealMs | 900 | 整层淡出、界面亮起的时长 |
| brand | 关闭 | 左下角可选文字行 |
| hint | 空 | 右下角跳过提示文案 |

媒体

media/
intro.mp4 # 你自己的视频 keyart.jpg # 你自己的图片

- 支持 mp4/webm/mov、jpg/png/webp/avif/gif
- 由 /dsh-boot-sequence-nice/media/<name> 提供，支持 HTTP Range（视频可拖动、可流式播放）
- 查找顺序：插件的 media/ → ~/.dsh/boot-sequence-media/（推荐放这里，重装插件不会丢）
- 路径做了目录逃逸校验，只能读这两个目录下的文件
- 视频建议 -movflags +faststart，让 moov 在文件头，首帧更快

诊断

GET /dsh-boot-sequence-nice/health
→ {"ok":true,"plugin":"dsh-boot-sequence-nice","version":"0.1.0","phases":["video","image"],"screenBytes":...}

自检 / 预览

node tools/selftest.mjs # mock ctx：注入、健康检查、媒体路由（200/206/越权 404）
node tools/preview.mjs # 生成 dist/preview.html，浏览器直接看

设计取舍

- 不做生成物：screen.css + runtime.js + 配置在每次渲染时合成，改样式即时生效。
- 不做内联图片：媒体走路由，脚本体积恒定在几 KB。
- 不做复杂时间轴：段与段之间只有淡入淡出，够用、好维护。
- 失败即静默：合成失败就返回空注入，绝不挡住应用启动。

截图

默认抽象底

品牌行与跳过提示

许可

MIT。本仓库不含任何游戏/第三方美术资源，media/ 由使用者自行提供，相关素材版权归各自权利人。