Skip to main content

How to use dsh-pet-remielle

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.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-pet-remielle

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add dsh-pet-remielle

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 多宠物注册表 + 状态气泡（项目 / 阶段 / 待办 / 进度实时汇报）
  • SSE 实时推送 + 可选的桌面悬浮窗（随包 Electron，透明置顶）
  • 双击画画联动：粗笔刷揭示作品图（绘制中 → 得意中 → 淡出）
  • 一键版本检查 + 增量更新
  • 设置面板：宠物管理（多标签页）、插件配置卡片

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What to do if the desktop pet doesn't show after installation?

It is enabled by default. If it was disabled in settings, just re-enable it; or go to Settings → Remiel Desktop Pet in the top-right corner of the DSH webpage and check the enable option again.

What's the difference between the desktop floating window and in-page desktop pet?

The desktop floating window is an independent transparent topmost window (Windows x64 only, requires Electron runtime). Double-clicking the "artwork" from drawing will pop up in an independent small window in the top-right corner of the screen; the in-page desktop pet is embedded within the DSH webpage and works cross-platform.

What gets downloaded when first enabling desktop floating mode?

It downloads approximately 200MB of Electron runtime (win32-x64 only). A confirmation prompt will appear before downloading; if download fails, it will automatically fall back to in-page display without affecting other functionality.

Will sub-agent statuses also be reflected by the desktop pet?

Not by default. You need to check "Allow sub-agents to seize pet status" (includeSubagents) in settings to include sub-agents in the status summary.

Why can't old versions be updated directly?

The package name changed before version 0.3.0 (before 0.2.0 it was @dsh-external/dsh-client-ui-pet-remielle, and between 0.2.0–0.3.0 it was dsh-pet-remielle). Direct overlay upgrade will trigger loading errors; you need to uninstall the old version first before installing the new one.

How to change the desktop pet's appearance?

Put 6 stickers named 01.gif–06.gif (and optional artwork like pics/01.png) into the assets/pets// directory, then go to Settings → Pet Management → Appearance to enable it and set it as the current pet.

What does the status bubble's "Project · Completed x/y · Phase" display show?

Real-time events from DSH sessions: the project name is taken from the session header or working directory; progress shows completed items in the current to-do list; the phase is mapped from the tool type (search/edit/test/command).

What features are available on macOS / Linux?

In-page desktop pet, SSE pushing, multi-pet switching, double-click drawing, and all settings are available; only the desktop floating window is not provided and will automatically fall back to in-page display.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 未声明（已在 DSH 0.1.0-rc.5 / fairy 桌面版实测）
  • Node: >=22.19.0
  • Platforms: Windows

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule