前言¶
DeepSeek Harness（DSH）在 web 或桌面端冷启动时，默认往往只是一段很短的加载界面。对经常开闭 DSH 的开发者来说，这几秒通常只能盯着空白或通用卡片。社区里已有把启动页做成可交互序列的插件思路；dsh-umbrella-startup 在此基础上，把视觉与文案统一成《生化危机》保护伞公司（Umbrella Corporation）风格的「企业档案」访问流程，并保留真声台词与界面音效。下面介绍它是什么、能做什么，以及如何安装与配置。
这是什么¶
dsh-umbrella-startup 是 DSH 的启动界面与开机动画插件，维护者为 Wang341223，在 SkillHub 插件目录 中归类为「趣味换装」。源码托管于 GitHub，当前 package 版本为 1.0.0，代码许可为 MIT。
插件不改动 DSH 核心逻辑，而是在 Host 侧注入路由与页面资源，在浏览器半侧挂接设置页「启动动画」入口。架构与运行逻辑移植自开源项目 6shenhonghong9/dsh-startup-screen（MIT），包名、路由 /dsh-umbrella、DOM 前缀 dub-、配置文件 dsh-umbrella.json 均独立命名，可与原启动屏插件并存。项目说明中明确：徽记与装饰为手写 SVG/CSS，非官方素材；音频来自第三方素材，未声明商业授权，仅随插件本地体验分发。
核心功能¶
六幕连贯序列¶
冷启动时播放固定流程，而非单纯播片：
- 黑幕金属伞徽
- 暗红过曝
- 暗色「企业档案」底板
- 五步访问授权（其中前两步可等待用户操作）
- 红蓝 chromatic 故障揭幕
- 终幕
ACCESS GRANTED并进入主界面
中央有缓慢自转的环形准星，缺口在正下方，不遮挡底部字幕。中文主标题配合英文等宽副标题逐字打出。
交互与安全兜底¶
- 第一、二幕会等待按钮、
Enter或空格（可在设置中关闭requireInteraction）。 - 右上角
SKIP，Esc也可直接进入主界面（受allowSkip控制）。 - 浏览器需用户手势后才允许出声；每一步停留时长取视觉基准与「实际音频时长 + 240ms」的较大值，避免台词被点跳掐断。
- 脚本未启动 9 秒放行、时间线停滞 15 秒强制揭幕、音频
onended缺失时按时长 +1.5 秒兜底，避免永久黑屏。 - Windows 桌面端播放期间可透明化
titleBarOverlay，揭幕或跳过后还原。
主题与设置¶
默认深色（黑底、暗红径向光、红色电路与 CRT 扫描线）；浅色「档案白」可在 设置页 → 启动动画 → 视觉 → 主题 切换，版式一致仅换底色与文字反相。主色保护伞红 #d0021b，色散故障两色可在配置中调整。
README 称共有三十三项设置：身份名称、编号、权限等级、配色、速度、音色、语速、文案等，可在 DSH 设置页修改并即时生效。mode 三档：session（每个浏览器会话一次）、daily（每天一次）、always（每次打开都播）。
六幕与音频对应¶
| 幕 | 中文主字 | 英文副标题 | 交互 |
|---|---|---|---|
| 01 | 需要访问许可 | ACCESS PERMISSION REQUIRED | 等待按钮 / Enter |
| 02 | 身份资料确认 | IDENTITY VERIFICATION | 等待按钮 / Enter |
| 03 | 接收访问需求 | ACCESS REQUEST RECEIVED | 自动 |
| 04 | 开始读取权限 | PERMISSION READ STARTED | 自动 |
| 05 | 读取完毕 · 核验通过 | READ COMPLETE · VERIFIED | 自动 |
| 06 | 欢迎 <身份名称> 访问 |
ACCESS GRANTED | 自动 |
lib/assets/ 下 8 个 mp3 与参考项目逐字节一致，文案与素材一一对应，不宜随意改主字以免声画不同步。
安装与启用¶
前置条件：Node.js ≥ 20，DSH 已安装。插件零运行时依赖，安装前不必在插件目录执行 npm install。
先在插件源码目录打包，再按 profile 安装（命令来自项目 README）：
# 1) 在插件目录打包
npm pack
# → dsh-umbrella-startup-1.0.0.tgz
# 2) web profile
dsh plugin --profile web add ./dsh-umbrella-startup-1.0.0.tgz
# 3) 重启 dsh web（关掉启动器窗口再重新打开）
桌面端（DeepSeek Harness Desktop）须完全退出（含托盘图标）后执行：
dsh plugin --profile desktop add ./dsh-umbrella-startup-1.0.0.tgz
Windows 也可解压 tgz 后双击 安装.cmd，脚本会识别 web / desktop 两个 profile。更细的验证步骤见仓库内 INSTALL.md；桌面标题栏行为见 DESKTOP.md。
典型用法¶
配置文件¶
默认路径为 $DSH_HOME/dsh-umbrella.json（一般为 ~/.dsh/dsh-umbrella.json），也可仅在设置页修改：
{
"enabled": true,
"mode": "session",
"theme": "dark",
"speed": 1,
"requireInteraction": true,
"allowSkip": true,
"identity": "DR. M. HARTLEY",
"identityId": "0087",
"accessLevel": "3",
"accent": "#d0021b",
"glitchA": "#d0021b",
"glitchB": "#1b4f9c"
}
日常可把 mode 设为 daily，避免每次会话都播完整六幕；需要演示时再改为 always。
离线预览¶
不依赖 DSH 时，可在仓库根目录用脚本打开预览页，或直接打开内联单文件 preview/standalone.html 给他人看效果：
# macOS / Linux
./open-preview.sh
Windows 使用 打开预览.cmd。
冒烟测试（维护者）¶
node test/smoke-host.mjs
node test/smoke-splash.mjs
node test/smoke-client.mjs
node test/smoke-desktop-boot.mjs
适用场景与注意¶
适合谁：希望在 DSH 冷启动那几秒看到完整主题体验、且接受生化危机保护伞同人视觉与内置台词的用户。若只追求最快进主界面，DSH 自带加载卡片已足够；本插件的价值在于「本来就要等的几秒，换成有结构的交互与音效」。
权限与安全：DSH 插件以当前 dsh 进程权限运行。安装前应自行阅读 GitHub 仓库 源码、LICENSE 与 NOTICE.md，确认接受 MIT 代码许可及音频、商标免责声明。SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
并存：与 dsh-startup-screen 可同时安装，配置与样式不会互相覆盖；实际启用哪一套取决于各自 enabled 与 DSH 插件加载顺序，安装后应在目标 profile 上实测一次。
结尾¶
dsh-umbrella-startup 把 DSH 启动页做成可跳过、可配置的六幕保护伞主题序列，web 与 Desktop 共用同一套 Host/client 与 dsh-umbrella.json。目录页：https://www.skillhub.cn/plugins/Wang341223/dsh-umbrella-startup；源码与安装说明：https://github.com/Wang341223/dsh-umbrella-startup。
