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/ 由使用者自行提供，相关素材版权归各自权利人。