PC2005-cloud/dsh-pet

dsh‑pet – a “desktop pet” plugin for DeepSeek Harness

What it is – dsh-pet is a plugin for the DeepSeek Harness (DSH) platform (a web‑based AI chat environment). The plugin adds a small animated character that lives on the DSH UI or in a separate transparent desktop window. The pet reacts to user clicks, drags, DSH conversation events, balance‑checking APIs, and can even be scripted through a tiny HTTP API.

Why it matters – While not an AI model itself, the project showcases how generative‑AI‑driven assets (the hand‑drawn animation packs are produced with AI prompts) can be packaged into an interactive UI component. It also demonstrates a clean separation of three stages:

1. Prompt recipes that generate animation assets with AI.
2. Asset‑generation pipeline that turns source video into transparent WebM/VP9‑Alpha clips.
3. The DSH plugin that consumes those assets and provides the interactive pet.

Key features (as described in the README)

• Pure desktop‑pet experience – no weather or system‑monitoring features; optional modules are balance display, “whispers”, chat, work‑status, and system notifications.
• Animation chain – idle, turn, move, and categorized actions are weighted; the next animation is chosen automatically, with seamless cross‑fade.
• Event‑driven animations – balance, whisper, and work‑status each have their own animation sets that fire on specific triggers.
• Multi‑instance support – you can run many pets simultaneously, each with independent size, position and settings.
• Screen roaming & physics – pets walk around the screen, avoid leaving the visible area, and respond to drag‑throw physics (elastic bounce, friction, etc.).
• Context menu – right‑click to manually trigger any animation, open URLs, view balance, reload config, etc.
• Desktop mode – optional Electron‑based transparent window per pet, allowing the pet to live outside the browser.
• Pet packs – add new species by dropping a ‑config.json and a matching animation folder under pet/.
• Custom animation import – drop VP9‑Alpha .webm files into main-animation/webm/ to extend the library.
• Accessibility – respects prefers-reduced-motion by skipping bounce and fade‑in effects.
• External HTTP API – a local, unauthenticated endpoint (/dsh-pet-7340/*) lets other plugins make the pet speak, play a specific animation, or query its state. OpenAPI spec and a tiny tester UI are provided.
• Standalone mode – the pet can run without DSH, exposing the same UI and physics but with limited features (no balance, whisper, chat, or system notifications).

Installation & usage

1. Install the DSH launcher and pnpm (npm i -g @deepseek-ai/dsh pnpm).
2. Add the plugin via the DSH CLI: dsh plugin --profile desktop add dsh-pet (or install from the UI).
3. Restart the DSH desktop or web client; the pet appears in the top‑right corner.
4. For development, clone the repo, run npm install && npm run build, then add it with dsh plugin --profile desktop add file:<path>.

Configuration – The main config lives in assets/config.jsonc. Users can edit it through the DSH settings UI or directly edit the JSONC file ($DSH_HOME/dsh-pet/main-config.jsonc). The file controls:

• pets array (id, size, position, display mode, balance toggle)
• animations and animationWeights
• Refresh intervals for balance, whispers, etc.
• Global switches like notificationsEnabled.

Supported platforms – Windows, macOS, Linux (both browser overlay and Electron desktop). Safari is not supported for transparent WebM; a .mov fallback is documented.

Overall impression – dsh-pet is a well‑documented, feature‑rich plugin that turns the DeepSeek Harness UI into a playful, extensible desktop‑pet environment. It is a genuine software project tightly coupled to an AI‑driven platform, making it relevant for readers interested in AI‑enhanced UI extensions, plugin ecosystems, and interactive visual agents.

---

Quick reference

• Repo: https://github.com/PC2005-cloud/dsh-pet
• npm: dsh-pet
• License: (as shown in badge) – likely an open source license.
• Main language: TypeScript/JavaScript.
• Target audience: Users of DeepSeek Harness who want a visual companion, and developers who want to build custom AI‑generated animation packs.

---

All details above are taken directly from the README; no external speculation added.