dsh-pets
适用于 DeepSeek Harness 的跨平台桌面宠物：动画角色、会话气泡和完成提醒。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:bloodarea/dsh-pets#1f0933fd848160f19fda18a357dd2f4327d44a70Pets 以 dsh-pets 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Cross-platform desktop pets for DeepSeek Harness.
DSH Pets brings your running AI agent sessions onto the desktop through animated characters, event-driven voice lines, and actionable notifications. Keep an eye on parallel tasks, jump to the right session, and know when an agent needs you—without constantly checking the DSH Web interface.
Project status: early development. This README describes the intended product and development milestones. Features listed as planned are not claims that they are already implemented. The project builds on ideas and code from zuodazuoqiang001/dsh-pet, a Windows desktop-pet plugin for DSH.
The product is organized around four focused modules:
| Module | Planned capabilities |
|---|---|
| Session Management | Show active top-level DSH sessions, quickly switch to a selected session, and notify on task completion, failure, or approval requests. Keep missed notifications accessible. |
| Character System | Display Spine characters or sprite-sheet pets, associate characters with model identities, and map agent states to expressions and motions. |
| Voice System | Play pre-recorded voice lines for events, with character-specific voice packs, volume/mute controls, cooldowns, and optional lip sync. |
| Desktop Interaction | Transparent floating window, drag/position persistence, system tray, click-through behavior, do-not-disturb mode, and basic performance settings. |
Two non-negotiable capabilities:
Character animation and voice make these workflows more expressive; they must never prevent session controls and notifications from working.
Characters may be mapped to model families (for example, DeepSeek, Claude, or GPT), with manual overrides. A session remains identified by its session ID even if the model changes.
DeepSeek Harness (DSH Web / Cordis plugin)
├─ Session and agent status
├─ Task completion / failure / approval events
└─ Session focus and navigation
│
│ Local, restricted communication
▼
Electron desktop companion (main process)
├─ Connection / notification / session controllers
├─ Window, tray, platform integration
└─ React + TypeScript UI
├─ Session bubbles and notification history
├─ Spine renderer (primary character format)
├─ Static-image fallback (no GPU / reduced mode)
└─ Pre-recorded voice playback + optional lip sync
Target platforms: Windows, Linux, and macOS. Initial desktop verification is planned for Ubuntu 24.04 Desktop with DSH Web, with Windows and macOS compatibility tests following. Linux X11/XWayland and native Wayland have different restrictions around global window positioning, always-on-top behavior, and focus; support will be documented based on real testing rather than assumed.
Character packs are self-contained directories with a single contract file. The bundled default pack ships inside the package; every other pack is downloaded on demand into the user's data directory, which takes precedence over the bundled copy.
assets/characters/ # bundled, read-only
index.json # downloadable-pack index (version, sha256, url)
deepseek/ # the only pack shipped with the package
manifest.json
LICENSE
preview.webp
spine/ # Spine skeleton, atlas and textures
voice/
index.json # voice index: every event and line the pack can speak
<event>/<id>.ogg # one file per line, e.g. task_completed/task_completed_01.ogg
~/.dsh/pets/characters/<id>/ # downloaded, writable, overrides the bundled copy
manifest.json is the contract, so the runtime never guesses file names. It declares the Spine entry plus scale and anchor, the agent-state → animation mapping (idle, working, attention, done, failed), the location of the voice index (voice.index), and a static-image fallback for machines without GPU acceleration. The event set is defined by the voice index, not enumerated in the manifest: the bundled pack currently ships 48 lines across 34 events, each line addressed as voice/<event>/<id>.ogg. A voice pack carries no version of its own — the pack's version in manifest.json covers art, animation and audio together. A pack may ship no voice index at all, and every event then stays silent.
This layout is the agreed target: the bundled pack already ships its assets this way, but runtime voice playback is not implemented yet. Voice lines are recorded or generated ahead of time and shipped inside a character pack. There is no runtime text-to-speech generation requirement, no mandatory TTS API, and no need to send session text to a speech provider.
Tools for producing illustrations, skeleton animation, or audio may be used offline during asset creation; they are not part of the DSH Pets runtime.
The roadmap is indicative and may change as implementation and compatibility testing progress.
No stable cross-platform release is documented yet. Once an installable version is available, installation steps and supported DSH versions will be published here. Please do not assume the original Windows-only dsh-pet installation instructions apply to this project.
The repository is already installable as a Host-only Cordis bundle: package.json declares dsh.bundle.patch, cordis.patch.yml activates the entry, and index.js registers every bundled skills/<name>/SKILL.md as an agent skill. As a result the character-pipeline skill three-view-parts appears in the skill catalog without being copied into .agents/skills.
# Link this checkout into a profile (example: the web profile)
dsh plugin --profile web add /path/to/dsh-pets
# Restart Harness afterwards so the bundle is activated; the skill then appears
# in the session skill catalog and can be loaded by name.
# Uninstall
dsh plugin --profile web remove dsh-pets
At this stage the bundle only registers skills. The pet window, session tracking, voice playback, and tray integration remain planned work; see the roadmap above.
Design priorities:
These are engineering goals, not a security audit or a claim of completed functionality.
The project is in an early stage. Issues, platform-specific bug reports, and reproducible test cases are welcome. Before proposing new features, please prioritize the two core workflows: session switching and reliable completion notifications.
This project uses split licensing: source code is MIT, character art is CC BY-NC-SA 4.0. The authoritative text is the root LICENSE.
DSH Pets is intended to evolve from zuodazuoqiang001/dsh-pet (MIT). Source code, scripts and docs are MIT, and reused upstream code keeps its original copyright and license notices. The MIT grant does not extend to assets/characters/.
The bundled deepseek pack is built on community fan artwork and is distributed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0), following the original author's copyright statement. Three rules apply:
ATTRIBUTION.md. Third-party assets keep their own licenses — this project grants nothing on their behalf.LICENSE and ATTRIBUTION.md beside its assets — see assets/characters/deepseek/LICENSE and ATTRIBUTION.md for the full provenance chain and the assets deliberately not included.Names and marks such as DeepSeek, Claude, GPT, Kimi, and Qwen belong to their respective owners. Nothing in this project implies affiliation with or endorsement by any of them.
Spine runtimes and exported animation data are subject to Esoteric Software's commercial licensing terms; confirm the applicable terms before shipping. Other third-party SDKs and assets keep their own licenses.
DSH Pets — A small, always-available desktop entry point for your AI agent sessions.