@ljwei-stak/dsh-boot-animation
v0.6.6
Published
鲸鱼娘启动加载动画:点击进入(Esc/空格放行)、多片随机、启动进度可见、失败有兜底;数据驱动开屏模板(分幕/时间线/iframe,兼容 dsh-boot-suite 格式)、用户 BGM、可视化模板编辑器与模板商店。不改 DSH 本体源码。
Maintainers
Readme
dsh-boot-animation
语言:简体中文 | English
用选定或随机的本地视频替换 DSH 启动页,或用数据驱动的开屏模板(分幕、时间线、整页 iframe)替换,随后过渡进入应用,并提供可配置的播放与回退控制。它不会修改 DSH 核心源码;未来的兼容性不作保证。
这是一个社区插件,与 DeepSeek 不相关,也未获得 DeepSeek 的认可。
- 软件包:
@ljwei-stak/dsh-boot-animation - 版本: 0.6.6
- 仓库: Alice-Marx/dsh-boot-animation
- 主题:
dsh-plugin - 目录分类: UI & Experience(用户界面与体验)—— 已收录于 DSH 插件目录,并被 dshfind 索引;上面的徽章读的是实时状态。
截图
本地 Chromium 演示宿主渲染了实际的 0.6.6 启动页和设置卡片源码,并附带示例 profile 数据。这些不是已登录的 DSH live profile 截图,也不代表已完成跨平台验证。

影片形式:满屏短片 + 跟真实启动进度走的进度条 + 底部提示行。

