前言¶
DeepSeek Harness 的核心设计理念是「一切皆插件」。如果你希望在启动应用时展示一段自定义视频或动图，播完后自动淡出露出主界面，deepseek-splash-animation 插件可以满足这个需求。该插件由 KDDKBD 维护，开源协议为 MIT。
安装¶
通过命令行安装：
dsh plugin --profile web add github:KDDKBD/DeepSeek-splash-animation
安装完成后需要重启 DeepSeek Harness。插件自带一段默认视频，安装后重启即可直接使用。你也可以在设置页面手动更换视频或清除配置。
功能与配置¶
核心功能¶
该插件主要提供以下能力：
* 播放自定义视频或图片（支持 mp4, webm, gif, webp 等格式）。
* 播放插件自带的默认视频。
* 播放结束后 0.3 秒渐隐，露出 DSH 界面。
* 支持跳过按钮，也支持键盘退出（ESC、空格、回车）。
* 支持配置静音、音量、填充方式（cover/contain/fill）。
界面操作¶
在 设置 → 插件 → 开屏动画 中：
* 点击「选择文件…」可在本机选择视频或图片。
* 直接在输入框中粘贴路径。
* 点击「清除」可彻底关闭开屏动画功能。
配置文件¶
如果需要更精细的控制，可以在 profile 目录下的 cordis.patch.yml 中覆盖配置：
- id: dsh-splash-animation
config:
fit: contain # 填充方式：cover(铺满裁切), contain(完整显示留黑边), fill(拉伸填满)
muted: false # 是否静音（默认静音，因 Chromium 会拦截自动播放声音）
fadeOutMs: 600 # 渐隐时长（毫秒）
skip: click # 退出方式：button(按钮), click(点击任意处), auto(自动), never(不可退出)
行为与注意事项¶
启动过程¶
启动时出现短暂黑屏是正常现象。插件在页面第一帧就会覆盖内容，只有当插件自身的画面挂载完成后才会显示，因此启动过程中无法看到 DSH 的原生界面。
声音策略¶
默认静音。Chromium 浏览器要求用户先与页面交互才允许播放带声音的媒体，而开屏动画发生在用户交互之前。如果需要声音，需在配置中设置 muted: false。
常见问题¶
- 选了视频但没有播放：检查设置页是否显示「下次启动播放」，以及配置文件中的路径是否正确。
- 格式兼容性：插件使用 HTML5
<video>和<img>标签。推荐使用webm(VP9) 或mp4(H.264) 以获得最佳兼容性。mov和mkv能否播放取决于内部编码（如 ProRes/DNxHD 可能无法解码）。
