dsh-pet-companion
DeepSeek Harness 的浮动桌面伴侣，配有活动感知宠物和不断扩充的本地收藏。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:hasan-aghayev/dsh-pet-companion#aa2d8d5dc50bf79300c1cb241450e044151cd750
Pet Companion 以 dsh-pet-companion 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A floating desktop pet for DeepSeek Harness. It reacts to agent activity in a separate transparent window and includes a folder-based library for adding pets from animated atlases or transparent portraits. Lokki is the first built-in pet.
| Companion and hover controls | Settings in English | Settings in Simplified Chinese |
|---|---|---|
| Lokki with settings, message, and close controls | English appearance and behavior settings | Simplified Chinese appearance and behavior settings |
dsh plugin --profile web add github:hasan-aghayev/dsh-pet-companion
Change web to the DSH profile you use. On first start, the companion downloads its pinned Electron runtime and opens a desktop window. A graphical desktop is required; WSL2 users need WSLg enabled.
To remove the plugin:
dsh plugin --profile web remove dsh-pet-companion
Disabling the plugin in DSH stops its desktop process but keeps it installed. Hiding the pet with Show pet only changes visibility. Pet files and preferences remain under $DSH_HOME/pet-companion after removal, so they are available if you install the plugin again.
Open Settings with the gear button or by double-clicking the pet. Use Show pet in the DSH sidebar to bring a hidden companion back. The Close pet control hides the companion and turns off Show pet; the plugin remains enabled.
The text composer sends the entered message to the most recently active live DSH session through DSH's public agent API. It does not show a session picker. Press Enter to send and Shift+Enter to add a line.
Open the Pet library folder from Settings. Add one folder for each pet, with a pet.json manifest and its artwork inside. The folder name must match the manifest's id. New folders are discovered automatically within a few seconds; Refresh rescans the library immediately.
Use a 1536 x 2288 pixel atlas (8 columns by 11 rows) and set spriteVersionNumber to 2:
{
"id": "miso",
"displayName": "Miso",
"description": "A small lunar cat.",
"spriteVersionNumber": 2,
"spritesheetPath": "spritesheet.webp"
}
Optional displayNameZh and descriptionZh fields provide Simplified Chinese labels. Hatch-Pet v2 uses its standard animation rows, including idle, walking, waving, jumping, failed, waiting, working, and review poses, plus 16 look directions.
A single PNG or WebP can be used without an animation atlas. Portraits get a gentle breathing motion:
{
"id": "miso-portrait",
"displayName": "Miso",
"description": "A portrait with gentle motion.",
"format": "portrait",
"imagePath": "portrait.png"
}
Names may use lowercase letters, digits, and hyphens. Image paths must stay inside the pet folder. Images must be no larger than 25 MiB; portrait dimensions can be up to 4096 x 4096 pixels. Built-in pet IDs are reserved.
Pet art, preferences, window position, and session IDs stay on the local machine. The plugin observes DSH agent lifecycle and approval or question events to select an animation. It does not read conversation text, files, or credentials. Text submitted from the composer is sent only to the selected live DSH session through DSH's public agent API. The plugin downloads the pinned Electron runtime on first start and makes no other network requests itself.
pnpm install
pnpm check
The package contains ready-to-run JavaScript and static desktop files, so it needs no install-time build script. The root package.json declares the dsh.bundle manifest in cordis.patch.yml.
MIT. The Lokki sprite art is included with permission from its creator, Hasan Aghayev. Do not redistribute the artwork separately from this plugin without permission.