dsh-boot-sequence-nice
中文 | English
给 DeepSeek Harness（DSH）的可配置启动序列：在应用 UI 之前铺一层全屏画面，按你配置的顺序播放视频/图片，最后黑场收尾、让界面缓缓亮起。
默认抽象底
- 只有宿主半边，不注册客户端条目
- 首帧早于应用 UI（查询期注入
<head>）
- 只动
opacity / transform，不触发布局
- 随时可跳过；支持
prefers-reduced-motion；跑完把节点和样式拆干净
- 不附带任何第三方美术资源：默认底是 CSS 生成的抽象画面，视频/图片由你自己放进
media/
安装
从 GitHub 安装（推荐，不需要 npm 账号）：
`ash
跟随最新提交
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
`
本地开发：
ash 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/ 由使用者自行提供，相关素材版权归各自权利人。
