dsh-umbrella-startup
DeepSeek Harness（DSH）的启动界面与开机动画插件，生化危机 · 保护伞公司（Umbrella Corporation）主题。
冷启动那几秒不再是一闪而过的加载卡片：
黑幕金属伞徽 → 暗红过曝 → 暗色「企业档案」底板 → 五步访问授权 → 红蓝色散故障揭幕 → ACCESS GRANTED
六段人声与两段界面音效原样沿用参考项目的素材，未做任何改动；视觉层为重新设计。
效果预览
截图取自离线预览页的第一幕「需要访问许可」。主题在 设置页 →「启动动画」→ 视觉 → 主题 切换；
两套配色的版式、文字位置、进度条与准星完全一致，只换底色与文字反相。
入场标题卡（深色）：横向锁定——左侧金属伞徽（最大 460px），右侧 UMBRELLA / CORPORATION / Our business is life itself。
入场标题卡
视觉识别
- 徽记：红白八段伞面——8 个 45° 等分扇形汇于圆心，外缘用二次曲线向内收成扇贝形，
每段带暗→亮→暗的金属渐变与极细深色分隔线；红白对应 Red / White Umbrella 两个部门。
- 配色：保护伞红
#d0021b + 白 + 黑。默认暗色：黑底、暗红径向光、红色电路走线与 CRT 扫描线；
浅色作为「档案白」备选。
- 底板：暗色 + 极淡方格 + 红色电路 + 上下红色压边 + 右缘竖排密级戳；
不使用黄黑警示条纹，避免读成通用工业警告。
与参考项目的关系
本插件的架构与运行逻辑移植自开源项目 6shenhonghong9/dsh-startup-screen（MIT），
并做了三处明确改动：
- 视觉层重做：配色、徽记、品牌块、装饰层、终幕版式全部替换为保护伞公司式的生物科技档案语汇。
- 命名空间独立：包名
dsh-umbrella-startup、路由 /dsh-umbrella、DOM 前缀 dub-、配置文件名 dsh-umbrella.json。
与 dsh-startup-screen 可以并存安装，不会互相覆盖配置或样式。
- 音频零改动：
lib/assets/ 下 8 个 mp3 与参考项目逐字节一致，播放、计时、TTS 回落逻辑保持不变。
徽记与装饰均为手写 SVG / CSS 绘制，不使用任何官方图片素材；「保护伞公司 / UMBRELLA CORPORATION」
仅作为主题文案出现。本项目为非官方同人主题，与 Capcom 及相关权利方无任何关联。
功能
六幕连贯序列 厂牌徽记 → 过曝洗白 → 档案底板 → 五步授权 → 色散揭幕 → 欢迎页。
中央一圈环形准星缓慢自转，缺口留在正下方，不压底部字幕。
可交互，不是播片 第一、二步停下来等按钮 / Enter / 空格（可在设置里关掉）。
右上角有 SKIP，Esc 也能直接进入主界面。
中文主字 + 英文等宽副标题 英文副标题逐字打出，像终端在接收数据。
真声台词 + 界面音效 前五句与终幕欢迎语使用内置真声素材；界面音效取自同一批素材。
浏览器要求先有一次用户手势才准出声，所以第一次点按钮之后才会听到声音。
语音没播完不会推进 每一步停留时长 = max(视觉基准, 实际音频时长 + 240ms)。
点得快不会把台词掐断；台词短也不会干等。
三十三项设置 身份名称、编号、权限等级、配色、速度、音色、语速、开口留白、每处文案……
都能在设置页实时修改。
三重卡死防线 脚本未启动 → 9 秒无条件放行；时间线停滞 → 15 秒强制揭幕；音频 onended 不来 → 时长 +1.5 秒兜底。
任何一条路径都不会把用户永久锁在黑屏里。
桌面端标题栏透明 Windows 桌面端播放期间把 titleBarOverlay 整层透明化，
最小化 / 最大化 / 关闭按钮与其底色一并隐藏，揭幕或跳过时自动还原。
六幕序列
| # | 中文主字 | 英文副标题 | 真声素材 | 交互 |
|---|
| 01 | 需要访问许可 | ACCESS PERMISSION REQUIRED | line-1.mp3 | 等待按钮 / Enter |
| 02 | 身份资料确认 | IDENTITY VERIFICATION | line-2.mp3 | 等待按钮 / Enter |
| 03 | 接收访问需求 | ACCESS REQUEST RECEIVED | line-3.mp3 | 自动 |
| 04 | 开始读取权限 | PERMISSION READ STARTED | line-4.mp3 | 自动 |
| 05 | 读取完毕 · 核验通过 | READ COMPLETE · VERIFIED | line-5.mp3 | 自动 |
| 06 | 欢迎 <身份名称> 访问 | ACCESS GRANTED | line-6.mp3 | 自动 |
音频与文案一一对应，因此六幕的主字与英文副标题保持与素材一致；保护伞主题体现在厂牌、底板、
密级戳、终幕与配色上。这样改文案不会造成「字幕和声音对不上」。
安装
前置条件：Node.js ≥ 20，DSH 已安装。插件零运行时依赖，不需要 npm install。
# 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 上也可以解压后双击 安装.cmd，脚本会自动识别 web / desktop 两个 profile。
详细步骤与验证方法见 INSTALL.md；桌面端标题栏处理见 DESKTOP.md；
音频素材与计时说明见 AUDIO-FIELDS.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 三档：session（每个浏览器会话一次）· daily（每天一次）· always（每次打开都播）。
目录结构
dsh-umbrella-startup/
├── package.json # DSH 插件契约：dsh.bundle.patch + dsh.client
├── cordis.patch.yml # 把 Host 半侧挂进 profile
├── lib/
│ ├── index.js # Host：注入 index.html、四条路由、配置读写
│ ├── client.js # 浏览器半侧：设置页「启动动画」+ 桌面端自举
│ ├── splash.js # 启动动画运行时（零依赖）
│ ├── splash.css # 保护伞主题样式
│ └── assets/*.mp3 # 8 个音频素材（原样沿用）
├── preview/index.html # 离线预览页（带控制台与设置面板模拟）
├── test/ # 4 个冒烟测试
└── docs/screenshots/ # 主题截图
开发与测试
node test/smoke-host.mjs # Host 路由 / 注入 / 配置 / 信任栅栏
node test/smoke-splash.mjs # 运行时初始化 / 选择器完整性 / 语音队列
node test/smoke-client.mjs # 设置面板渲染 / 保存 / 恢复默认
node test/smoke-desktop-boot.mjs# 桌面端自举与不重复播放
离线预览（不写盘、不依赖 DSH）：
# macOS / Linux
./open-preview.sh
# Windows
打开预览.cmd
也可以直接双击 preview/standalone.html：这是把 CSS/JS 内联后的单文件版本，
不依赖任何外部资源，适合拷给别人看或放进共享目录。
许可与素材
- 代码：MIT。架构与运行逻辑来自
dsh-startup-screen，其 MIT 许可与版权声明保留在 LICENSE。
- 音频：
lib/assets/ 内的人声与音效取自第三方素材，权利归原权利人。本项目未获得任何形式的授权或背书，
仅随插件原样分发以便本地体验；请勿用于商业用途或再分发。
- 视觉：徽记、装饰、版式均为本项目手写 SVG / CSS，不使用官方图片；主题名称仅作同人致敬。
- 商标：Umbrella Corporation / 保护伞公司 及相关名称归其权利方所有，本项目与权利方无关联。
如果你只需要最快启动，DSH 自带加载卡片已经够用；这个插件解决的是「那几秒本来就要等，不如让它有点内容」。
