前言¶
DeepSeek Harness（DSH）默认没有启动时的视觉内容，每次打开都是白底黑字的界面。对习惯在启动时快速进入工作流的人来说，这段空白时间显得冗长。已有的方案要么是更换壁纸，要么是更换应用图标，缺乏对启动过程的控制。
这是什么¶
DSH Startup Intro 是一个为 DeepSeek Harness 提供自定义视频开场动画的插件。它允许用户导入本地视频片段，为每段素材单独配置播放参数，并在应用启动时交叉淡出过渡到工作台。插件会跟随 DSH 的浅色 / 深色外观自动切换对应的素材版本。
维护者为 zoe1nan。插件分类为「趣味换装」。
核心功能¶
- 视频素材库：支持导入本地视频（mp4、webm、mov 等 Chromium 能解码的格式）。每段素材独立管理，可删除或切换选中。
- 启动即播：直接播放原视频，不做 GIF 转换或重新编码。播放结束后约 0.8–1.2 秒交叉淡出露出 DSH 界面。播放中可点击「跳过开场」。
- 参数调节：起始位置、播放时长、播放速度、亮度、画面适配（铺满 / 完整）、影院填充（用同一段视频的模糊背景补满画面）、展示比例（淡出开始的时刻）、淡出时长、静音。
- 实时预览：设置页内嵌预览，参数调整即时生效。「播放完整开场效果」可在全屏跑一遍完整启动流程。
- 深浅色自动切换：插件监听
body[data-ds-dark-theme]的变化，自动选择深色版或浅色版的同一素材。设置页预览也会随外观实时切换。 - 本地数据：素材与参数保存在
~/.dsh/startup-intro/，卸载插件不会删除素材。
安装与启用¶
先确认 dsh 可用（DeepSeek Harness 自带 CLI，Electron 桌面版安装目录 resources/runtime/cli/bin/dsh.cmd）。
方式一：目录安装（推荐）
git clone https://github.com/zoe1nan/dsh-startup-intro.git
dsh plugin --profile desktop add /path/to/dsh-startup-intro
方式二：打包安装
pnpm pack # 或 npm pack，得到 dsh-startup-intro-1.1.0.tgz
dsh plugin --profile desktop add /path/to/dsh-startup-intro-1.1.0.tgz
安装完成后重启 DeepSeek Harness（Electron 桌面版重启才会加载新 bundle）。打开 设置 → 启动开场 即可看到插件页面。
典型用法¶
- 打开设置（
Ctrl+Alt+,），左侧选择「启动开场」。 - 点击「导入视频」，选择本地视频文件。导入后自动选中，下次启动就播放它。
- 在右侧调整参数：起始位置、播放时长、播放速度、亮度、画面适配等，预览会实时生效。点击「播放完整开场效果」可查看完整启动流程。
- 右上「每次启动播放」可临时关闭开场；「恢复默认参数」重置当前素材。
预置演示素材¶
仓库 demo/ 下提供了两段程序化生成的示例开场（1920×1080 / 8.8s / 30fps，各 2–3 MB）：
demo/startup-intro-dark.mp4：深色外观版，深蓝夜空 + 轨道环 + 原生小蓝鲸。demo/startup-intro-light.mp4：浅色外观版，纸面蓝墨 + 同构图的墨色鲸。
一键写入本机素材库并选中：
node tools/seed-demo.mjs
也可以直接在设置页「导入视频」里选择这两个文件。
深浅色自动切换¶
素材条目支持可选的 lightFile 字段。将浅色版文件放到 ~/.dsh/startup-intro/media/，并在对应条目加上 lightFile 即可：深色外观播放 file，浅色外观播放 lightFile。不填 lightFile 时两种外观播放同一文件。
配置示例（~/.dsh/startup-intro/state.json）：
{
"version": 1,
"enabled": true,
"selectedId": "v9f2b7c4e1a8d3605c7be",
"videos": [
{
"id": "v9f2b7c4e1a8d3605c7be",
"name": "DEEPSEEK HARNESS 开场.mp4",
"file": "v9f2b7c4e1a8d3605c7be.mp4",
"lightFile": "v9f2b7c4e1a8d3605c7be-light.mp4",
"meta": { "duration": 8.8, "width": 1920, "height": 1080 },
"params": {
"start": 0, "duration": 8.8, "speed": 1, "brightness": 1,
"fit": "cover", "cinema": true,
"holdRatio": 0.83, "fadeMs": 1200, "muted": true
}
}
]
}
适用场景与注意¶
- 桌面版（Electron，web profile）实测；Web 版同理，需注意浏览器自动播放策略（默认静音即可自动播放，取消静音后可能被拦截）。
- 视频解码走 Chromium 内置解码器：H.264/AAC 的 mp4 在桌面版可播；是否支持 HEVC/AV1 取决于 Harness 内置 Chromium 构建。
- 插件在启动时装配，不支持运行中热插拔。
- 素材保存在本机，不随插件同步；换机器需要重新导入。
- 导入文件大小上限 2 GiB（Host 侧限制）。
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。
结尾¶
DSH Startup Intro 让启动过程从空白变为可控的视频片段，支持深浅色自动适配，参数调节与实时预览让配置更直观。适合希望在启动时快速进入工作流、或喜欢通过视觉元素定制个人工作空间的用户。
