dsh-deepsea-echo · 深海回响启动动画
给 DeepSeek Harness Web 界面加一段约 4.6 秒的
明日方舟风格全屏启动动画：PRTS 终端自检 → 声呐扫描 → 全息锁定 → 干员档案 → 深海回响定格。
深蓝工业 HUD、鲸鱼娘全息登录与干员档案，播放结束自动淡出进入界面。
画面中的品牌徽记与背景剪影使用 DeepSeek 官方鲸鱼标志（商标归 DeepSeek，仅用于标识
DeepSeek Harness 生态；见 NOTICE-ARTWORK.md）。
> 每次打开或刷新 DSH Web 页面时自动播放；点击任意位置 / 按 Esc 立即跳过；
> 设置 →「启动动画」里可以关掉、改时长（3.6s / 4.6s / 5.0s）、单独开关启动音效、立即重播。
分镜 / Storyboard
| 时间 | 画面 | 音效 |
|---|---|---|
| 0.0 – 2.0s | PRTS 终端自检：深蓝终端 HUD、逐字启动日志、「深海回响计划」标题、声呐扫描环 + 雷达扫描线 | 深海低频底噪、终端滴答、声呐 ping |
| 1.0 – 2.1s | 全息锁定：目标环展开，Q 版鲸鱼娘以扫描线遮罩 + RGB 分离逐段显现，TARGET ACQUIRED |
上扬噪声扫频、电子碎响 |
| 2.0 – 3.6s | 干员档案：切镜黑场 → 绝密标签、鲸鱼娘 / WHALE-01、六项属性条填满、AUTHORIZED 印章、全身立绘滑入 + 光扫 |
低频撞击、打字细响、印章「啪」 |
| 3.6 – 4.4s | 深海回响定格：扫描光刃炸开、鲸鱼徽记描边点亮、DEEPSEEK HARNESS 字标与「深海回响 · 启动完成」 |
上升 riser → 重低音 + 钟声泛音 |
| 4.4 – 4.6s | 白光闪一下，遮罩淡出，露出下面的 DSH 界面 | 尾音淡出 |
配色：深海军蓝底（#01040c → #0a2a52）+ DSH 蓝光效（#4d6bfe）+ 冰青高光（#8be8ff），
切角面板 / 等宽字 / 细线刻度 / 菱形装饰，尽量贴近明日方舟的界面语言。
完整动效录屏（70 帧）：preview/startup-animation.webp
可交互预览：preview/index.html（?t=2500 可定格在 2.5s）
音效（4 套原创配乐，可切换 / 可关闭）
启动音效是代码合成的原创配乐（scripts/make-sfx.py，无采样、无版权素材），
共 4 套风格 + 关闭，与分镜时间轴严格对齐：
| 预设 | 风格 |
|---|---|
| 深海回响（默认） | 明日方舟 PV 感的电子管弦：D 小调 138 BPM，暗色 pad、工业鼓组、八分音符贝斯、braam drop、合唱尾音 |
| 凛冬管弦 | 弦乐 ostinato + 定音鼓 + 铜管 stab + 合唱，压迫感更强的纯管弦编制 |
| 霓虹脉冲 | 150 BPM 工业电子：四拍底鼓、锯齿贝斯 16 分、滤波琶音、glitch 碎响、sub drop |
| 静海氛围 | 没有鼓：暖 pad + 钢琴钟声 + 声呐 ping + 柔和收尾，适合安静的启动 |
| 关闭 | 完全静音 |
在三个设置入口（设置 →「启动动画」、插件页配置区、插件区「启动动画」标签页）里都能看到
「启动音效」的按钮组，五选一（含关闭），与动画总开关互相独立。
浏览器自动播放策略可能拦下第一次发声；被拦时保持静音、不会报错，点击一次界面后自动恢复。
安装
# 在 DSH 命令行里
dsh plugin --profile web add https://github.com/cshengyi023-collab/dsh-deepsea-echo
插件包含预构建的 lib/client.js，安装后不需要额外的构建步骤或构建脚本授权。
使用
- 播放：打开或刷新 DSH 页面时自动全屏播放一次；
- 跳过：播放中点击任意位置，或按
Esc； - 设置（三个入口显示同一套控件，改动实时同步）：
- 设置 →「启动动画」（独立设置页）
- 设置 → 插件 →「深海回响 / dsh-deepsea-echo」的插件页 → 下方「启动动画」配置区
- 设置 → 插件 →「启动动画」标签页
在里面可以：启用/关闭启动动画、改播放时长（3.6 / 4.6 / 5.0 秒）、五选一选择启动音效
（深海回响 / 凛冬管弦 / 霓虹脉冲 / 静海氛围 / 关闭）、立即重播动画。
- 偏好存储：localStorage["dsh-deepsea-echo:v1"]（会从旧的 dsh-whale-startup:v1 自动迁移）。
卸载
dsh plugin --profile web remove dsh-deepsea-echo
实现
- 纯 client 插件（
dsh.client.platform = "web"）：host 半边只有一个空的apply()，
让包在 profile 里有 Loader entry；浏览器半边由 DSH 的 client module system 以
/plugins/dsh-deepsea-echo/client.js提供给页面。 lib/client.js是手写的 lazy-CJS bundle（window.__ModuleLoader__.load({ id, factory })），
立绘、颗粒贴图与音效都以 data URI 内嵌，离线可用、无第三方依赖。- 插件
apply()时立刻把全屏遮罩挂到document.documentElement上（早于 shell 首帧），
播放完或插件被禁用时移除全部 DOM、样式、音频与事件监听；另有看门狗兜底，渲染出错也不会卡住界面。 - 动画是一条由
requestAnimationFrame驱动的可寻址时间轴（render(t)，基准 4600ms）：
DOM 变换、Canvas 粒子、遮罩、逐字文本都在同一帧函数里计算；时长选项只是对时间轴整体缩放
（音效随之时长等比变速）。 - 设置页注册在
settings.section插槽（iddeepsea-echo）。
开发
# 重新生成 lib/client.js（把 assets/ 里的立绘与音效内嵌进 bundle）
node scripts/build.mjs
# 重新合成 4 套启动配乐（纯 Python，无第三方音频库）
python scripts/make-sfx.py
# 本地预览（浏览器打开，自动播放；?t=2500 定格在 2.5s）
open preview/index.html
# 用无头 Chrome 逐帧截图，重建 preview/startup-animation.webp 与 storyboard.png
chrome --headless=new --window-size=960,540 \
--screenshot=frame.png "file:////preview/index.html?t=2500"
python scripts/make-preview-assets.py
目录
lib/index.js host 半边（空 apply）
lib/client.js 浏览器半边（构建产物，内嵌立绘/贴图/音效）
src/client.template.js 动画源码（模板，含 __ASSET_*__ 占位）
cordis.patch.yml bundle patch：把插件插进 profile
assets/ 角色立绘、插件图标（icon-source.svg → plugin-icon.png）、市场截图、音效
preview/ 动效预览、关键帧、可交互预览页
scripts/ 构建 / 音效 / 图标 / 预览素材脚本
许可
- 代码、音效、图标：MIT（见
LICENSE）。音效由仓库脚本合成，图标由
assets/icon-source.svg绘制渲染，均无第三方素材。 - 角色美术：不适用 MIT，按 CC BY-NC-SA 4.0 随仓库非商业分发，署名链为
上善（角色原案）→ ZipZipPipe（女仆装再设计）→ Small-tailqwq（本仓库所用素材版本）。
详见NOTICE-ARTWORK.md与LICENSE-ARTWORK.md。
商业使用请替换为你有权使用的立绘。
English
A startup animation for the DeepSeek Harness Web GUI, Arknights-flavoured: a PRTS terminal boot,
sonar scan, hologram lock-on and an operator file that end in a deep-sea lockup (about 4.6 s),
followed by a fade into the UI. It plays full-screen on every page load, can be skipped with a
click or Esc, and can be switched off, re-timed (3.6s / 4.6s / 5.0s), replayed, or scored with
one of four original synthesized cues / sound off, from three Settings entry points (the
「启动动画」 section, the plugin's own page, and a 启动动画 tab inside Plugins).
Implemented as a client-only DSH plugin with a hand-written lazy-CJS bundle and embedded
artwork/audio — no build step and no runtime dependencies. Code, sound and icon are MIT; the
character artwork is CC BY-NC-SA 4.0 (see NOTICE-ARTWORK.md).
关键词 / Keywords
dsh · dsh-plugin · deepseek-harness · deepseek · arknights · 明日方舟 · 启动动画 ·
开幕动画 · 开机动画 · boot animation · splash screen · startup animation · 鲸鱼娘 ·
whale girl · PRTS · 声呐 · sonar · 干员档案 · operator file · anime UI · web ui ·
sound design · 配乐
