dsh-plugin-startup-animation

dsh plugin --profile web add dsh-plugin-startup-animation

<div align="center">

<img src="docs/avatar.png" width="200" height="200" alt="开机动画">

开机动画 · Startup Animation

把全屏开机动画，装进你的 DeepSeek Harness。

<a href="https://github.com/WWFZS/dsh-plugin-startup-animation/releases"><img src="https://img.shields.io/github/v/release/WWFZS/dsh-plugin-startup-animation?style=flat-square&label=VERSION&color=4d6bfe" alt="Version"></a>

<img src="https://img.shields.io/badge/DSH-0.2.0%2B-4d6bfe?style=flat-square" alt="DSH">

<img src="https://img.shields.io/badge/运行时-零依赖-2ea44f?style=flat-square" alt="No deps">

<img src="https://img.shields.io/badge/License-MIT-2ea44f?style=flat-square" alt="License">

<img src="https://img.shields.io/badge/Author-WWFZS-8957e5?style=flat-square" alt="Author">

[安装](#安装) · [界面预览](#界面预览) · [使用指南](#怎么用) · [兼容性](#对未来-dsh-版本的兼容性) · 更新记录 · [源码构建](#开发)

</div>

---

项目简介

开机动画（Startup Animation） 是面向 DeepSeek Harness 的全屏启动画面插件。Harness

启动时，它在加载页前面盖一层动画，并监听应用真正就绪的时刻——界面一接管就淡出，

你等的永远是应用本身，不是动画。

插件通过内核的两个扩展点接入：webserver/index-inject 注入覆盖层与样式，

webServer.register 提供素材与管理路由。运行时不依赖任何 npm 包，浏览器半边只从宿主的

模块表 require('react')，装好即用、无需构建。

开箱自带 9 段视频 / 9 张壁纸 / 9 段语音，外加两只桌面宠物（122 段动作），

也支持上传你自己的 MP4 / WebM / GIF / PNG / JPG / MP3。素材在设置页里点卡片即用，

展示时长可以在 3–30 秒之间调；声音有两个彼此独立的开关——视频自己的音轨，

以及单独的开机音频。

核心特性

• 装上就有 —— 零配置，内置动画立刻播放
• 两种玩法 —— 内置素材库任选，或上传自己的文件
• 视频也能当界面主题 —— 进应用后画面铺在界面后面，五套预设一键换观感，文字照样看清
• 桌面宠物 —— 透明小动物浮在界面上，自己轮播动作，可拖动、可换宠物
• 声音两个独立开关 —— 视频音轨与独立音频各管各的，可任意组合
• 绝不扣住你 —— 点击、Esc / Enter / 空格、或者干等，每条路都能出去
• 失败即降级 —— 任何一步出错都退回 Harness 原生启动页，不阻塞启动
• 干净的画面 —— 只有动画本身，右下角一枚 Esc 键提示；不想等就按 Esc，或者点一下画面（这条不写在屏幕上）；不出问题不冒任何文字
• 时长自己定 —— 3–30 秒，视频与壁纸共用；点击跳过不受它限制
• 更新前先看清 —— 设置页的「更新公告」直接显示 Release 说明，不用跳 GitHub
• 卸载与升级都由你 —— 有新版只提示、你点一下才装；不需要了就卸载

界面预览

视频素材库 —— 卡片点选即用，来源直接标在卡片上（内置 / 上传），当前在用的那张标「使用中」：

<img src="docs/library-videos.jpg" width="520" height="262" alt="视频素材库">

壁纸素材库 —— 同样点卡片即生效，来源标记同上：

<img src="docs/library-wallpapers.jpg" width="520" height="268" alt="壁纸素材库">

桌面宠物 —— 浮在界面上的一只小动物，自己轮播动作，点它、拖它、换大小：

<img src="docs/pet-packs.png" width="520" alt="宠物卡：噜噜与女仆鲸鱼娘">

设置页顶部的宠物卡直接换：点一下另一只，浮层立刻换装，位置和大小跟着走，不用重启。

噜噜 —— 13 段动作，按 4 类展示（互动 / 休闲 / 工作 / 节庆）：

<img src="docs/pet-lulu.png" width="520" alt="噜噜的动作">

女仆鲸鱼娘 —— 109 段动作，按 11 类展示，配搜索和「随机一个」，不会铺满一屏：

<img src="docs/pet-maid.png" width="520" alt="女仆鲸鱼娘的动作分类">

实际效果 —— 内置素材选中之后，Harness 启动时看到的就是这些（动图无声；带语音的三段，声音要在设置页里直接预览）：

《薰衣草花语-等你爱我》 · 24 秒 · 1080p · 带语音

<img src="docs/preview-lavender.gif" width="420" alt="薰衣草花语-等你爱我">

《dsh-大肥鱼》 · 8 秒 · 720p · 带语音

<img src="docs/preview-fish.gif" width="420" alt="dsh-大肥鱼">

安装

四种方式，任选一种。装好后都在 设置 → 开机动画 里配置，首次安装完刷新一次页面即可。

代码在国内两个地方都放了一份，内容一致：GitHub 与

Gitee。版本号、Release 与 npm 包以 GitHub 为准。

方式二到方式四都有 Gitee 通道，GitHub 慢的时候替换链接即可，见每节末尾。

方式一：搜包名（最简单）

插件已发布到 npm，DSH 0.2.1+ 的插件管理器能直接装。

1. 打开 设置 → 插件，点 添加插件

2. 插件名填 dsh-plugin-startup-animation

3. 点 安装，完成后刷新页面

包名也可以在 npm 页面 上核对版本。

方式二：直链（不走 npm）

GitHub 慢、或想直接从 Release 装时用这条。这条路不需要 npm，也不需要 git。

1. 打开 设置 → 插件，点 添加插件

2. 插件名填下面这条地址

3. 安装源保持默认 —— 直链不经过安装源，选哪个都不影响

4. 点 安装，完成后刷新页面

https://github.com/WWFZS/dsh-plugin-startup-animation/releases/latest/download/dsh-plugin-startup-animation.tgz

链接永远指向最新版，收藏一次就够。GitHub 慢的话，用浏览器把同一链接另存为文件，再把

文件的绝对路径填进「插件名」（例如 C:\Users\你\Downloads\dsh-plugin-startup-animation.tgz），

效果一样。

国内走 Gitee 的话用这条：

https://gitee.com/weiwenfengzs/dsh-plugin-startup-animation/releases/download/v1.22.1/dsh-plugin-startup-animation.tgz

Gitee 没有 latest 这种永久链接，地址里带着版本号，换版本要换地址 —— 想一次填对就用上面

GitHub 那条，或者直接下载文件后填本地路径。

方式三：命令行

# 从 npm（profile 需要能访问 npm registry）
dsh plugin --profile <你的 profile> add dsh-plugin-startup-animation

# 或从 GitHub 直链
dsh plugin --profile <你的 profile> add https://github.com/WWFZS/dsh-plugin-startup-animation/releases/latest/download/dsh-plugin-startup-animation.tgz

# 或从 Gitee 直链
dsh plugin --profile <你的 profile> add https://gitee.com/weiwenfengzs/dsh-plugin-startup-animation/releases/download/v1.22.1/dsh-plugin-startup-animation.tgz

本地 .tgz 文件或本地目录路径同样可以，把最后一个参数换掉即可。然后重启 dsh。

方式四：从源码

git clone https://github.com/WWFZS/dsh-plugin-startup-animation.git
# 或者从 Gitee 克隆（内容一致）
git clone https://gitee.com/weiwenfengzs/dsh-plugin-startup-animation.git

dsh plugin --profile <你的 profile> add /该仓库的绝对路径

官方 DSH 桌面版：请从应用内的 设置 → 插件 安装（方式一或方式二）。那个 profile

归应用的插件管理器管，命令行改动无效。

怎么用

打开 设置 → 开机动画（入口在侧栏的设置列表里）。

控件 · 作用

显示开机动画 · 总开关。关掉 = Harness 原生启动页。

视频带声播放 · 让视频播它自己的音轨（前提是文件里真的有音轨）。

开机音频 · 动画期间另播一段音频文件。

展示时长 · 3–30 秒，视频与壁纸共用。跳过不受它限制。

启动画面素材 · 当前素材预览，以及「恢复默认」（回到内置动画）。

MP4 / 壁纸 / 主题 / 音频 / 宠物 / 更新公告 六个页签 · 前两个与音频是素材分类：点卡片即选用、上传即入库。主题把任意视频或图片铺成 DSH 的界面背景。宠物是开关、大小、换宠物与动作预览（动作多的按分类展示 + 搜索）。更新公告是只读页，显示最新版 Release 的更新说明。

卸载 / 更新 · 装在当前 profile 里时显示。卸载插件会把它移除（设置与上传素材保留在磁盘）；有新版时版本号变成一个更新按钮。两者都要重启 DSH 才生效。从源码目录 link: 进来的安装不给更新按钮——那条依赖不指向任何版本。

没选素材时，插件会播放自己的内置动画（配色随应用深浅色走的旋转徽标）。

选了素材就用素材；「恢复默认」把它换回内置动画。把总开关关掉，才是 Harness

原生的启动页。

页面右上角的 立即刷新 会重载页面让新配置生效。任何设置都不需要重启 dsh。

界面主题（壁纸）

同一个素材库里的任意视频或图片都能当界面主题：进应用之后它铺在整个界面后面，

开机动画该怎么用还怎么用，两条互不影响。

有几段内置视频不适合铺满整屏（竖屏短剧、人物特写那种，铺上去只剩一团糊），

它们只在主题页签里被筛掉，素材库里照旧在、开机动画照旧能用：

550C-赛博控制台、薰衣草花语-等你爱我、dsh-大肥鱼、少司缘。

设置页 主题 页签里：

• 开关 —— 关掉就是原生界面，素材与预设都留着
• 五套预设 —— 换的是颜色：亮（白釉）、暗、原图、通用（绿）、通用（紫）。

每格右上角标着这套预设在这张壁纸上算出来的对比度。

点一下就换掉整套颜色，遮挡一律回到 0 —— 看到的一定是原样的壁纸

• 三根滑杆 —— 遮罩厚度

…(truncated)