dsh-boot-nexus
zeki520/dsh-boot-nexus
把片头视频、suite 六幕冷启动与屏保合进同一个开机动画:一层画面、一个状态机、一个时钟、一份配置,所有选项都在一张玻璃面板设置卡里。suite 引擎、模板与一套原画质片头/屏保素材(720p–4K 原片,约 197 MB)也随包发布,装完第一次开机就有动画,删掉原插件后仍能播放;启用它时不要再同时启用 dsh-boot-suite 或 dsh-boot-animation。
安装
dsh plugin --profile web add github:zeki520/dsh-boot-nexusREADME
dsh-boot-nexus
开机动画、suite 两幕、屏保、素材池 —— 一个插件全搞定。
给 DeepSeek Harness 的一套开机仪式:每次启动只播一件事,所有参数都在一张卡片里改。
安装 · 它能做什么 · 设置卡 · 配置 · 文档 · 致谢
致谢
这个插件不是从零写出来的。开机视频的全窗口播放与淡出衔接来自 lxj5820/dsh-boot-animation;suite 六幕引擎、模板、语音与音效体系来自 LeeRolling/dsh-boot-suite。两位作者都选择了开源,nexus 才有东西可以合并。
如果你喜欢这套开机动画,请先去给原作者点 ⭐: lxj5820/dsh-boot-animation · LeeRolling/dsh-boot-suite。完整说明见文末致谢与来源。
它能做什么
- 一次只播一件事。 片头、suite 两幕、屏保共用同一个根节点、同一个状态机、同一个时钟,不会出现两个插件抢同一层画面的情况。
- 两套引擎,择一或随机。 50% 随机在 animation 视频池与 suite 原版两幕之间轮换,也可以固定成其中任意一种。
- 改完立刻看。 设置卡里保存后可在页面内直接预览,不用重启;30 多个可调项覆盖时长、音量、模板、身份、BGM、转场、颜色。
- 自包含。 suite 引擎、模板、语音与音效都随插件发布;旧插件删掉后仍然能播。
- 开箱就有画面。 包内自带 5 段片头与 7 段屏保,原画质(720p–4K,共约 197 MB),首次启动自动复制到素材目录 —— 不需要你先自备视频,装完第一次开机就有动画。
安装
git clone https://github.com/zeki520/dsh-boot-nexus.git
cd dsh-boot-nexus
npm run build
$v = (Get-Content package.json -Raw | ConvertFrom-Json).version
npm pack --pack-destination "$env:USERPROFILE\dsh-plugins"
dsh plugin --profile desktop remove dsh-boot-nexus
dsh plugin --profile desktop add "file:$env:USERPROFILE/dsh-plugins/dsh-boot-nexus-$v.tgz"
装完完全退出并重开 DSH。首次运行会自动建好素材目录,并把包内自带的 5 段片头、7 段屏保(原画质)复制进去($DSH_HOME\boot-nexus\media\clips / ...\savers),装完即可播放;想换成自己的视频,直接往这两个目录里放文件,或在设置卡里取消勾选不想要的。
更细的说明(同版本 tarball 复用、离线/内网安装、回滚)见文末 安装细节。
设置卡
一张卡片管理全部行为,顶部工具条固定显示当前状态与版本,随时保存、预览或收起:

