dsh-desk-pet-plugin
Verifieddsh-desk-pet-plugin · v1.4.3 · MIT · Web UI
Floating desk pet for DeepSeek Harness: a screen-level animated pet that mirrors live session status, jumps to the session on click, and installs pets from petdex.dev.
Install
dsh plugin add dsh-desk-pet-plugin Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-desk-pet
一只悬浮在屏幕上的桌宠插件,为 DeepSeek Harness 而生。 A floating desk pet for DeepSeek Harness.

中文
它是什么
桌宠有自己的小窗口(透明、无边框、置顶),不占用也不依附 DSH 窗口:DSH 最小化、被遮挡、甚至不在当前屏都没关系,宠物就在屏幕上。它会跟着你的会话状态变表情、冒气泡,点一下气泡直接跳到那个会话。
功能
- 实时状态:气泡里带一个和左侧会话列表同色的圆点 —— 运行中(灰)、等待你操作/审批/回答(琥珀)、已完成(绿)
- 点击跳转:点气泡把 DSH 拉到前台并打开对应会话(静默跳转,不弹提示)
- 拖拽:拖到任意位置,松手自动吸附回屏幕内;支持多显示器
- 右键菜单:
设置桌宠/隐藏(隐藏后 App 右下角出现 🐾,点一下随时唤醒) - 宠物图鉴:内置小猫,或从 petdex.dev 搜索安装社区动画宠物;切换时气泡显示「换装中…」
- 气泡透明度:设置里 30%–100% 实时可调,默认 90%
- 深色模式:跟随系统
安装
在 DSH 会话里(推荐,会同时装包并选入 profile):
plugin_manager action=install_bundle target="dsh-desk-pet-plugin"
或命令行:
dsh plugin --profile <你的profile> add dsh-desk-pet-plugin
装完后 DSH 左侧边栏「插件」里会出现 桌宠,启用即可(一般安装时已自动启用)。
运行时(首次启用时会询问)
桌宠是一个独立的 Electron 浮窗进程,需要一个 Electron 运行时。不会静默下载,流程是:
- 打开桌宠时先检查环境(不联网、不下载)
- 本机已有可用的 Electron(≥ 28)→ 直接复用,跳过下载
- 缺失或版本过旧 → 弹窗询问(显示包名,不显示体积)→ 点「下载」才开始下载
- 下载完成后桌宠直接出现;点「取消」则什么都不做,右下角保留 🐾 入口
下载目标:
~/.petdex/dsh-float/runtime # Electron 45.2.2,约 120 MB,来自 npmmirror
- 最低可用版本 Electron 28:低于此值不采用,会提示「运行环境需要更新」
- 已下载的运行时带版本戳;与内置版本不一致时同样提示更新
- 手动指定任意 Electron:
DESK_PET_ELECTRON=/path/to/Electron - 二进制读取版本时会剔除
ELECTRON_RUN_AS_NODE(否则会读到 Node 版本)
数据与网络
| 位置 / 目标 | 内容 |
|---|---|
~/.petdex/pets/ |
已安装的宠物素材(与 petdex CLI 同目录结构) |
~/.petdex/dsh-float/ |
运行时、窗口位置 pos.json、子进程 pid |
petdex.dev / assets.petdex.dev |
只在打开图鉴、搜索、安装宠物时访问(由宿主代理,不受页面 CSP 限制) |
registry.npmmirror.com |
仅首次下载 Electron 运行时 |
清空 ~/.petdex/ 即可完全移除残留数据。
平台
- macOS:已完整验证(含 Retina、多显示器、全屏 App 之上置顶、Dock 隐藏)
- Windows / Linux:代码路径已兼容但未实测,欢迎反馈
卸载
plugin_manager action=remove_bundle target="dsh-desk-pet-plugin"
English
A screen-level desk pet for DeepSeek Harness. It lives in its own always-on-top, transparent window — independent of the DSH window — and mirrors your session state.
Features
- Live status — the bubble carries a status dot whose colour matches the sidebar: running (grey), waiting for you (amber, incl. approvals/questions), finished (green).
- Click to jump — clicking the bubble raises DSH and opens that session.
- Drag anywhere — released windows snap back inside the screen; multiple displays supported.
- Right-click menu —
Desk pet settings/Hide. Hidden pets leave a 🐾 chip in the app to bring them back. - Pet catalog — built-in cat, or search and install animated pets from petdex.dev. Swapping shows a "Switching…" bubble.
- Bubble opacity — 30–100 %, live, default 90 %.
- Dark mode — follows the system appearance.
Install
plugin_manager action=install_bundle target="dsh-desk-pet-plugin"
or
dsh plugin --profile <profile> add dsh-desk-pet-plugin
Runtime (asked once, never silent)
The pet runs in a separate Electron process and needs an Electron runtime:
- Opening the pet first checks the environment (no network, no download).
- A local Electron ≥ 28 is reused as-is — nothing is downloaded.
- Missing or too old → a card asks for confirmation (it names the package but shows no size) → only then does the download start.
- The pet appears as soon as the runtime is ready; Cancel does nothing and leaves the 🐾 entry point in place.
Download target: ~/.petdex/dsh-float/runtime (Electron 45.2.2, ~120 MB from
npmmirror). Minimum accepted local version is Electron 28; an already
downloaded runtime carries a version stamp and is refreshed when it disagrees.
Override the binary with DESK_PET_ELECTRON=/path/to/Electron.
Data
~/.petdex/pets/ holds installed pet assets, ~/.petdex/dsh-float/ holds the
runtime window position and child pid. Network access happens only when you
open the catalog, search, or install a pet (proxied through the Host so the page
CSP never applies), plus the one-time runtime download.
Platform
macOS is fully verified; Windows and Linux paths exist but are untested.
License
MIT © ZGJ