Preface¶

When using agents in the DeepSeek Harness (DSH), information about which stage the agent is currently in, which tool it is calling, how long it has been running, and how much DeepSeek API balance remains is often scattered across logs, terminal output, or different panels. dsh-desktop-pet brings all this information into a single desktop pet widget: the official whale is active in the shell overlay of the web UI, the height of the circular sea level corresponds to the API balance, and a status bar displays the current agent stage, tool, and elapsed time.

What This Is¶

dsh-desktop-pet is a DeepSeek Harness plugin maintained by FenyxHuang, released under the MIT license. It provides a persistent desktop pet in the DSH web profile, centrally displaying agent runtime status and DeepSeek API balance.

The plugin’s packaged output is pre-built and declares zero runtime dependencies; at installation time, it relies on the @deepseek-ai/* services provided by the Harness itself, so no additional build step or build authorization is required.

Core Features¶

Real-Time Agent Status¶

The whale switches its display according to agent status, including resting, thinking, working, and cries.

The status bar shows the current stage, current tool, and elapsed time.

Balance as Sea Level¶

The circular sea surface is filled according to balance / balanceScale, with the calculation result clamped to a maximum of 1. The default balanceScale is 100, meaning ¥100 represents full capacity.

The water surface displays rolling waves and a slow tide effect, with the balance amount shown on the water. When the balance is low, the whale droops and shows a complaining state.

Interactive Desktop Pet¶

Clicking the whale triggers interactions: it bounces in most cases, with about a 40% chance of triggering a charged dive with a 360° rotation, accompanied by a splash effect.

The plugin also includes random Chinese and English lines, hearts, thought bubbles, and features such as dragging and minimizing to a dot.

Zero Runtime Dependencies¶

The packaged output is pre-built and distributed. The @deepseek-ai/* services are provided by the existing Harness installation, and no build step or build authorization is needed during installation.

Installation and Activation¶

Prerequisites: DeepSeek Harness must already be installed, and the web profile is recommended.

Install directly from GitHub:

dsh plugin --profile web add github:FenyxHuang/dsh-desktop-pet

When installing from a local checkout, replace the path with the actual directory:

dsh plugin --profile web add link:/path/to/dsh-desktop-pet

You can also package it into a tarball first, then install:

pnpm pack
dsh plugin --profile web add ./dsh-desktop-pet-0.1.0.tgz

After installation, you need to restart dsh, because bundle layers are combined at startup. Once restarted, the whale will appear in the bottom-right corner of the web UI.

Typical Usage¶

Viewing Agent Status and Balance¶

After installation and restart, the whale widget will appear in the bottom-right corner of the web UI.

While the agent is running, you can observe the whale’s status, the stage in the status bar, the current tool, and elapsed time. The circular sea surface displays the water level based on the DeepSeek API balance.

The host-side configuration line reads DEEPSEEK_API_KEY through Harness’s normal credentials and refetches the balance endpoint at most every 15 seconds:

https://api.deepseek.com/user/balance

Overriding Configuration¶

By default, the pet-status configuration is balanceScale: 100. If you want a higher balance to be displayed as full, you can override the configuration in your own profile’s cordis.patch.yml:

- update:
    - id: pet-status
      config:
        balanceScale: 500
        balanceRefetchMs: 60000

The example above adjusts the full-capacity threshold to 500 and changes the balance refetch interval to 60000 milliseconds.

Use Cases and Notes¶

Suitable for users who are already using the DeepSeek Harness web profile and want to see both agent status and API balance in a single persistent widget.

Things to note before use:

• This plugin depends on an existing DeepSeek Harness installation environment.
• After installation, you must restart dsh for the widget to appear in the bottom-right corner of the web UI.
• The plugin reads DEEPSEEK_API_KEY and accesses the DeepSeek balance API, at most once every 15 seconds.
• The plugin runs with the current dsh process permissions; you should review the source code, dependency scope, and license before installation.
• The license is MIT; the plugin originates from the DeepSeek Harness codebase (MIT, © 2026 DeepSeek). The whale logo is official DeepSeek brand artwork, used for the widget’s own display.
• The repository’s development test record is 34 passes; among them, 7 jsdom widget tests require Node ^22.19 || >=24.

Related Links¶

• GitHub: https://github.com/FenyxHuang/dsh-desktop-pet
• Community directory page: https://www.skillhub.cn/plugins/FenyxHuang/dsh-desktop-pet