dsh-pet

English | 中文

A community DeepSeek Pet client plugin for DeepSeek Harness. It keeps a DeepSeek whale visible in the Web viewport, swims in place, follows the current session lifecycle, and opens a compact API statistics panel.

What it provides

• A fixed viewport overlay with an in-place swimming whale; the animation changes atlas frames and a one-pixel vertical bob without horizontal travel or rotation.
• Current-session states for idle, running, waiting, failed, and completed turns, with English and Simplified Chinese dictionaries.
• A click-to-open panel for the current chat title, latest provider/model identity, and API statistics from sessionStats, tokenUsage, and contextPressure projections.
• Primary-pointer dragging with grab-point tracking, an 8px viewport margin, persistent browser-local position, and viewport clamping.
• An expanded panel that chooses the side with more room, collides with every viewport edge, and scrolls internally when the viewport is shorter than the card.
• Codex v2 8×11 sprite atlas packaging with the WebP asset embedded in the client bundle.

Integration status

This repository is a source release of the Web client package @deepseek-ai/dsh-client-ui-pet. The package contributes a browser entry to the DSH Web composition; it is not a standalone dsh.bundle yet.

The current build and test path uses the matching DeepSeek Harness checkout because the package uses DSH workspace dependencies and TypeScript project references. In that checkout, place this directory at packages/client/ui-pet, keep the Web patch row below, and run the focused checks from the monorepo root:

- id: ui-pet
  name: '@deepseek-ai/dsh-client-ui-pet'

rsync -a --exclude .git --exclude lib --exclude node_modules /path/to/dsh-pet/ packages/client/ui-pet/
pnpm install
pnpm exec vitest run packages/client/ui-pet/tests
pnpm exec tsc -p packages/client/ui-pet/tsconfig.json --noEmit
pnpm --filter @deepseek-ai/dsh-client-ui-pet bundle

Direct dsh plugin --profile <name> add github:Vulcan626/dsh-pet activation is intentionally deferred. The package does not declare dsh.bundle, and its current workspace:^ references are not self-contained for a Git install. The official DSH plugin publishing guide explains why a public Git package needs a self-contained prepare build or prebuilt artifacts before it can be installed this way.

Runtime and statistics

The pet reads the selected session through the runtime standard hooks. Durable whole-log counts and provider billing buckets are preferred when their projections are installed; a projection-free fixture or deployment folds the visible conversation window as a display fallback without issuing an RPC or creating a second usage ledger.

Cache hit is cacheReadTokens / (uncachedInputTokens + cacheReadTokens + cacheWriteTokens). Context occupancy uses projectedTokens with pressureTokens as its fallback numerator. The plugin sends no model request and adds no model-visible content.

Development notes

The source is organized as a host plugin plus a browser entry under src/client/. Focused React tests cover status derivation, statistics folding, usage calculations, sprite selection, dragging, viewport clamping, and panel edge collision. Generated lib/, node_modules/, temporary files, environment files, and macOS metadata are excluded from this repository.

Official ecosystem guidance

The upstream contribution guide currently directs community contributions toward shared plugins, guides, blog posts, and answers while the official repository is not accepting external pull requests. Add the dsh-plugin topic when publishing related packages so other DSH users can discover them.

Release notes and TODO

• CHANGELOG.md records the current public source release.
• TODO.md lists the next packaging, installation, accessibility, and statistics milestones.

License

MIT. See LICENSE.