Introduction¶
The DeepSeek Harness (DSH) ecosystem emphasizes plug-in extensibility and signal feedback. When debugging or running an agent, developers often need visual feedback that intuitively reflects the Agent’s state. Unlike a traditional pet compendium, which is only static images and lacks connection to runtime data, the dsh-pet-evolve plugin provides a companion pet that grows in sync with the DSH Agent. It evolves based on real session signals rather than preset stickers.
Plugin Overview¶
This is a DSH plugin maintained by zoahdev. Its core value is: staged evolution based on real signals, mirroring the Agent’s state, and one-click generation of a growth share card. The plugin runs entirely locally with no external dependencies.
Core Capabilities¶
The plugin primarily includes the following features:
- 5 evolution stages: The pet is drawn in real time via Canvas and has 5 evolution stages, rather than static stickers.
- State mirroring: The pet’s state changes in real time according to DSH session events, reflecting working, completed, failed, or idle states.
- Growth based on real signals: Growth XP is earned from verified rules, session completion, tool calls, and compressed summaries.
- Share card generation: Supports one-click generation of a 1200×630 PNG growth card.
- Privacy and multiple skins: Data remains 100% local with no telemetry; multiple skins are provided (whale, cat, robot, ghost).
- Focus mode: Includes a productivity mode that grants XP after completing a focus session.
Installation and Configuration¶
The plugin supports installation in DSH plugin mode. Make sure DSH is installed and a Profile is configured.
dsh plugin --profile web add github:zoahdev/dsh-pet-evolve
Usage Examples¶
In addition to running as a DSH plugin, it can also run standalone.
Standalone mode:
npx dsh-pet-evolve
# 访问 http://127.0.0.1:4173
Bind to a DSH Profile:
npx dsh-pet-evolve --profile ~/.dsh/profiles/web
Sync dsh-rule-evolve evolution rounds (each round +5 XP):
npx dsh-pet-evolve --profile ~/.dsh/profiles/web --evolution ~/.dsh/profiles/web/EVOLUTION.md
Generate a growth report (headless mode):
npx dsh-pet-evolve --report
Notes¶
- Permissions and data: The plugin runs with the permissions of the current DSH process and reads local files (session logs and rule files) to calculate evolution.
- Privacy: The plugin never sends data to any server (zero telemetry); generated share cards are completed in the browser.
- Version requirement: Node.js >= 18 is required.
Conclusion¶
dsh-pet-evolve turns tedious log feedback into visual pet growth, making it a fun enhancement component for the DSH ecosystem. For more details, see the official catalog or the GitHub repository.