dsh-custom-splash

Custom Splash

DeepSeek Harness 启动界面：启动时全屏播放你自己的视频（播完淡出进入主界面），内置六幕动画可随时切回。视频可放固定路径直接替换，支持跳过、静音降级、音量与画面适配，web profile 与 DeepSeek Harness Desktop 桌面端通用。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:diexianxiang/dsh-custom-splash#a43e6b88568b8d10684612227e484452171bae6d

兼容性与来源证明

Custom Splash 以 dsh-custom-splash 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/10/21

版本

1.0.0stable

2026/10/21

README

dsh-custom-splash

A startup-screen plugin for DeepSeek Harness (DSH): play your own video full-screen while DSH boots, then fade into the app.

中文详细说明：README.zh.md

video splash

Features

Video mode (default) — a local MP4 covering the window, auto-fading into the app when it ends.
Swap the video without reinstalling — drop any MP4 at %USERPROFILE%\.dsh\startup-video\boot.mp4 (or ~/.dsh/startup-video/boot.mp4), or point the setting at any absolute path (file or directory).
No first-frame flash — the lock class is added synchronously in <head> and the black overlay is the first child of <body>, so the app never paints before the video.
Streams with HTTP Range — /dsh-startup/media/<file> supports 206, HEAD and seeking, and is served with Cache-Control: no-store.
Never hangs the boot — autoplay rejection falls back to muted + an "unmute" button; decode errors, a 25 s watchdog and script failures all release the page immediately.
Skippable — bottom-right skip button, Esc, or click (after 0.9 s).
Per-session by default — a refresh in the same tab does not replay it; always / daily are also available.

Note: The built-in six-act interactive sequence from the upstream project is currently disabled in this v1.0.0 fork due to a DOM mounting compatibility issue. It will be restored in a future update.

Install

dsh plugin --profile web add ./dsh-custom-splash-1.0.0.tgz

On Windows, unzip the release and double-click 安装.cmd.

For DeepSeek Harness Desktop, install the .tgz through its plugin manager (the desktop profile cannot be managed from the CLI), then fully quit from the tray and relaunch — closing the window is not enough.

Requirements: DSH web profile or Desktop, Node >= 20, no runtime dependencies.

Uninstall:

dsh plugin --profile web remove dsh-custom-splash

Use your own video

Fastest path — overwrite one file:

%USERPROFILE%\.dsh\startup-video\boot.mp4

If that file is missing the plugin falls back to its own lib/assets/video/boot.mp4, so deleting it never leaves you with a black screen.

Prefer another location? Settings → Startup screen → Video absolute path accepts a file or a directory (relative paths are rejected). Leave it empty to use the bundled clip.

Encode for the browser (H.264 + yuv420p + AAC, faststart):

ffmpeg -i source.mov -vf scale=1920:1080:flags=lanczos \
  -c:v libx264 -preset medium -crf 20 -pix_fmt yuv420p \
  -c:a aac -b:a 192k -movflags +faststart boot.mp4

Settings

DSH Settings → "Startup screen" (labels are in Chinese).

Playback: enabled · source (video / builtin) · video absolute path · video file name · fit (cover / contain) · muted · volume · mode (session / always / daily) · allow skip.

Builtin sequence only: theme · speed · require confirmation · identity name/id/clearance · voice (on/off, source, voice, rate, pitch, volume, cue sound, intro delay) · UI sounds · accent and glitch colors · all copy fields.

The builtin-only fields are hidden automatically in video mode.

FAQ

