deepseek-mate

希可儿 · deepseek-mate

A 3D desktop companion (桌宠) for [DeepSeek Harness](https://github.com/deepseek-ai). Install the plugin and 希可儿 appears in the Harness Web UI, sitting on the chat input box. She breathes, looks at your cursor, reacts while the agent thinks, mouths the streamed reply, and can move out to your real desktop to sit on the top edge of any window or the taskbar.

> Naming. The project/repository is deepseek-mate; the plugin package id is dsh-plugin-whale-mate (kept unchanged so existing installs, config keys and stored settings keep working). The character is 希可儿 (Xikeer).

[中文文档](README.zh-CN.md) · [Changelog](CHANGELOG.md) · [Asset licences](ASSET_LICENSES.md) · [Contributing](CONTRIBUTING.md)

---

Table of contents

• [What she does](#what-she-does)
• [Requirements](#requirements)
• [Installation](#installation)
• [Using her](#using-her)
• [Desktop mode](#desktop-mode)
• [Models](#models)
• [Configuration](#configuration)
• [Agent tools](#agent-tools)
• [How it works](#how-it-works)
• [Development](#development)
• [Troubleshooting](#troubleshooting)
• [Limits](#limits)
• [License](#license)
• [Acknowledgements](#acknowledgements)

What she does

| Scenario | Behaviour |

| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| Idle | Breathes, blinks, swings her legs, follows the mouse with her eyes and head. Occasionally stretches, walks around, sits on the edge, or plays a small motion. After 3 minutes without activity she dozes off. |

| You send a message | Nods to acknowledge it. |

| DeepSeek is thinking | Hand on chin, with a "…" bubble. |

| DeepSeek replies | Her mouth moves in sync with the streamed text; the bubble shows the latest part of the reply, then the opening of the reply once it finishes. |

| A request fails | Sad face, shakes her head, and the bubble explains why (for example, "no API key configured"). |

| You drag her | She dangles from the grab point and swings as you move. Release her and she falls, or throws her. She lands on the top edge of whatever card is below, or on the bottom of the window. Surfaces too close to the top of the window (where her head would be cut off) are skipped. |

| Double-click | Waves and says hello. |

| Click her head / stroke it with the mouse | Headpat: she squints and smiles. |

| Click her body | She gets startled. |

| Right-click | A radial wheel: your favourite actions and expressions, the window/desktop switch, and hide. |

| Settings | Settings → 希可儿桌宠: model, mode, size, right-click wheel contents, diagnostics. |

The character is fully local: the plugin ships its own Three.js/three-vrm engine and VRM avatar. It does not call any LLM itself — the bubble text comes from the Harness session it is watching.

Requirements

• DeepSeek Harness — the official Desktop app (recommended) or dsh web, version 0.2.1 or newer.
• OS — Windows 10/11, macOS, or Linux (X11). Desktop mode has the best window tracking on Windows; see [Desktop mode](#desktop-mode).
• Node.js 22+ only if you build from source or run the test suite. Installing the plugin needs no toolchain.
• No Unity, no Blender, no separate app