Raise a Remiel desk pet on the DSH webpage with sticker animations and status bubbles that switch in real-time based on conversation stage, supporting desktop floating window.
- Language
- JavaScript
- License
- NOASSERTION
- Branch
- main
Install
$ dsh plugin --profile web add dsh-pet-remielleRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin Gin-7/dsh-pet-remielle for me: review the repository at https://github.com/Gin-7/dsh-pet-remielle first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Line Description
Raise a Remielle animated desktop pet in the DSH (DeepSeek Harness) web page. It switches stickers in real-time based on your conversation stage and displays status bubbles. Optionally, you can "invite" the pet out of the web page as a transparent always-on-top floating window on the Windows desktop.
Core Features
- Switch stickers based on real DSH conversation events: thinking, output, tool calling, waiting for confirmation, error and other stages correspond to different GIF animations
- Show status bubbles above the pet, containing project name, stage, and task progress (completed x/y)
- When multiple Sessions run simultaneously, display the session requiring most attention based on priority: "waiting for confirmation > error > working > thinking > idle"
- Built-in multi-pet registry, can enable/disable/rename/switch current displayed pet image
- Real-time status push via SSE, automatic reconnection on disconnect, polling fallback when necessary
- Optional desktop floating window (Windows x64): Electron transparent always-on-top window, double-click "artwork" pops up in screen top-right corner as separate small window
- Plugin built-in version checking and one-click update, HTTP proxy fallback for CN network cross-access
- Settings page provides multiple tabs (Appearance / Behavior / Desktop Floating / Update / Feedback)
Technical Implementation
- Language: JavaScript (Node ESM, browser-side also JS)
- Key Dependencies: @deepseek-ai/schemastery (setting configuration schema), @deepseek-ai/cordis (DSH plugin host), @deepseek-ai/dsh-client-ui-settings-plugins (client UI injection points)
- Architecture Pattern: Cordis plugin host, listens to
session/event+session/disposedglobal event bus, pure functionPetReducerreduces to structured messages, then exposes to browser via webServer loopback HTTP endpoints (/config /state /stream /pets /assets /pet-view /desktop /check /update /info); client code injected by build script after version number injection, packaged aslib/client.js - Entry File: src/index.js (host-side, exports
name/apply/Config); browser-side entry is built artifact lib/client.js
Use Cases
When running long tasks with DSH, you want to perceive progress without staring at the web page — glance at the pet sticker in the screen corner to know if AI is still thinking, stuck, or waiting for your confirmation. Also adds companionship to DSH web page/desktop, suitable for users who like cell-shaded/anime-style desktop pets but don't want to install standalone desktop pet software.
Prerequisites & Compatibility
| Dependency | Minimum Version | Description |
|---|---|---|
| DSH (DeepSeek Harness) | Tested on 0.1.0-rc.5 / fairy desktop edition | Plugin does not declare dsh minimum version in manifest |
| Node.js | >= 22.19.0 | From package.json engines.node |
| Platform (Desktop Floating) | Windows x64 | package.json declares os: ["win32"], cpu: ["x64"]; desktop floating unavailable on other platforms, automatically falls back to in-page pet |
| Platform (In-Page Pet) | Cross-platform | SSE / multi-pet / double-click painting / settings all available on macOS, Linux, browser |
| Native Modules | None | Only depends on Node built-in APIs (fs, http, tls, child_process) and Cordis / Schemastery |
Installation
dsh plugin --profile web add dsh-pet-remielle
Configuration Options
| Config | Type | Description | Default |
|---|---|---|---|
| enabled | Switch | Enable pet; immediately hidden when disabled, restored when re-enabled | On |
| scale | Slider (0.5–2, step 0.05) | Character size scale factor | 1.0 |
| opacity | Slider (0.3–1, step 0.05) | Pet opacity | 1.0 |
| locked | Switch | Lock position (disable dragging) | Off |
| paused | Switch | Pause animation | Off |
| hidden | Switch | Hide pet | Off |
| includeSubagents | Switch | Allow sub-agents to compete for pet status | Off |
| showBubble | Switch | Show status bubble above pet (stage / task / progress) | On |
| desktopMode | Switch | Desktop floating mode: display pet in separate always-on-top window; first time enabling without Electron runtime will prompt download (~200MB, falls back to in-page on failure) | Off |
| posX | Number | Pet X position; empty uses default | Auto |
| posY | Number | Pet Y position; empty uses default | Auto |
| activePetId | String | Currently displayed pet id | remielle (Remielle) |
| pets | List | Pet registry, each item contains id / display name / whether enabled | Default contains Remielle |
FAQ
Q: Pet not showing after installation?
A: Enabled by default. If "Enable pet" was turned off in settings, re-enable it; or re-check "Enable" in Settings → Remielle Pet in DSH web page top-right corner.
Q: What's the difference between desktop floating window and in-page pet?
A: Desktop floating is an independent transparent always-on-top window (Windows x64 only, requires Electron runtime), double-clicking "artwork" from painting pops up in a separate small window in the top-right corner; in-page pet is embedded in DSH web page, available cross-platform.
Q: What gets downloaded on first enable of desktop floating mode?
A: Downloads approximately 200MB of Electron runtime (only win32-x64). A confirmation prompt appears before downloading; failure automatically falls back to in-page display, no impact on other features.
Q: Will sub-agent status be reflected by the pet?
A: Not by default. Check "Allow sub-agents to compete for pet status" (includeSubagents) in settings to include sub-agents in status summary.
Q: Why can't old versions update directly?
A: Package name changed before 0.3.0 (before 0.2.0 it was @dsh-external/dsh-client-ui-pet-remielle, between 0.2.0–0.3.0 it was dsh-pet-remielle). Direct overlay upgrade triggers load errors; need to uninstall old version first then install new version.
Q: How to change pet image?
A: Place 6 stickers named 01.gif–06.gif (and optional pics/01.png etc. artwork) into assets/pets/
Q: What does status bubble "project · completed x/y · stage" display?
A: Comes from real-time DSH session events: project name from session header or working directory; progress counts completed items in current todo list; stage mapped from tool type (search/edit/test/command).
Q: Which features are available on macOS/Linux?
A: In-page pet, SSE push, multi-pet switching, double-click painting, all settings available; desktop floating window not provided, automatically falls back to in-page display.
Difficulty Level
Beginner — Plug-and-play after installation, default configuration shows pet; run through one session in DSH web page to understand sticker and bubble meanings.
Known Issues & Limitations
- package.json declares
os: ["win32"],cpu: ["x64"], meaning some DSH installation forms may not load this plugin in non-Windows/x64 environments; in-page pet itself is cross-platform, limited by this declaration. - First enable of desktop floating mode requires downloading ~200MB Electron runtime; offline/sandbox environments need to pre-extract Electron win32-x64 to
vendor/electron-win32-x64/, or setDSH_PET_ELECTRONenvironment variable pointing to existingelectron.exe. - Installations below version 0.3.0 cannot incrementally update (package name changed twice), must uninstall old version first then install new; plugin's "one-click update" button gives uninstall/reinstall guidance for low versions instead of direct overlay.
- Desktop floating window only supports Windows x64; enabling desktopMode on macOS/Linux won't error but only keeps in-page pet, won't actually spawn independent window.
由 DSH 真实会话事件驱动的多宠物网页桌宠：桌宠实时跟随 DeepSeek Harness 的任务进展，以贴纸动画 + 状态气泡呈现。
- 多宠物注册表 + 状态气泡（项目 / 阶段 / 待办 / 进度实时汇报）
- SSE 实时推送 + 可选的桌面悬浮窗（随包 Electron，透明置顶）
- 双击画画联动：粗笔刷揭示作品图（绘制中 → 得意中 → 淡出）
- 一键版本检查 + 增量更新
- 设置面板：宠物管理（多标签页）、插件配置卡片
兼容 DeepSeek Harness（含其分支）的 web profile；桌面悬浮模式默认关闭，可按需开启。
特性一览
| 能力 | 说明 |
|---|---|
| 状态来源 | DSH session/event 真实事件，非 DOM 抓取 |
| 状态机 | PetReducer 纯函数（含 mood 映射，可单测） |
| 消息协议 | 类型化协议（protocol.js） |
| 配置 | schemastery 持久化 + 设置页卡片 |
| 多 Session 优先级 | ✓（等待确认 > 错误 > 工作 > 思考 > 空闲） |
| 实时推送 | SSE 流（断线自动重连 + 轮询兜底） |
| 状态气泡 | message + detail（项目 · 已完成 x/y · 阶段） |
| 桌面悬浮 | 随包 Electron 透明置顶窗口（可选，默认关） |
| 多宠物 | 设置 → 宠物管理（注册表 + 切换当前宠物） |
| 版本更新 | 内置检查 + 一键增量更新 |
贴纸（mood）→ 状态映射
| 贴纸 | 展示 | 触发场景 |
|---|---|---|
| 01 绘制中 |  | THINKING + streaming：流式输出（正在写回复）、双击画画 |
| 02 摸鱼中 |  | WORKING / ERROR：调用工具（查找/编辑/测试/命令） |
| 03 得意中 |  | PULSE SUCCESS：回合完成、绘制完成、点击互动 |
| 04 思考中 |  | THINKING：回合/步骤开始、推理、结果整理 |
| 05 等待中 |  | WAITING：提问回答、审批等待、回合挂起（blocked） |
| 06 待机中 |  | IDLE / DISCONNECTED：空闲、回合结束之后 |
多 Session 同时运行时按 等待确认 > 错误 > 工作 > 思考 > 空闲 展示最需要关注的顶层任务；子 Agent 默认忽略（可在设置开启）。
宠物定义约定
assets/pets/<id>/01.gif 绘制中（输出/画画）
assets/pets/<id>/02.gif 摸鱼中（工具/错误）
assets/pets/<id>/03.gif 得意中（完成/互动）
assets/pets/<id>/04.gif 思考中
assets/pets/<id>/05.gif 等待中
assets/pets/<id>/06.gif 待机中
可选扩展（不影响完整性校验）：
assets/pets/<id>/07.gif 额外贴纸槽位
assets/pets/<id>/pet-manifest.json 每贴纸对齐偏移 + 作品图数量
assets/pets/<id>/pics/<n>.png 作品图（双击宠物随机弹出，n 从 1 起）
id 只能含字母、数字、下划线、连字符。内置宠物：蕾米埃尔（remielle，素材版权见 NOTICE）。
安装
适用于 DSH / DeepSeek Harness（含 Fairy 等基于 DSH 的分支）的 web profile。
# 方式一：npm 注册表（推荐，可一键增量更新）
dsh plugin --profile web add dsh-pet-remielle
# 方式二：GitHub 仓库（构建安装，无版本校验）
dsh plugin --profile web add github:Gin-7/dsh-pet-remielle
# 方式三：本地目录（开发调试，link 安装）
dsh plugin --profile web add D:\path\to\dsh-pet-remielle
# 方式四：GitHub Release tgz
dsh plugin --profile web add "C:\Users\you\Downloads\dsh-pet-remielle-<version>.tgz"
插件行 id：dsh-pet-remielle。卸载即复原，无残留。
更新
插件内置「宠物管理 → 更新」页 + 右下角更新气泡：检查 GitHub 最新版本，发现新版可一键更新。
| 安装形态 | 版本 | 更新方式 |
|---|---|---|
| 本地链接（link） | ≥ 0.3.0 | 一键 git pull（增量） |
| npm 注册表（registry） | ≥ 0.3.0 | 一键 pnpm update dsh-pet-remielle（增量） |
| 任意形态 | < 0.3.0 | 不支持自动更新：0.3.0 起包名已变更，需彻底卸载旧版本后重新安装 |
说明：0.3.0 之前存在包名/行 id 变更（0.2.0 之前为
@dsh-external/dsh-client-ui-pet-remielle，0.2.0–0.3.0 为dsh-pet-remielle）。直接git pull/pnpm update无法跨过该变更，所以低于 0.3.0 必须先卸载旧版再重装新版（否则会出现loaded without registering … via __ModuleLoader__.load之类的加载报错）。命令如下：
# 按实际安装的旧行 id 卸载（以下两条按需执行）
dsh plugin --profile web remove @dsh-external/dsh-client-ui-pet-remielle # 0.2.0 及之前
dsh plugin --profile web remove dsh-pet-remielle # 0.2.0 – 0.3.0
# 重新安装最新版（npm 或 GitHub 均可）
dsh plugin --profile web add dsh-pet-remielle
# 或： dsh plugin --profile web add github:Gin-7/dsh-pet-remielle
在「设置 → 宠物管理 → 更新」中，低于 0.3.0 的版本点击「一键更新」也会给出同样的卸载/重装指引，不会直接覆盖升级。
桌面悬浮模式（可选）
desktopMode 默认关闭。开启后使用 Electron 运行时拉起透明、置顶、无边框的独立窗口显示宠物。
- 窗口支持拖动（位置自动记忆）、滚轮缩放、双击画画、右键菜单。
- 双击画画：作品显示在桌面右上角的独立小窗，粗笔刷沿对角来回揭示，完成后「得意中→淡出」。
- 右键菜单：切换网页模式、锁定、气泡开关、角色大小、画画等。
- 关闭/切换后自动回到页面内；随 DSH host 退出自动关闭。
Electron 运行时来源（按顺序探测）：DSH_PET_ELECTRON 环境变量 → vendor/electron-win32-x64/（本目录不进 Git）→ 系统已安装的 Electron → 均无则仅页面内展示。
首次运行：若开启桌面悬浮模式但本机找不到 Electron 运行时，会提示下载并安装（需你确认，因 Electron 运行时约 200MB）；下载失败则自动回落页面内展示，不会影响其他功能。也可手动把任一 Electron win32-x64 发行包解压到
vendor/electron-win32-x64/，或设置DSH_PET_ELECTRON指向现有electron.exe。
平台能力
| 平台 | 桌面悬浮窗 | 页面内桌宠 |
|---|---|---|
| Windows x64（Fairy 桌面版 / 纯 DSH） | ✓（Electron 透明置顶窗口） | 桌面模式下自动隐藏 |
| macOS / Linux | ✗ | ✓（自动回落页面内） |
使用
- 点击桌宠：切换随机贴纸心情。
- 双击桌宠：进入画画动画，绘制完成后在屏幕（右上角）弹出作品图，随后淡出。
- 右键桌宠（页面内）：角色大小 / 锁定位置 / 显示气泡 / 桌面悬浮模式 / 重置位置 / 暂停动画。
- 右键桌宠（桌面窗）：角色大小 / 锁定位置 / 显示气泡 / 画画 / 切换到网页模式。
- 滚轮：调整角色大小。
- 页面内宠物菜单也可反向拉起桌面窗。
配置（设置 → 插件 → 蕾米埃尔桌宠）
| 字段 | 默认 | 说明 |
|---|---|---|
| enabled | true | 启用桌宠（禁用立即隐藏，重新启用恢复） |
其余外观/行为项（角色大小、透明度、锁定、气泡、桌面悬浮、暂停、隐藏……）统一放在「设置 → 宠物管理」与右键菜单中管理，不再重复展示在插件配置卡片里。
设置 → 宠物管理
宠物注册表独立标签页，含多个子页：外观 / 行为 / 桌面悬浮 / 更新 / 反馈。
- 启用/禁用宠物、设为当前、改名、添加新宠物。
- 「更新」：显示当前版本，检查更新、一键更新、查看升级说明。
- 「反馈」：显示桌宠版本号，提交 Bug / 功能建议。
开发
npm install
node scripts/build-client.mjs # 构建 lib/client.js（版本号从 package.json 注入）
npm test # node --test 单测
npm run check # 语法检查
目录结构
src/
├── index.js # 宿主：配置、事件接线、config/state/pets/assets/desktop 端点、自更新路由
├── self-update.js # 版本检查 + 一键更新（GitHub 直连 + HTTP 代理回退；git pull / pnpm update）
├── pet-reducer.js # 纯状态机：会话事件 → state/pulse/task（可单测）
├── protocol.js # 类型化协议：PetState / PetMood / PetMessageKind
├── pets.js # 宠物注册表：目录发现/合并/校验（可单测）
├── status-copy.js # 蕾米埃尔风格状态文案（可整体替换）
├── desktop-window.js # 桌面模式：Electron 发现 + 窗口进程管理（可单测）
├── pet-window.js # 桌面模式：Electron main（透明置顶窗口 + 屏幕右上角作品窗）
├── pet-view.html # 桌面模式：宠物窗口页面（GIF + 气泡 + SSE + 画画）
└── client.core.js # 浏览器端：宠物 UI + 设置（构建时包装）
lib/client.js # 构建产物（版本号注入，安装即用）
assets/pets/remielle/ # 蕾米埃尔素材（GIF + 作品图）
scripts/build-client.mjs
test/ # node --test
发布到 npm
npm login
pnpm version patch # 升版本
pnpm pack --dry-run # 检查发布内容（不含 node_modules / vendor）
pnpm publish
发布内容由
files字段限定：src/、lib/client.js、assets/、scripts/、test/、cordis.patch.yml、NOTICE、README.md。vendor/（Electron 运行时）不发布，桌面模式按需下载。
许可与素材版权
代码以 MIT 许可分发；蕾米埃尔形象与 GIF/作品素材版权归米哈游（HoYoverse）所有，
禁止商业使用与再分发素材。详见 NOTICE。
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/Gin-7/dsh-pet-remielle)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.