dsh-ui-pet: A Floating Cat That Follows Session State in DeepSeek Harness
hanyudong1994/dsh-ui-pet
A desktop pet cat for the DeepSeek Harness Web GUI, floating at the bottom-right and reacting to the current session's running, idle, or empty state with matching bubbles — purely presentational with zero side effects.
dsh-ui-pet is a DSH plugin that adds a floating cat to the DeepSeek Harness Web GUI, docked at the bottom-right corner with its face and caption following the current session's activity. It solves the problem of having to dig through logs just to know whether a task is actually running, turning session state into an animation you can read at a glance. Its core abilities include three bound states (sleeping with no session, working while running, idling when free), click interaction that cycles reaction bubbles and restores after about 700ms, and a zero-side-effect design that registers into a framework list slot and cleans up automatically on unload.
How to Install
dsh plugin --profile web add dsh-ui-pet- Category
- Entertainment
- Platform
- DSH Plugin
- Author
- hanyudong1994
- Distribution
- Plugin
dsh-ui-pet Key Features
dsh-ui-pet Repo Summary
What Does It Do?
It is a DSH plugin for DeepSeek Harness that puts a floating cat in the bottom-right corner of the Web GUI and lets it react to the current session's activity in real time. It turns the abstract question of "what is the session doing" into an animation you can read at a glance, so you do not have to watch logs to know whether work is running. Maintained by hanyudong1994 under the MIT license and written in TypeScript, it is a pure presentation-layer component.
Core Features
- State binding: the cat sleeps with "呼…" when there is no current session, works with "加油！" while the session is running, and idles with "喵？" when it is free.
- Click interaction: clicking the pet pops a reaction bubble that cycles through "喵！", "呼噜…" and "呀！", then restores the state text after 700ms.
- Pure presentation layer: it only reads the standard session-list data stream, writes no session logs, stays invisible to the model, and has zero side effects.
- Native framework integration: it registers into the shell.overlay list slot and is cleaned up automatically when the plugin unloads, which keeps hot reload friendly.
- Standalone development: the repository ships 16 unit tests covering components, state derivation, register/unregister and invariants, so it can be built and verified outside the host.
How to Use This Plugin?
Once enabled in the DSH Web GUI, the pet appears in the bottom-right corner on its own and follows the current session state without any input. Click the cat to trigger the interaction bubbles; after about 700ms the text returns to the current state. Because it is a browser-side client plugin, you need to wire it into your own deepseek-harness source checkout by following the README steps: install the dependency, register the plugin entry in the browser plugin roster, add the source path mappings, then rebuild, restart the web service and refresh the page. It is built against the public deepseek-harness release line, and since upstream is still pre-release, interface changes may require rebuilding against a newer version.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: hanyudong1994/dsh-ui-pet. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
