鲸鱼娘开场 · 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/：

• 鲸鱼娘造型参考
• 深蓝配色参考