dsh-deep-dive-skins

中文 · Releases

An animated blue whale maid for the DeepSeek Harness Web GUI's Deep diving… status row. She thinks, runs, builds a snowman and more, changing actions throughout the same turn. Four vector skins remain available.

Preview

Real sprite frames, not a browser screenshot. Run pnpm preview for a live preview with the release bundle and actual settings card over a simulated Host scope. Start/end a turn, change settings and test plugin unloading there.

Features

• Default whale-maid: eight transparent, 100-frame animations, 10fps each.
• Continuous rotation within one turn: think → run → snow → wave → code → bubbles → dance → idle. Default interval: 10 seconds (adjustable to 60).
• Turn rotation off to loop one action. random changes the skin at each interval without repeating the previous skin.
• Existing whale, dafeiyu, catgirl, and mermaid vector skins retained.
• Live settings: enable/disable, skin, size (14–96px), first action, rotation, interval and optional localized status text.
• Handles both Deep diving... and the current Chinese 深度求索中... row.
• Reduced motion stops animation/rotation; hidden tabs pause. Turn completion and unloading clean up timers, observers, listeners and changed text.
• Reuses dsh-pet's working-whale marker to avoid stacked ornaments, restoring displaced ornaments on disable. No Harness source patch or pet server needed.
• Sprites are bundled locally: no runtime requests to GitHub/CDNs.

Install / upgrade

Install the GitHub Release tarball (npm publication is not required):

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

Use your own profile name if it is not web. Restart dsh web and refresh the page after upgrading. Existing settings are preserved: choose Blue whale maid, enable Continuous rotation, and set 48–64px if you previously saved a vector skin or a smaller size.

Development install:

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)

Compatibility

Current SDK/type-check baseline: official dsh-v0.1.5-rc.2, the newest release checked on 2026-09-13. Peer ranges accept the 0.1.5 alpha/RC line, including 0.1.5-rc.1 (the npm latest channel at that time), and retain 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 and 0.1.0-rc.7.

• Settings cards register using key: 'deep-dive-skins' on settings.plugin.item; no list-slot id/order.
• No dependency on the removed dsh-client-runtime browser module or the removed host installSettingsSection / settingsNamespace exports.
• Host registers through ctx.settings.register; the client uses the shared scope set/unset contract with read-back. It does not confuse legacy {field} batch operations with modern {path} operations.
• Uses settingsScope normally, with the legacy webUiSettings binder when installed. Existing settings continue to work; new fields have defaults.

Automated checks exercise the built factory, both binder contracts, the real React form, current SDK host registration and DOM lifecycle. The 28 unit tests also check the installed SDK version, the turn's one-second elapsed-clock updates and conversation switching. Host registration/unload was rechecked with the published 0.1.1-rc.2 provider module.

The release-bundle preview is browser-tested with Tabbit (simulated Host storage), including animation, settings and lifecycle behavior. This is not a full end-to-end conversation test on every historical Harness version.

Settings

Development

pnpm typecheck
pnpm test          # behavior, settings writes, keyed registration, peer ranges
pnpm build         # declarations + host ESM + lazy browser factory
pnpm test:bundle   # shipped bundle + React settings + real Host SDK provider
pnpm test:assets   # alpha, frame dimensions, animation and size budget
pnpm preview       # local interactive release-bundle preview

scripts/import-whale-maid.mjs reproduces sprites from pinned upstream videos (requires ffmpeg with libvpx-vp9 and PNG support; existing outputs are skipped). node scripts/build-asset-preview.mjs regenerates the frame contact sheet. Sprites use CSS steps(100) and a single rotation timer per mounted plugin. The ~4MB browser factory includes all eight sprites to work with old and new loaders without static-asset URL assumptions.

Asset source and licenses

The matching blue-haired whale-maid animations were found in PC2005-cloud/dsh-pet and converted from transparent VP9 videos into compact WebP sprite strips. No user-uploaded screenshot is distributed in the plugin.

Important: upstream assets allow open-source use but prohibit commercial use. This restriction applies to the bundled whale-maid images and embedded copies; they are not Apache-2.0 assets. See asset attribution and terms and contact the upstream author for commercial permission.

Plugin code is Apache-2.0. Vendored build/card files retain their dsh-web-ui provenance; see file headers and LICENSE.