鲸鱼娘开场 · dsh-whale-startup
DeepSeek Harness 桌面端的独立开场动画插件：鲸鱼娘在原生加载页等候，工作台就绪后拍走加载提示，再回到右下角。
原生加载页与鲸鱼娘
观看 3.8 秒演示。图和视频为设计样片；安装后的底层界面是正在运行的真实工作台。
功能
- 保留原生
HARNESS、旋转圆环与加载状态，同步真实插件进度。
- 通过工作台
shell.overlay 的 React layout effect 确认提交完成，再播放退场。
- 原生失败提示保持可见；素材或就绪桥不可用时回退到原生界面。
- 衔接已有
dsh-whale-widget 的位置和大小，结束后恢复原挂件；未安装挂件时，动画结束后退出。
- 遵循系统“减少动态”偏好，改为淡入淡出；默认无声音。
- 通过 dsh 原生插件机制加载，不修改应用包或签名，不增加模型提示或工具。
角色采用六个关键姿势的有限动画。演示视频的 60 fps 是输出采样帧率。
安装
先克隆本仓库，或下载源码 ZIP 并解压。仓库已包含构建产物，安装前不需要下载依赖或重新构建。
gh repo clone chencujinlin/dsh-whale-startup
在 DeepSeek Harness 桌面端打开 插件 → 添加插件 → 安装第三方插件，输入克隆目录的绝对路径。确认 dsh-whale-startup 已启用后，退出并重新打开应用，使桌面壳重新收集启动注入。
本地目录安装可能使用链接，请保留该目录。在插件列表关闭插件即可停用；卸载后重启可清除桌面壳缓存的启动行。旧行的素材路由不可用时会安静回退，不阻断启动。
兼容性与验证
已在 macOS 的 DeepSeek Harness 0.2.1-rc.2 上完成真实应用冷启动验证，确认等候、拍击、真实工作台交接和最终挂件恢复。其他平台未做实机验证。
插件依赖 webserver/index-inject、shell.overlay、[data-dsh-boot]，以及可选的挂件 DOM。未来 dsh 版本改变这些接口时，需要重新验证。未检测到接入点时保留原生启动。
自动检查覆盖持续加载、失败、工作台提交、就绪桥缺失、停用、减少动态和损坏素材回退；宿主检查覆盖注入去重、路由访问校验、GET/HEAD 与清理。
开发
构建使用 Python 3 标准库；宿主测试使用 Node.js 22 或更高版本。浏览器检查使用 Playwright 1.63.0。
python3 build.py
node --test tests/host.test.mjs
uv run --with 'playwright==1.63.0' playwright install chromium
uv run --with 'playwright==1.63.0' python tests/check_browser.py
| 文件 | 用途 |
|---|
src/bootstrap.js | 动画运行时 |
lib/client.js | 工作台提交信号桥 |
lib/index.js | 启动注入与受宿主访问校验保护的只读素材路由 |
build.py | 将六张角色 PNG 内嵌到 lib/bootstrap.js |
cordis.patch.yml | 原生插件挂载声明 |
角色素材随包提供，运行时不访问外网。构建与安装不依赖本仓库之外的样片工程。检查产生的本机截图、安装记录和配置备份不属于仓库内容。
形象参考
造型与配色依据用户指定的两份参考，生成的六姿势素材保存在 assets/：
