Introduction

The philosophy of DSH is “everything is a plugin”. In the Web GUI scenario, in addition to command execution and chat interfaces, lightweight interactive components can also be added. yuhao-pet is a DSH Web plugin maintained by dlpufan under the MIT license. It places a desktop pet named “Yuhao” in the bottom-right corner of the DSH Web desktop, supporting actions such as dragging, feeding, bathing, studying, and working, and converts token consumption into points used to purchase items. Below is an introduction to its core functions, installation commands, and typical usage.

This describes a plugin in the community plugin directory; the community directory is an independent site with no official affiliation with DeepSeek or Hypersphere, and is not an official app store.

What is it

One-sentence positioning: DSH Web GUI desktop pet plugin.

It mainly solves three things:

  • Provides a permanent, draggable, and hideable interactive character in the DSH Web desktop.
  • Uses five states, actions, items, and a shop to turn daily interactions into a lightweight raising process.
  • Converts token consumption into points, allowing points to be used to buy food, toys, medicine, learning materials, furniture, and special items.

The character art and character settings come from the FurryBar character wiki (artist: Cantaloupe/香瓜).

Core Features

Permanent, Moving, and Hiding

  • Permanently stays in the bottom-right corner of the DSH Web desktop.
  • Draggable and hideable.
  • When hidden, if the Cyberpunk theme plugin is installed, it can be tucked into the top-right HUD; otherwise, it stays in the bottom-right corner.

States and Actions

  • Supports actions such as feeding, playing, bathing, taking medicine, studying, working, and sleeping.
  • Five states—Fullness, Cleanliness, Mood, Health, and Energy—decay over time.
  • State changes affect pet performance; the pet can get sick or fall asleep.
  • Provides levels and experience, as well as a points store.

Points and Inventory

  • Token consumption automatically accumulates points.
  • The points store includes food, toys, medicine, learning materials, furniture, and specials.
  • Purchased items go into the inventory and are used in the corresponding actions.

AI Chat

  • Can initiate conversation and chat with DeepSeek AI.
  • Dialogue history is persisted locally, and the trigger source for each reply is labeled.
  • When used with the Cyberpunk theme plugin, changing songs triggers a comment on the new song; saying “change song” in the chat can help change the song.

The configuration item to fill in is:

DeepSeek API Key

Character Art, Expressions, and Outfits

  • Spine frame-by-frame breathing animation for the character art; ears, head, tail, and body move naturally.
  • 7 expressions automatically switch based on state, and can be temporarily triggered by emotion words in the conversation.
  • Switch to the old version chibi character art.
  • Character art size supports three tiers: Large, Medium, and Small.
  • Outfits: One-click switching between wearing and removing clothes, with real-time changes to the character art.
  • Random idle animations: sneezing, looking around and blinking, stealing small items.

Interactive Tools

  • Provides four interactive tools: feather, finger, palm, and tomato.
  • Clicking different parts of the body triggers different reactions.

Installation and Enabling

First, switch to the yuhao-pet directory in the plugin source code directory, then add the plugin:

cd yuhao-pet
dsh plugin --profile web add .

After installation is complete, restart and refresh:

dsh web

If you need to uninstall:

dsh plugin --profile web remove yuhao-pet

Pet state is retained in the following path:

<dshHome>/data/yuhao-pet/state.json

Reinstallation continues; to completely clear it, you need to manually delete that directory.

Typical Usage

  1. Left-click on the pet: Opens the properties panel.
  2. Right-click on the pet: Opens the menu, allowing access to chat, shop, settings, or executing various actions.
  3. Hold and drag: Moves the pet’s position.
  4. Interaction: Select feather, finger, palm, or tomato from the menu “Interaction”, then click on a pet body part.
  5. AI Chat: Fill in the DeepSeek API Key in the menu “Settings”, then chat in “Chat”, or click “Reply” under the chat bubble.

Suitable Scenarios and Notes

Suitable for:

  • Already using DSH Web GUI and want more lightweight interaction on the desktop.
  • Want to perceive token consumption through a points/item mechanism.
  • Want to add a layer of pet interaction to scenarios like chatting, changing songs, or hiding.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should check the source code, behavior, and license before installation.
  • AI chat requires configuring the DeepSeek API Key.
  • Features like song change comments, saying “change song” to change tracks, and hiding into the top-right HUD rely on the Cyberpunk theme plugin.
  • This article only covers verified capabilities and does not reference unverified data or fields.

Links

  • Directory page: https://www.skillhub.cn/plugins/dlpufan/yuhao-pet
  • GitHub: https://github.com/dlpufan/yuhao-pet