汐汐蓝鲸桌宠 Vertein-hy/super_blue_big_whale

Super Blue Big Whale · 汐汐

一个小巧的蓝鲸桌面伙伴插件，给 DeepSeek Harness 用。它浮在 Harness 外壳上方，能拖到任意位置，会说中文和英文，三套服装共九段精选动画。

角色美术来自随附的 648 帧精灵包（3 outfits × 9 actions × 24 source frames）。没有附带手绘的替换角色。

功能

- 3 套服装：knit、cape、whale。
- 9 个动作：idle、walk、run、jump、wave、sit、sleep、dance、surprise。
- 190 px 宠物，带紧凑顶栏和动作 / 衣橱面板。
- 拖拽、点击反应、自动待机行为，每套皮肤各有立绘和缩略图。
- 循环接缝优化：把每段循环旋转到首尾衔接最顺的一对帧。
- 根节点锁定在固定锚点，角色不会在桌面上乱跑；jump 保留垂直位移。
- 只有 idle 用 RIFE 4.9，把 24 源帧扩到 96 帧；所有手势动作（walk、run、jump、wave、sit、sleep、dance、surprise）都用原始 24 帧。这样能避开 RIFE 在四肢交叉或遮挡身体时生成的重影手脚。
- Idle 图集固定在客户端缓存里；从一次性动作返回时不会闪加载卡片。
- 资源有两种加载方式：Host 注入了资源根目录时，走 Harness 带鉴权的 /api/file 路由；首次加载时，走插件自带的只读路由 /api/tide-whale-pet/assets/...。
- Host 路由只放行 assets/ 下的静态 .webp / .json 文件，不是通用文件服务器。无需构建步骤。

安装

1. 把仓库克隆到一个固定位置：
git clone https://github.com/Vertein-hy/super_blue_big_whale.git

2. 在 DeepSeek Harness 的插件管理器里，把克隆下来的文件夹作为本地 bundle 安装。bundle 包名是 @local/dsh-tide-whale-pet，包清单和 cordis.patch.yml 都已包含。
3. 建议刷新页面。Host 会注册一个小的只读资源路由 /api/tide-whale-pet/assets/...，供首次加载使用；刷新后，Client 也能通过注入的绝对资源目录走带鉴权的 /api/file 路由。
4. 如果宠物报资源加载错误，点一次 重试（Host 半边一应用，路由就注册好了），或者再刷新一次。

没有 npm 发布，也没有编译步骤。客户端就是一个普通的 Harness 客户端 bundle。

操作

| 交互 | 结果 |
| 拖动角色 | 移动宠物；位置会持久保存 |
| 点击头部 | Surprise |
| 点击身体 | Wave |
| 睡觉时点击 | 唤醒 |
| 点击 汐汐 或 ••• | 打开衣橱 / 动作面板 |
| 自动切换 | 空闲时随机播放 wave/jump/surprise |
| 重置按钮 | 回到右下角 |

偏好设置（位置、装扮、自动播放）存在 localStorage 里，键名 dsh-tide-whale-pet:v2。

动画时序

| 动作 | 源帧数 | 播放帧数 | 模式 | FPS | 时长 |
| idle | 24 | 96 | loop | 15 | 6.4 s |
| walk | 24 | 24 | loop | 6 | 4.0 s |
| run | 24 | 24 | loop | 6 | 4.0 s |
| jump | 24 | 24 | once | 6 | 4.0 s |
| wave | 24 | 24 | once | 6 | 4.0 s |
| sit | 24 | 24 | loop | 6 | 4.0 s |
| sleep | 24 | 24 | loop | 6 | 4.0 s |
| dance | 24 | 24 | loop | 6 | 4.0 s |
| surprise | 24 | 24 | once | 6 | 4.0 s |

只有 idle 做了插帧。八个手势动作刻意保持 24 帧，因为肢体横过身体时，RIFE 会把手脚复制或扭曲（最明显的是捂脸 surprise 动作）。为了不让这些动作在去掉中间帧后显得更快，它们以 6fps（每轮 4.0 s） 播放。这比 96 帧的 idle 更慢、更卡顿，但肢体不会出错。

根节点校准

每个动作都用首帧和末帧确定一个固定目标。所有帧向该目标平移，而不是相对上一帧校准，所以偏移不会累积。walk/run 锁定水平位置，只保留轻微的垂直步态起伏；jump 锁定水平位置，只保留上下移动；其余 24 帧动作两个轴都锁定。

项目结构

.
├── assets/
│ ├── {knit,cape,whale}/{action}.webp # 8×12 or 8×3 sprite sheets
│ ├── portraits/ # 256×256 portraits
│ ├── thumbs/ # action-menu thumbnails
│ └── rife-manifest.json # frame counts, loop seams, offsets
├── client.js # client overlay, canvas player, panel
├── index.js # host half, asset route + injection
├── cordis.patch.yml # bundle entry
├── locale/{zh,en}.json # localization metadata
├── icon.png
├── package.json
├── README.md
├── LICENSE
└── THIRD_PARTY_NOTICES.md

客户端 canvas 每次从 8 列的图集里读取一个 320×320 单元格。96 帧的 idle 图集是 2560×3840；24 帧的动作图集是 2560×960。两者都在常见的 4096 像素纹理上限以内。

美术素材与 RIFE

精灵图素材来自提供的 648 帧包，不是重绘。素材与署名注意事项见 THIRD_PARTY_NOTICES.md。

96 帧的 idle 变体用 RIFE 4.9 ONNX 模型离线生成；模型本身不在本仓库分发。所有手势动作都用原始包里的帧。仓库只打包最终生成的精灵图集。

开发

- client.js 是普通的 window.__ModuleLoader__ 客户端 bundle，在 shell.overlay 里注册自己。
- index.js 监听 webserver/index-inject，并发布 __DSH_TIDE_PET_ASSET_ROOT__。
- index.js 还注册了一条只读前缀路由 /api/tide-whale-pet/assets，从 assets/ 安全地提供 WebP/JSON 文件。这条路由只允许 GET/HEAD，路径模式固定，且禁止目录穿越。
- client.js 优先使用注入的绝对根路径，配合 /api/file（如果可用）；否则回退到只读资源路由。两者都失败时，它会显示资源加载错误并给出重试按钮，而不是悄悄使用开发者路径。
- 资源通过带鉴权的 /api/file?path=... 路由加载，这条路由在 dsh-app://app/ 内也能用；首次加载走直连路由。

License

本仓库的源代码以 MIT License 发布；见 LICENSE。

随附的角色美术素材及衍生的动画帧不在 MIT 许可范围内。它们来自为本项目提供的第三方 648 帧精灵图包；见 THIRD_PARTY_NOTICES.md。

Credits

- DeepSeek Harness：提供插件/客户端插槽与带鉴权的文件路由。
- FuryTMP/RIFE_fp32：提供用于生成中间帧的 RIFE ONNX 权重（MIT）。
- 原始鲸鱼少女精灵图包的创作者。