@local/dsh-tide-whale-pet
Xixi，一款使用所提供素材包的三套服装、九种动作的蓝鲸桌面宠物；仅待机动作使用 RIFE 插帧，所有手势动作均使用原始 24 帧，以避免手脚重影。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Vertein-hy/super_blue_big_whale#6ca55955e9acd5b9ada77e1a7ea9c95289d2596aTide Whale Pet 以 @local/dsh-tide-whale-pet 发布，当前版本为 2.6.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Knit outfit portrait Cape outfit portrait Whale outfit portrait
A tiny blue-whale desktop companion plugin for DeepSeek Harness. It floats above the Harness shell, can be dragged anywhere, speaks Chinese/English, and plays nine hand-picked animations across three outfits.
The character artwork comes from the provided 648-frame sprite pack (3 outfits × 9 actions × 24 source frames). No hand-drawn replacement character is shipped.
/api/file route (when the Host's asset-root injection is present) or through the plugin's own read-only /api/tide-whale-pet/assets/... route on first load..webp/.json files under assets/; it is not a general file server. No build step.git clone https://github.com/Vertein-hy/super_blue_big_whale.git
@local/dsh-tide-whale-pet; its package manifest and cordis.patch.yml are included./api/tide-whale-pet/assets/... for first loads; after a reload the Client can also use the authenticated /api/file route via the injected absolute asset directory.There is no npm publish and no compile step. The client is a plain Harness client bundle.
| Interaction | Result |
|---|---|
| Drag the character | Move the pet; position is persisted |
| Click the head | Surprise |
| Click the body | Wave |
| Click while sleeping | Wake up |
Click 汐汐 or ••• | Open wardrobe / action panel |
| Auto toggle | Random wave/jump/surprise while idle |
| Reset button | Return to the bottom-right corner |
Preferences (position, outfit, auto-play) are stored in localStorage under dsh-tide-whale-pet:v2.
| Action | Source frames | Playback frames | Mode | FPS | Duration |
|---|---|---|---|---|---|
| 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 |
Only idle is interpolated. The eight gesture actions deliberately stay at 24 frames because RIFE duplicates or warps hands and legs when a limb crosses the body (the clearest case is the cover-face surprise action). To avoid making those actions feel faster after dropping the in-betweens, they play at 6fps (4.0 s per cycle). This is intentionally slower and choppier than the 96-frame idle, but the limbs stay correct.
For every action, the first and last frames are used to establish a fixed target. Frames are shifted to that target instead of being calibrated relative to the previous frame, so offsets cannot accumulate. Walk/run lock horizontal position and keep a small vertical gait bob; jump locks horizontal position and keeps only up/down movement; the other 24-frame actions are locked on both axes.
.
├── 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
The client canvas reads one 320×320 cell at a time from the 8-column sheets. The idle sheet with 96 frames is 2560×3840; the 24-frame action sheets are 2560×960. Both stay below common 4096-pixel texture limits.
The sprite artwork is the supplied 648-frame pack, not a redraw. See THIRD_PARTY_NOTICES.md for the artwork/attribution caveat.
The idle 96-frame variant was generated offline with the RIFE 4.9 ONNX model; the model itself is not distributed in this repository. All gesture actions use the original pack frames. Only the resulting sprite sheets are bundled.
client.js is a plain window.__ModuleLoader__ client bundle; it registers itself in shell.overlay.index.js listens to webserver/index-inject and publishes __DSH_TIDE_PET_ASSET_ROOT__.index.js also registers a read-only prefix route /api/tide-whale-pet/assets that safely serves WebP/JSON files from assets/. It only allows GET/HEAD, a fixed path pattern, and no directory traversal.client.js uses the injected absolute root with /api/file when available; otherwise it falls back to the read-only asset route. If both fail, it shows an asset-load error with a retry button instead of silently using a developer path./api/file?path=... route, which also works inside dsh-app://app/; the direct route is used for first loads.The source code in this repository is released under the MIT License; see LICENSE.
The bundled character artwork and derived animation frames are not covered by the MIT license. They originate from the third-party 648-frame sprite pack supplied for this project; see THIRD_PARTY_NOTICES.md.