skymecode/dsh-deep-diving

dsh-deep-dive-skins

English · 下载 Release

让蓝色大肥鱼（鲸鱼娘）陪你 Deep diving：思考、奔跑、堆雪人、挥手……
在同一轮求索中持续切换动作，同时保留原有四套矢量皮肤。

动作预览

八种鲸鱼娘动作，深浅背景对照

这是素材真实帧的对照图，不是浏览器截图。执行 pnpm preview 可打开
交互预览：直接加载发布 bundle 和真实设置卡片，仅模拟 Host 存储。
可测试开始/结束求索、保存设置和卸载插件。

功能

- 默认蓝色大肥鱼 whale-maid，8 种透明动画，每段 100 帧、10fps。
- 同一轮持续轮换：思考 → 奔跑 → 堆雪人 → 挥手 → 写代码 → 吐泡泡 →
摇摆舞 → 休闲呼吸。默认每 10 秒切换，可调至 60 秒。
- 关闭轮换后循环单个动作；random 模式按间隔换皮肤，不连续重复。
- 保留 whale 鲸鱼娘下潜、dafeiyu 圆滚滚大肥鱼、catgirl 猫娘、
mermaid 人鱼四套矢量皮肤。
- 设置立即生效：开关、皮肤、14–96px 尺寸、起始动作、持续轮换、间隔、
是否替换中英文状态文案。
- 同时识别英文 Deep diving... 和新版中文 深度求索中...。
- 系统“减少动态效果”会停用动画及轮换；后台页面暂停；求索结束或卸载后
清理定时器、观察器、订阅，恢复原始文字。
- 使用 dsh-pet working-whale 标记避免双重装饰，关闭时恢复之前的装饰。
不修改 Harness 源码，不依赖宠物状态服务。
- 素材随包分发，运行时不请求 GitHub 或外部 CDN。

安装 / 升级

直接安装 GitHub Release 包，无需 npm 发布：

dsh plugin --profile web add https://github.com/skymecode/dsh-deep-diving/releases/download/v0.2.1/dsh-deep-dive-skins-0.2.1.tgz

如果你使用的 profile 不是 web，请替换为实际名称。升级后重启 dsh web
并刷新页面。已有设置不会被覆盖：如果以前保存过其他皮肤或较小的尺寸，
请在「设置 → 插件配置」中选择「蓝色大肥鱼 · 鲸鱼娘」，开启「持续轮换」，
尺寸建议设为 48–64px。

从源码安装：

git clone https://github.com/skymecode/dsh-deep-diving.git
cd dsh-deep-diving
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add link:$(pwd)

兼容性

当前 SDK / 类型检查基线为官方
dsh-v0.1.5-rc.2，
即 2026-09-13 检查时的最新发布版。peer 范围接受 0.1.5 alpha/RC 系列，
包括当时 npm latest 指向的 0.1.5-rc.1；同时保留 0.1.3-alpha.2、
0.1.2-rc.1、0.1.1-rc.2、0.1.1-rc.1、0.1.0-rc.8 和 0.1.0-rc.7。

- 设置槽位仍使用 key: 'deep-dive-skins'，不误用列表槽位的 id/order。
- 移除对已拆分的 dsh-client-runtime 浏览器模块，以及已移除的 Host
installSettingsSection / settingsNamespace 导出的运行时依赖。
- Host 通过 ctx.settings.register 注册；客户端通过跨版本共有的
set/unset 写入并回读，不混用旧 {field} 与新版 {path} 的批量接口。
- 优先使用官方 settingsScope；存在旧版 webUiSettings 绑定器时兼容回退。
旧配置保留，新字段有默认值。

自动验证覆盖发布 factory、两套绑定器、真实 React 表单、当前 SDK Host 注册与
DOM 生命周期。28 项单元测试还覆盖实际安装的 SDK 版本、每秒更新的求索计时器
以及会话切换；另用已发布的 0.1.1-rc.2 provider 模块重新验证了 Host 注册和卸载。

发布 bundle 的预览页已通过 Tabbit 浏览器验证，覆盖动画、设置与生命周期，
其中 Host 存储为模拟实现；不代表每个历史 Harness 版本均通过完整会话端到端测试。

设置项

| 字段 | 取值 / 默认值 |
| --- | --- |
| 启用插件 | 开 |
| 皮肤 | whale-maid / whale / dafeiyu / catgirl / mermaid / random |
| 装饰大小 | 14–96px，默认 48 |
| 起始动作 | think / run / snow / wave / code / bubbles / dance / idle |
| 持续轮换 | 开；关闭后仍循环播放所选动作 |
| 轮换间隔 | 10–60 秒，默认 10 秒 |
| 替换状态文案 | 关；开启后跟随界面语言 |

开发

pnpm typecheck
pnpm test          # 行为、设置写入、keyed 注册、版本范围
pnpm build         # 类型声明 + Host ESM + 浏览器 lazy factory
pnpm test:bundle   # 发布包、真实 React 设置卡片、真实 Host SDK
pnpm test:assets   # 透明通道、帧尺寸、动画差异、体积预算
pnpm preview       # 本地交互预览

scripts/import-whale-maid.mjs 从固定上游提交复现素材，需要支持 libvpx-vp9
与 PNG 的 ffmpeg，已存在的输出会跳过。
node scripts/build-asset-preview.mjs 重新生成素材帧对照图。
动画由 CSS steps(100) 播放，每个插件挂载仅使用一个轮换计时器。
浏览器 bundle 约 4MB，内嵌全部素材，不依赖不同加载器的静态资源路径约定。

素材来源与许可

在 GitHub 的
PC2005-cloud/dsh-pet
找到了与参考图相符的蓝发鲸鱼娘动画，已从透明 VP9 视频转为 WebP 精灵条带。
插件不分发用户上传的截图。

注意：上游素材允许开源使用，禁止商用。 此限制适用于鲸鱼娘图片及其
在 bundle / 预览中的副本，不属于 Apache-2.0 素材；详见
素材来源与许可，商用请联系上游作者授权。

插件代码采用 Apache-2.0。复制的构建与卡片文件保留 dsh-web-ui 来源声明，
见文件头及 LICENSE。