模板形式:内置 archive-warm 分幕模板——经典授权序列,正在等待操作员确认。
安装
Web 版
dsh plugin --profile web add @ljwei-stak/[email protected] --save-exact必须已满足宿主与 Node 的要求。
桌面版
打开 设置 -> 插件 -> 添加插件,粘贴 @ljwei-stak/[email protected],然后按提示从托盘彻底退出并重新打开。
对于 Desktop 升级,如果实时安装 API 报告该软件包已安装,请先从托盘彻底退出,然后使用官方 Desktop 捆绑包装器——而不是较旧的全局 dsh 可执行文件。
Windows 默认位置的可复制离线命令:
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add '@ljwei-stak/[email protected]' --save-exact如果 DeepSeek Harness 安装在其他位置,请相应调整包装器路径。如果你使用自定义 DSH_HOME,在运行此命令时请保留该设置。不要在 Linux 或 macOS 上使用这个确切的 Windows 路径。
卸载
Web:
dsh plugin --profile web remove @ljwei-stak/dsh-boot-animationDesktop:使用官方插件 UI。已有的自定义视频是独立数据;在手动删除前,请先检查并备份。新的软件包安装会自动注册 scoped bundle;不要手动插入第二个 bundle 条目。
配置
该插件使用宿主 profile 配置和一个插件补丁文件。没有单独的 .env、INI 或 JSON 设置加载器。
| 文件 | 作用 |
| --- | --- |
| <DSH_HOME>/profiles/<profile>/cordis.yml | 宿主基础配置。 |
| <DSH_HOME>/profiles/<profile>/cordis.patch.yml | 插件配置修改。随附的 patch 挂载 id 为 boot-animation,名称为 @ljwei-stak/dsh-boot-animation。 |
| Profile package.json | 通过安装器跟踪依赖和 dsh.profile.bundles。 |
提供了一个示例片段,仅作为配置对象参考;它不是一个独立的自动加载配置文件。
设置命名空间:boot-animation。优先使用现有设置 UI。预览会立即使用当前设置。重新加载 Web 页面以进行下一次启动;在 Desktop 上,从托盘彻底退出并重新打开以进行下一次启动。Host entry 升级也需要完整重启进程。
| 键 | 默认值 | 说明 |
| --- | --- | --- |
| enabled | true | 主开关。 |
| fadeMs | 2000 | Schema 范围 300–5000 ms;UI 预设 1000、1500、2000、3000、4000。 |
| enterMode | tail | tail 在片段末尾溶解;end 在播放结束后淡出;click 循环直到进入。 |
| disabledClips | [] | 在池中被禁用的不透明文件名。 |
| sound | true | 受浏览器手势策略限制。 |
| clickToEnter | false | 启用后,第一次指针按下会立即进入;否则按下可能先用于解锁音频。 |
| showHint | true | 显示进入提示。 |
| form | video | video 是影片形式;template 把开屏页交给数据驱动的模板运行时。 |
| template | archive-warm | 模板形式第一幕的模板 id。 |
| template2 | "" | 可选的第二幕;为空则不播。 |
| tpl | 见下 | 模板形式自己的设置(速度、主题、时机、配音、身份、配色、转场、玻璃)。 |
tpl 是一个嵌套对象,每个叶子字段都可以单独热更新——设置卡片一次只写一个叶子
({ op: 'set', path: ['tpl', 'speed'] })。Host 没有下发的字段一律沿用 vendored
运行时的默认值,所以在模板形式出现之前写下的设置文档本身就是完整的。全部字段、
取值范围与默认值见 entry.js 的 TPL_DEFAULTS。
视频素材
导入的视频会复制到 <DSH_HOME>/profiles/<profile>/data/dsh-boot-animation/videos。最初选中的文件不会被改动。assets/videos 下的旧版内置资源可能会被软件包升级替换;推荐使用 UI 导入。
在 UI 中,打开 设置 -> 插件 -> 已安装插件 -> 启动动画(配置区就在插件自己的页面里;每一行的「配置」页是同一张卡。DSH 0.2.1 及更早版本中它在「插件配置」列表里),可以导入最大 256 MiB 的视频、将一个片段设为启动片或启用多个片段进行随机选择、预览当前效果,并在确认后移除自定义片段。
开屏模板
form: template 时,开屏页由 assets/splash/ 下的 vendored 运行时渲染:模板是纯
JSON 加素材。内置三种引擎,任选其一都能跑:分幕 steps(中英文字幕 + 配音 + 可选
等待)、时间线 layers(图层关键帧——文字、线条、面板、图片、视频、字符球、身份卡
等)、iframe(模板自己的整个网页,经能力令牌沙箱加载)。
插件内置 12 个模板,覆盖每种引擎。把模板目录放进
<DSH_HOME>/profiles/<profile>/data/dsh-boot-animation/templates/<id>/ 即可加入列表,
同名的用户模板会覆盖内置模板。为 dsh-boot-suite
写的模板可以直接用——格式是那个项目的,运行时是其引擎的适配副本,完整署名见
CREDITS.md。
动这一半之前值得知道的两条不变量:读不出来或校验不过的模板会回落到影片形式 (绝不是黑屏),以及每个可能读到用户模板目录的路由都过浏览器信任栅栏,栅栏 fail-closed。
音乐、编辑器与商店
模板形式还带着三项能力,同样移植自上游项目,也遵循同样的规则:
- 自己的音乐:设置卡片的「背景音乐」分段可以导入音频(MP3 / WAV / OGG / M4A / AAC / FLAC,单个不超过 100 MB),文件只写进本机 profile 的数据目录,不上传任何地方。 可以指定主音乐和可选的第二段(两段之间交叉淡入),以及音量、拍速、两段的拍数与 起点、循环方式和配音闪避。存储的文件名是生成的,不取自请求;读取路由在碰磁盘之前 会再校验一次白名单。
- 可视化编辑器:卡片里的「打开模板编辑器」开一个完整页面,可视化地改文字、图层、
关键帧和配色,带实时预览台;保存写进用户模板目录,覆盖前自动备份旧版本。页面由
tools/vendor-editor.mjs从上游编辑器生成,路由基准改写到本插件。 - 模板商店:卡片里的「模板商店」分段列出公开模板(默认索引是 dsh-boot-suite 的 模板库,格式本插件原样支持),点「安装」就把模板和自带素材写进用户目录。拉取在宿主 侧完成,有体积和超时上限;文档在写入前先过校验,且 id 必须与索引条目一致。网络不 通时回答上次读到的列表,而不是把功能藏掉。
兼容性
- **DSH:**最低
>=0.2.0-rc.2;已针对 Windows Desktop 运行时0.2.0-rc.2和0.2.1-rc.2验证集成。 - Node:
^22.19.0 || >=24.0.0;ESM。 - 运行时依赖:
@deepseek-ai/schemastery^3.18.4(声明为依赖,而非 peer dependency)。 - **浏览器:**目标为 Chromium、Chrome 和 Edge;Firefox 未经验证。
- **平台:**macOS 和 Linux 脚本路径存在,但在此验收中未经过独立测试。
- **编解码器:**需要浏览器支持的编解码器。优先使用 H.264/AAC MP4。仅凭 MP4、WebM、M4V 或 MOV 容器格式,无法保证浏览器能够解码。
权限与信任
此 Node 插件以宿主 OS 权限运行;没有按插件划分的沙箱。
- **读取:**随附的脚本和视频。
- **写入/移除:**profile 数据目录中导入的视频副本。
- **Optimize:**使用 Node API 显式重写内置的 MP4,并带有
originals/备份和.faststart-work/临时空间。运行时不会执行 shell 命令或ffmpeg。 - **凭据/网络:**插件运行时不会使用模型或提供商 API 密钥、遥测或远程服务。浏览器 HTTP 调用为同源。安装器需要
npm和 GitHub 网络访问,但这与运行时行为不同。
HTTP 访问边界
自定义的 import、read 和 delete 路由会强制执行 DSH connection.requestRejection 身份验证和路径检查。Bundled clip manifest/video 和 Optimize 路由本身不会强制执行相同的钩子。不要假设每条路由都经过身份验证。
请仅在受信任的本地环境中使用。远程或反向代理运营方必须对整个 /plugins/dsh-boot-animation/ 前缀强制执行访问控制。导入的媒体不会发布到 GitHub 或 npm。视频以 no-store 方式提供,因此重复加载会再次传输片段数据。
许可证
代码以 MIT 许可证发布。LICENSE 声明内置 MP4 作品同样采用 MIT 条款。用户导入的媒体保留其自身权利;安装插件不会对其进行再许可。
参考仓库
- 原始代码 / 上游:
lxj5820/dsh-boot-animation - 官方 DSH 宿主:
deepseek-ai/deepseek-harness - 当前维护的分发:
Alice-Marx/dsh-boot-animation - 模板运行时、模板库与可视化编辑器的来源:
LeeRolling/dsh-boot-suite - 液态玻璃、配音素材与交互语法的来源:
6shenhonghong9/dsh-startup-screen
后两个是本包「模板动画」形式的移植来源;移植内容与改名映射见 CREDITS.md 与 tools/vendor-splash-runtime.mjs。不暗示上游、宿主或来源项目的任何认可。
开发者说明
此仓库中包含的验证命令:
node build-client.mjs # only if client source changes
node verify/verify-entry.mjs
node verify/verify-degraded.mjs
node verify/verify-options.mjs
node verify/verify-custom-clips.mjs0.6.6 版本通过了 567 项检查;但这并不意味着每个 Desktop 版本或操作系统都经过了完整的端到端测试。
有关开发和设置详情,请参阅 AGENTS.md、MANUAL.md 和 INSTALL.md。归档的历史记录保存在 docs/DEVELOPMENT_NOTES.md,不具有权威性。
插件目录提交
一份可直接复制的提交草稿遵循 hub 模板。徽章用于标明插件已收录于社区目录,不代表官方背书或质量保证。
