Preface¶

The philosophy of DSH is “everything is a plugin.” The community directory is an independent site with no official affiliation to DeepSeek / High-Flyer. If you frequently use Harness in dsh web and need to quickly see whether the current session is waiting, thinking, running tools, or encountering errors, Harness Pet provides a lightweight in-page observation method: it renders a pixel whale in the Harness page and responds to structured session signals exposed by the DSH client at runtime.

Below is an introduction to the positioning, installation method, and verified usage of cakeni/harness-pet.

What This Is¶

Harness Pet is a native DSH web plugin, not a browser extension. It renders a pixel whale in the Harness page, maps session states to nine visual states, and displays the latest local user prompt, Harness replies, and progress above the whale.

Repository information:

• Repository: cakeni/harness-pet
• License: MIT
• Positioning: Unofficial community project, not affiliated with, endorsed by, or maintained by DeepSeek.

Core Features¶

• Supports nine visual states: idle, thinking, working, searching, bash, editing, waiting, error, success.
• Displays the latest local user prompt, Harness replies, and progress above the whale.
• Click the whale to play a fin wave; drag to move it, with the position saved in localStorage.
• Provides controls for size, opacity, enable/disable, reset position, and reduced motion.
• Supports instant switching among English, Simplified Chinese, Japanese, and Korean interfaces.
• Optional Chromium desktop window mode keeps the pet in an always-on-top Document Picture-in-Picture window.
• Supports debug state override, automatic state cycling, and real-time status badges.
• No telemetry, and no conversation data is sent to third parties.
• The plugin does not independently make fetch calls, analytics, telemetry, cloud sync, or third-party requests.
• Settings are only saved in browser localStorage; no browser permissions are requested.
• Displayed conversation text is not persisted.

Installation and Enablement¶

Prerequisites¶

Requires Harness 0.1.0-rc.6, and pnpm must be in PATH.

The npm package name is reserved for future releases; before that, install via Git or local linking. Browser extension mode is not supported.

Git Installation¶

First, run the following command to install the plugin from GitHub:

dsh plugin --profile web add github:cakeni/harness-pet

After installing or removing the plugin, you need to restart the dsh web process. After following the steps above and restarting the process, the plugin will be available in the Harness page.

pnpm prepare Build Blocked¶

If pnpm blocks the prepare build, add the following to the profile’s pnpm-workspace.yaml:

allowBuilds:
  harness-pet: true

Then repeat the installation command above.

Local Development Link Installation¶

Run from the parent directory of the repository:

dsh plugin --profile web add link:../harness-pet

Do not run multiple link installations for the same profile.

Development Build¶

In the repository, run:

pnpm install
pnpm run typecheck
pnpm test
pnpm bundle

If you only need to rebuild the current directory, you can also enter the plugin directory and run:

cd harness-pet
pnpm bundle

Typical Usage¶

1. Click the whale to play a fin wave; drag to move the whale, with the position saved in localStorage.

2. Double-click, long-press, or click the gear button to open settings.

3. In settings, select Language to instantly switch the interface language; English, Simplified Chinese, Japanese, and Korean are supported.

4. Use settings to control size, opacity, enable/disable, reset position, and reduced motion.

5. After enabling Open Floating Pet, the main Harness window can be minimized, and the pet remains in a separate always-on-top window; desktop window mode requires Chromium 116+ Document Picture-in-Picture, and unsupported browsers will keep that control disabled.

6. Click the gray follow-up icon to open an input field; press Enter to submit to the current Harness session.

Applicable Scenarios and Notes¶

Suitable for those who use DSH web plugins and want to observe session states within the Harness page, view the latest prompt, Harness replies, and progress, and locally adjust size, opacity, and dynamic effects.

Notes:

• The plugin runs with the current dsh process permissions; inspect the source code, dependencies, and license before installation.
• Unofficial community project, not affiliated with, endorsed by, or maintained by DeepSeek.
• Subsequent 0.1.x pre-release versions have not been verified; the client API may change before 1.0.
• The plugin does not independently make fetch calls, analytics, telemetry, cloud sync, or third-party requests.
• Displayed conversation text is not persisted.
• Only settings are saved in browser localStorage; the plugin does not request browser permissions.

Conclusion¶

The value of Harness Pet is fairly focused: it is a native DSH web plugin that maps Harness session signals to a pixel whale with nine states, while providing local settings, a floating window, and debug controls. Before installation, you should still inspect the source code and license.

Repository link:

• GitHub: https://github.com/cakeni/harness-pet