- 10 个分区、93 个控件,全部平铺,不需要二次展开;
- 两列字段网格,窄窗口自动降为单列;
- 分区做成卡片:卡头带小图标与发光线,卡片之间共边,整块读作一张玻璃面;
- 开关、下拉、滑杆、输入框全部重绘:开关带青色发光,滑杆显示已填充比例,聚焦时描边点亮;
- 所有控件有可访问名称,错误与保存状态通过 live region 播报;
- 表面色由
color-mix从前景色派生,深色/浅色宿主自适应,不依赖color-scheme探测。
为什么需要它
两个插件单独都能工作,同时启用时不是"版本不兼容",而是"同一时刻两个主人":
#dsh-startup-root(z-index: 2147483000)与.dshba(2147483647)同时存在,animation 恒盖住 suite,但 suite 的 188 KB 运行时、音频、语音照跑;- 两边都写
html.dsu-lock、caption、媒体节点,后写者覆盖先写者; - 两边都订阅
webserver/index-inject,行序由订阅者激活顺序决定,插件无法仲裁; - suite 9 秒无条件拆层,animation 15 秒才提示,9–15 秒出现两次退场;
- 三份配置(
dsh-startup.json、chat-wallpaper.json、animation 的 settings 命名空间)各自认为自己是真相。
nexus 的做法:宿主侧只产出一份 plan 和一套注入行;浏览器侧只有一个根节点、一个状态机、一个时钟;旧插件必须禁用,nexus 检测到旧行时主动让位而不是竞速。
目录
dsh-boot-nexus/
package.json
cordis.patch.yml # 单 insert:id boot-nexus
assets/icon.svg
src/
index.js # Host 组合根
shared/constants.js
host/
config.js # 唯一 schema / 迁移 / 原子写
css.js # 关键 CSS(唯一 z-index)
rows.js # 4 行注入 + 幂等 + 旧哨兵让位
assets.js # MIME / allowlist / Range
routes.js # 5 条路由 + trust fence
runtime/
00-constants.js
10-fsm.js # 状态机(纯函数)
20-clock.js # 唯一 timer/rAF 袋
30-media.js # video/image 适配
40-stage.js # 唯一 root / lock / caption / phase
50-boot.js # 门控、编排、交接、屏保
client/
index.js # clientReady + 单一设置卡
scripts/build-runtime.mjs # 拼 IIFE → lib/runtime.js
lib/runtime.js # 构建产物(58.3 KB)
test/ # 66 个 node:test 用例
docs/
构建与测试
npm test
期望:
runtime: 58284 bytes (ok; budget 65536, hard 98304)
ℹ tests 60
ℹ pass 60
ℹ fail 0
只跑构建:
npm run build
检查产物:
Get-Content lib/runtime.meta.json
配置
唯一文件:
$DSH_HOME/dsh-boot-nexus.json
首次启动会从旧文件只读迁移一次:
$DSH_HOME/dsh-startup.json$DSH_HOME/chat-wallpaper.json- animation 的
dsh-boot-animation.json/boot-animation.json/settings/boot-animation.json候选
迁移规则、字段默认值与范围见 docs/DESIGN.md §7。旧文件不会被改写;未知键保留在 legacy.*。
行为字段不放进 cordis.patch.yml:patch 里只有 configFile / mediaDir 两个宿主路径,避免第二份真相。
设置卡顶部会直接显示以下路径,方便用户找到文件:
素材目录:$DSH_HOME/boot-nexus/media
suite 引擎目录:<插件包>/assets/suite
配置文件:$DSH_HOME/dsh-boot-nexus.json
素材与自包含
$DSH_HOME/boot-nexus/media/
clips/ 片头
savers/ 屏保
支持 mp4/webm/mov/png/jpg/webp/gif/avif。SVG 会被拒绝(可携带脚本);隐藏文件、目录、>512 MB 文件会被跳过。素材按文件名排序后生成稳定 id(clip-1、saver-1)。
animation 的 5 个片头 / 7 个屏保视频不放进 npm 包(第三方素材授权限制),而是放在上面的数据目录。它们属于插件数据,不随 node_modules/dsh-boot-animation 删除;删除旧 animation 插件后 nexus 仍能播放。
suite 的引擎、模板、语音与音效已经 vendored 到插件包:
assets/suite/
lib/splash.js
lib/assets/...
templates/...
findSuitePackage() 优先使用这份 vendored 副本;只有它缺失时才回退到 profile 里的 dsh-boot-suite。所以删除旧 suite 插件后 nexus 仍能播放 suite 两幕。用户导入的 custom-* 模板在 $DSH_HOME/startup-templates,同样不随旧插件删除。
安装细节(从源码 / 离线)
从源码打包:
npm run build
$v = (Get-Content package.json -Raw | ConvertFrom-Json).version
npm pack --pack-destination "$env:USERPROFILE\dsh-plugins"
然后在终端(desktop profile 由 Electron 管理,先完全退出 DSH):
dsh plugin --profile desktop remove dsh-boot-nexus
dsh plugin --profile desktop add "file:$env:USERPROFILE/dsh-plugins/dsh-boot-nexus-$v.tgz"
同版本 tarball 可能被 pnpm 复用;换版本或先 remove 再 add。安装后重启 DSH。不要手写 profile 的 package.json(除非 pnpm 解析网络失败,见下),不要在 profile 目录跑 pnpm。
装完可以不解包直接验证安装产物是否自洽:
node scripts/verify-installed.mjs
该脚本用假 Cordis context 跑一遍真实安装包:注入 4 行、5 条路由、计划里的素材数量与版本号都要对得上。默认读 %USERPROFILE%\.dsh\profiles\desktop,用 DSH_PROFILE_DIR 指向别的 profile。
回滚:dsh plugin --profile desktop remove dsh-boot-nexus,重启。旧插件行仍在 profile 的 cordis.patch.yml 里,把 disabled: true 改回 false 即可恢复(nexus 不修改旧配置)。
离线/内网环境安装
dsh plugin add 会用 DSH 自带 pnpm 解析整个 profile,其中可能有依赖挂在 GitHub Release 上。若解析阶段报 UNABLE_TO_VERIFY_LEAF_SIGNATURE 或 UND_ERR_HEADERS_TIMEOUT,可以绕过 CLI,手工把 tarball 写进 profile 再本地安装:
- 把
%USERPROFILE%\.dsh\profiles\desktop\package.json里dsh-boot-nexus的 spec 改成file:<tarball 绝对路径>; - 同一个 profile 的
pnpm-lock.yaml里把dsh-boot-nexus的 importer specifier/version 与 package/snapshot 头同步成新版本,并更新 integrity(sha512-…,从npm pack输出的shasum/integrity可取); - 在 profile 目录执行
pnpm install --frozen-lockfile。
profile 没有独立状态文件,安装关系全部由 package.json + pnpm-lock.yaml 派生,所以手工安装与 CLI 等价。
运行时可用的诊断
__BOOT_NEXUS__.state // arming / playing / handoff / revealed / saver
__BOOT_NEXUS__.phase
__BOOT_NEXUS__.failed
__BOOT_NEXUS__.plan
__BOOT_NEXUS__.on(e => console.log(e))
__BOOT_NEXUS__.skip()
__BOOT_NEXUS__.preview()
__BOOT_NEXUS__.dispose()
URL 开关:
| 参数 | 作用 |
|---|---|
?dbn=off | 不接管,走原生启动 |
?dbn=preview | 绕过 session/daily,强制播 |
?dbn=diag | 开启运行时诊断日志(__BOOT_NEXUS__.logs) |
启动方式(A/B)
每次启动按 boot.choice 掷一次:
random(默认):约 50% 走 A,50% 走 B;clip/animation:只播 animation 的随机视频池,一段;suite:只播 suite 原版引擎的archive-warm第一幕 + 第二幕(默认跟随 suite 配置,可设为none)。
suite 的两幕都由 suite 自己的 splash.js 负责,nexus 不会在 suite 结束后追加动画池。suiteAct2Ms=0 表示按模板原长播放;正数才裁剪。任何 suite 失败都直接揭幕(fail-open),不会回退到视频池。
设置卡里可直接改:启动方式、第一幕/第二幕模板、第二幕时长上限、素材池勾选,以及 suite 原版的 BGM/身份/交互/语音/转场等字段。所有字段平铺显示,不需要再点展开;颜色用中文名选择(值仍写回 suite 需要的 hex)。
验证状态
| 项 | 状态 |
|---|---|
| 单测 66/66 | ✅ |
| 运行时构建 58.3 KB | ✅ 58284 B(预算 64 KB) |
| Desktop 实机(0.3.3:suite 两幕 + 声音 + 无第三段) | ✅ |
| 设置卡(分组面板、中文颜色、路径显示) | ✅ |
| 插件列表 / 设置卡图标(0.4.1) | ✅ 已实机确认插件卡;顶部内置配置项左图标为 DSH 固定映射,0.4.2 在摘要行加插件自带小图标 |
| 顶部设置项摘要小图标(0.4.2) | ✅ |
| suite 每步停留可调(0.4.3) | ✅ 已实现:suiteHoldMs 0=模板,>0 抬高每步下限 |
| 页面内预览(0.4.3) | ✅ 已实现:保存后取新 plan,dispose 重跑,不刷新页面 |
| 身份卡单独停留(0.4.4) | ✅ 已实现:suitePopupMs 只抬高 confirm 卡,其他步骤不动 |
| 设置卡改版(0.5.0) | ✅ 1040 / 760 / 520 px 三档宽度离线渲染通过;面板恒 #1c1f24,正文 14.2:1、说明 7.3:1 |
| 无障碍修订(0.5.1) | ✅ 93/93 控件有名称、7 个分区有 aria-labelledby、live region 常驻、保存中焦点不丢 |
| 版本号显示(0.5.2) | ✅ 设置卡工具条显示插件版本号 |
| 自带素材(0.5.3 / 0.5.4) | ✅ 包内 5 段片头 / 7 段屏保;0.5.4 换成原画质(197 MB)。空素材目录首次启动自动播种,单测 6 例覆盖「只播一次、删除不复活、同名不覆盖」 |
| 旧插件禁用 | ✅ 两条 insert 行均 disabled: true |
| 删除旧插件后自包含(0.3.4) | ✅ 临时改名 dsh-boot-suite / dsh-boot-animation 后,vendored suite 与数据目录素材仍可用 |
文档
| 文档 | 内容 |
|---|---|
| docs/DESIGN.md | 两插件冲突分析、合并后的状态机与字段设计、迁移规则 |
| docs/TEST-PLAN.md | 部署步骤与逐项验收清单 |
| docs/SUITE-ENGINE.md | suite 原版引擎的 vendored 接入与 token 路由 |
| docs/screenshots | 设置卡与工具条截图、仓库图标 |
版本记录
当前 0.6.1:68 个单测通过,suite 原版引擎与 animation 随机池均实机通过;旧插件仍保留但已禁用,删除它们不影响 nexus。
0.6.1配音统一为机械音:voiceFx缺省、空串与未知值都归一到robot,新装用户与从旧dsh-boot-suite迁移过来的机器听起来一致;想关掉可在设置卡「语音与音效 → 声音效果」选「无」;0.6.0设置卡视觉重构:深空玻璃面板与卡片化分区、开关式 checkbox、圆润 chevron 下拉、光晕滑杆与聚焦发光;表面色全部由color-mix从前景色派生,不再猜测宿主主题;0.5.5修复新装用户 suite 六幕无人声:默认voicePack落在不存在的a包(路由 404),现在统一归一化为随包发布的f;卡片里的音色选项标签同时改为「英文 F(默认)/ 日文 1–5」;0.5.4自带素材改为原画质:不再转码,直接打包 720p / 1440p / 4K 原片(197 MB,安装包约 256 MB);0.5.3包内自带默认素材:5 段片头 + 7 段屏保(720p / 1080p,共约 42 MB),首次启动复制到素材目录并写入.bundled-media.json标记,之后不再重复播种、也不复活用户手动删掉的文件;0.5.2工具条显示插件版本号,补齐 MIT 许可与可移植的安装校验脚本;0.5.1无障碍与审查修订:93 个控件全部有可访问名称、常驻 live region、保存期间焦点不丢失、控件边界与非文本对比度达标、渲染异常有兜底卡片;0.5.0设置卡改版:近不透明分组面板、两列字段网格、吸顶工具条(状态/版本/保存/预览/收起);0.4.5修复保存后 suite 字段被 POST 响应清空、预览结束后黑屏不自动退出;0.4.4新增身份卡单独停留(suitePopupMs);0.4.3新增 suite 每步自动停留(毫秒)与页面内预览;0.4.2在顶部设置项摘要行加 18px 小图标;0.4.1修复设置卡 suite 生效配置回显,manifest 图标改用 128px;0.4.0加入 64/128/256 图标与设置卡图标。
设计与冲突分析见 docs/DESIGN.md,部署与验收见 docs/TEST-PLAN.md,suite 引擎接入见 docs/SUITE-ENGINE.md。
致谢与来源
nexus 的每一帧画面,几乎都能追到这两个仓库:
| 项目 | 作者 | 这里用到了什么 | Star |
|---|---|---|---|
| dsh-boot-animation | lxj5820 | 全窗口视频片头、播完淡出交还应用、素材池与随机选片 | ⭐ 去点 |
| dsh-boot-suite | LeeRolling | 六幕冷启动引擎、模板 / 语音 / 音效、设置卡与身份卡 | ⭐ 去点 |
nexus 做的是把它们合到同一层画面里:一个根节点、一个状态机、一个时钟、一份配置、一张设置卡。引擎、素材与设计思路都来自上面两位作者的开源工作,遇到播放问题也请先看原仓库的文档与 issue。
如果这个插件帮你省了事,请把 ⭐ 点给源头:
许可证
MIT © 2026 zeki520