Yiheng-guo/dsh-boot-animation-pro

dsh-boot-animation-pro is a native Cordis plugin built exclusively for DSH (DeepSeek Harness), forked from NativeDog1/dsh-boot-animation to extend it with playback controls, trigger rules, a clip library, four visual effects, time-of-day intros, and a bilingual Chinese/English UI. Its single purpose is to play an mp4 boot video that fills the DSH window when the app opens, a new conversation starts, or a pinned conversation is re-entered. Installation is one command — dsh plugin --profile web add github:Yiheng-guo/dsh-boot-animation-pro for the web client, swapping web for desktop on the desktop app — and because the prebuilt lib/ directory is committed and no prepare script runs, no pnpm build authorization is triggered. A full DSH restart is mandatory afterward, since DSH's bundle layer is assembled on startup; on a browser tab the user must additionally hit Ctrl/Cmd+Shift+R.

Typical workflow: open the 🎛 panel at the bottom-left of the sidebar, pick one of five trigger modes (the default plays on new chats and pinned sessions; the per-launch mode guarantees one play per DSH start), tweak volume, mute-on-start, speed, countdown skip, fade-out, cover/contain fit, and randomize under the Play tab, layer scanlines/vignette/grain/glow under the Visual tab, and configure weekday × time-of-day intros that survive midnight under the Time tab. Pinned sessions are toggled with the 🎞→🎬 button, custom videos are dropped into ~/.dsh/boot-animation-pro/videos/ and selected from the Library, and the host resolves clips in a fixed order (selection → $DSH_BOOT_ANIMATION → intro.mp4 → newest in videos/ → four embedded clips), re-resolving on every request so swapping clips never requires a restart. It targets users who want a branded or themed DSH opening, want different intros at different times of day, or simply want some visual delight when launching the client.

Dependencies and limits are minimal: any modern Chromium-class browser is enough to render, the archive is shrunk from 19MB to 9.5MB by extracting only the embedded clips.data.js, and the BSD-3-Clause license is byte-identical to the original. Browser autoplay policies force every boot video to start muted; clicking the picture both unmutes and fullscreens it, which is the only compliant path. A 25-second watchdog kills runs that hang, and videos with a trailing moov atom are flagged "⚠ not optimized" and should be remuxed with ffmpeg -c copy -movflags +faststart. The plugin exposes write endpoints (/select, /remove) on DSH's web server outside the app-shell token, so all of them pass route-guard.js's four gates (loopback Host, no Sec-Fetch-Site: cross-site, loopback Origin when present, and Content-Type: application/json) — a regression suite replays the attacks and asserts both 403 and file preservation. First-run caveat: a hard reload is mandatory after install or upgrade because DSH's bundle responses carry immutable, max-age=31536000, and the legacy ~/.dsh/boot-animation/ directory is read-only scanned, so prior clips still appear in the library but the new plugin will not delete them.