Nothing shows up — check that the "Startup screen" section exists in Settings (otherwise the bundle is not mounted), that "Enabled" is on, and that mode is not session with the tab already visited. On Desktop, quit from the tray.
Video does not play — verify H.264/yuv420p/AAC, or enable "Muted" (muted autoplay is exempt from browser autoplay policies). Failures release the page instead of hanging it.
No sound — browsers require a user gesture before audio; a muted fallback with an "unmute" button is provided.
401 from /dsh-startup/* — expected: those routes only trust loopback requests carrying the host's trust marker.

How it works

Host (lib/index.js)
  tapIndex → <head>: critical CSS + config + EARLY_LOCK_JS
           → <body>: #dsh-startup-root overlay + BOOTSTRAP_JS (mode checks, 9 s fallback)
  routes (/dsh-startup): splash.css · splash.js · boot-video.js · media/<file> · asset/<file>.mp3 · config
Browser
  lib/boot-video.js  overlay + <video> + skip/unmute + watchdog
  lib/client.js      settings panel (self-boots the overlay if the host did not inject it)

Development

npm test               # four smoke suites (254 assertions)
npm run pack:release   # npm pack into release/

Repo layout:

lib/index.js       host half: config, injection, six routes
lib/boot-video.js  video runtime (zero deps, all styles inline)
lib/splash.js      builtin six-act runtime
lib/splash.css     builtin six-act styles
lib/client.js      settings panel
lib/assets/        audio + video assets
test/              smoke suites
preview/           offline preview page (not published)
docs/              screenshots and publishing notes

License & credits

MIT. Based on [6shenhonghong9/dsh-startup-screen] (MIT) — the builtin six-act sequence, its styles, audio assets and copy come from there. This fork adds the video mode, replaceable video path, first-frame flash fix and the related settings.

README

dsh-custom-splash

A startup-screen plugin for DeepSeek Harness (DSH): play your own video full-screen while DSH boots, then fade into the app.

中文详细说明：README.zh.md

video splash

Features

Video mode (default) — a local MP4 covering the window, auto-fading into the app when it ends.
Swap the video without reinstalling — drop any MP4 at %USERPROFILE%\.dsh\startup-video\boot.mp4 (or ~/.dsh/startup-video/boot.mp4), or point the setting at any absolute path (file or directory).
No first-frame flash — the lock class is added synchronously in <head> and the black overlay is the first child of <body>, so the app never paints before the video.
Streams with HTTP Range — /dsh-startup/media/<file> supports 206, HEAD and seeking, and is served with Cache-Control: no-store.
Never hangs the boot — autoplay rejection falls back to muted + an "unmute" button; decode errors, a 25 s watchdog and script failures all release the page immediately.
Skippable — bottom-right skip button, Esc, or click (after 0.9 s).
Per-session by default — a refresh in the same tab does not replay it; always / daily are also available.

Note: The built-in six-act interactive sequence from the upstream project is currently disabled in this v1.0.0 fork due to a DOM mounting compatibility issue. It will be restored in a future update.

Install

dsh plugin --profile web add ./dsh-custom-splash-1.0.0.tgz

On Windows, unzip the release and double-click 安装.cmd.

Requirements: DSH web profile or Desktop, Node >= 20, no runtime dependencies.

Uninstall:

dsh plugin --profile web remove dsh-custom-splash

Use your own video

Fastest path — overwrite one file:

%USERPROFILE%\.dsh\startup-video\boot.mp4

If that file is missing the plugin falls back to its own lib/assets/video/boot.mp4, so deleting it never leaves you with a black screen.

Prefer another location? Settings → Startup screen → Video absolute path accepts a file or a directory (relative paths are rejected). Leave it empty to use the bundled clip.

Encode for the browser (H.264 + yuv420p + AAC, faststart):

ffmpeg -i source.mov -vf scale=1920:1080:flags=lanczos \
  -c:v libx264 -preset medium -crf 20 -pix_fmt yuv420p \
  -c:a aac -b:a 192k -movflags +faststart boot.mp4

Settings

DSH Settings → "Startup screen" (labels are in Chinese).

Playback: enabled · source (video / builtin) · video absolute path · video file name · fit (cover / contain) · muted · volume · mode (session / always / daily) · allow skip.

The builtin-only fields are hidden automatically in video mode.

FAQ

Nothing shows up — check that the "Startup screen" section exists in Settings (otherwise the bundle is not mounted), that "Enabled" is on, and that mode is not session with the tab already visited. On Desktop, quit from the tray.
Video does not play — verify H.264/yuv420p/AAC, or enable "Muted" (muted autoplay is exempt from browser autoplay policies). Failures release the page instead of hanging it.
No sound — browsers require a user gesture before audio; a muted fallback with an "unmute" button is provided.
401 from /dsh-startup/* — expected: those routes only trust loopback requests carrying the host's trust marker.

How it works

Host (lib/index.js)
  tapIndex → <head>: critical CSS + config + EARLY_LOCK_JS
           → <body>: #dsh-startup-root overlay + BOOTSTRAP_JS (mode checks, 9 s fallback)
  routes (/dsh-startup): splash.css · splash.js · boot-video.js · media/<file> · asset/<file>.mp3 · config
Browser
  lib/boot-video.js  overlay + <video> + skip/unmute + watchdog
  lib/client.js      settings panel (self-boots the overlay if the host did not inject it)

Development

npm test               # four smoke suites (254 assertions)
npm run pack:release   # npm pack into release/

Repo layout:

lib/index.js       host half: config, injection, six routes
lib/boot-video.js  video runtime (zero deps, all styles inline)
lib/splash.js      builtin six-act runtime
lib/splash.css     builtin six-act styles
lib/client.js      settings panel
lib/assets/        audio + video assets
test/              smoke suites
preview/           offline preview page (not published)
docs/              screenshots and publishing notes

Custom Splash

兼容性与来源证明

版本

相关插件

Custom Splash

README

dsh-custom-splash

Features

Install

Use your own video

Settings

FAQ

How it works

Development

License & credits

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-custom-splash

Features

Install

Use your own video

Settings

FAQ

How it works

Development

License & credits