Foreword

When running tasks in DeepSeek Harness (DSH), tool calls, session switches, and context usage all occur in the background, with the interface often only presenting the text stream. Staring at the output for extended periods makes it hard to tell at a glance whether the system is thinking, awaiting approval, or executing multiple sessions in parallel.

DeepSeek Pet is an interactive desktop pet plugin for DSH Web created by maintainer keleus. It maps task states into character expressions and short feedback phrases, and supports dragging, resizing, and minimizing, making the web-based usage process more intuitive. Below, we introduce its positioning, features, installation methods, and daily operations.

What Is This

DeepSeek Pet is an interactive desktop pet plugin embedded in the DeepSeek Harness webpage, categorized under “Fun Customization.” The plugin description reads: “Raise a freeloading blue whale on your deepseek-harness.”

It automatically switches DeepSeek expressions based on the current task, tool calls, context usage, and active sessions, and presents Live2D-style effects through breathing, bouncing, tilting, parallax, and fade-in animations. The character uses complete expression image switching, without splitting head, hands, feet, or facial feature layers, avoiding component misalignment and abrupt expression changes.

Maintainer: keleus
GitHub: https://github.com/keleus/deepseek-pet
Community Directory: https://www.skillhub.cn/plugins/keleus/deepseek-pet
License: MIT

Core Features

Status Display and Interaction

  • The character displays a rotating status phrase in a speech bubble of equal width to the Pet above, with a single-line horizontal typewriter effect following the latest output; it automatically hides after 10 seconds of inactivity.
  • Below the character, a horizontal bar shows the focused session with a highlighted border; active sessions are arranged downward and automatically stack and collapse when exceeding three.
  • Multiple sessions running in parallel trigger the “Busy as a Bee” state.
  • Expressions switch based on scenarios like analysis, answering, coding, web search, sub-agent, completion, and failure; during the answering phase, it rotates work images like typing, thinking, and careful checking; during the thinking phase, it rotates different status labels.
  • When a tool awaits approval, you can directly allow or reject it in the bubble.
  • User questions support options, custom input, submission, and rejection.
  • When reasoning involves many doubts, it displays confused or stressed expressions.
  • When the user points out an error in the answer, it displays an apologetic expression.

Context and Input Awareness

  • When context reaches 62%, it prompts “Can eat a little more”; at 82%, it shows “Full.”
  • Image input displays a blindfolded state.

Idle and Time-Based Greetings

  • After 10 minutes of inactivity, it shows hunger; 30 minutes, it hugges a pillow and feels sleepy; after 1 hour, it falls asleep.
  • Actions like idle, thinking, responding, success, waiting, error, and eating rotate steadily based on cumulative time, without random image jumps due to re-rendering.
  • Greetings for morning, noon, afternoon, and evening are displayed based on local time; after 11 PM, it feels sleepy, and enters sleep state in the early hours.

Layout and Settings

  • When the mouse hovers over the character, a “−” minimize button appears at its feet.
  • Supports dragging the character, single-click interaction, double-click folding; when hovering over the character, use the scroll wheel to resize, and it remembers position and size.
  • Supports narrow screen layout and prefers-reduced-motion.
  • The settings panel adds a “Desktop Pet Settings” page, where you can configure action images and provides two display modes:
  • Default: Keeps the current display method unchanged.
  • Page Top: The desktop pet is fixed in the bottom-right corner of the viewport, floating above all webpage content (including pop-ups).
  • The settings page allows enabling or disabling specific images by action group, with at least one retained per group; during thinking and tool execution, it steadily alternates between work and white rice actions.

Installation and Enabling

Installation requires Node.js and pnpm. If you have installed dsh globally, run:

dsh plugin --profile web add github:keleus/deepseek-pet

Without a global dsh command, execute directly via npx:

npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet

Both commands have the same effect, pulling the plugin from GitHub and installing it into the Web profile.

After installation, start or restart the webpage. Global CLI:

dsh web

npx:

npx @deepseek-ai/dsh web

If the webpage is already open, refresh the page.

Installing from Source

When you need to pull the source code and build locally:

git clone https://github.com/keleus/deepseek-pet.git
cd deepseek-pet
npm install
npm run build
dsh plugin --profile web add .

Without a global CLI, replace the last command with:

npx @deepseek-ai/dsh plugin --profile web add .

Local installation links the current directory, allowing you to modify code and rebuild for continued debugging.

Updating and Uninstalling

To update, re-run the installation command, then restart the webpage process and refresh the page:

dsh plugin --profile web add github:keleus/deepseek-pet

Or:

npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet

Uninstall:

dsh plugin --profile web remove deepseek-pet

Without a global CLI:

npx @deepseek-ai/dsh plugin --profile web remove deepseek-pet

Typical Usage

After installing and refreshing the page, the desktop pet automatically changes with DSH task states. Daily operations include:

  • Dragging the character: Adjust the display position.
  • Hovering over the character and scrolling: Adjust the Pet size within 65%–140%.
  • Single-clicking the character: Triggers a short phrase feedback matching the current state.
  • Double-clicking the character or clicking the “−” button: Minimizes to a static icon in the bottom-right corner.
  • Clicking an active session: Switches that session to the focused session.
  • When approval or question cards appear: You can directly select, input, allow, or reject.

For custom display, open the “Desktop Pet Settings” page in the settings panel, enable or disable images by action group, or switch between “Default” and “Page Top” modes.

Applicable Scenarios and Notes

Suitable for users who use DSH Web for extended periods and want to perceive task states directly from the interface. The desktop pet responds to runtime events like tool approvals, multi-session parallel execution, and context usage, and also displays idle animations during downtime.

Before installation, please note:

  • The plugin runs with the current dsh process permissions; check the source code and MIT license before installing.
  • The community directory SkillHub is an independent site and has no official affiliation with DeepSeek / High-Flyer.
  • The development environment requires Node.js 22.19 or higher, Python 3, and Pillow; to modify assets locally, run npm run assets, and build outputs are in the lib/ directory.

Conclusion

DeepSeek Pet transforms task states in DSH Web into visible expressions, short phrases, and session bars, while retaining desktop pet interactions like dragging, resizing, and minimizing. For installation or update information, visit the community directory page or GitHub repository:

  • https://www.skillhub.cn/plugins/keleus/deepseek-pet
  • https://github.com/keleus/deepseek-pet