Skip to content

dsh-desk-pet-plugin

Verified

dsh-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

npm license

一只悬浮在屏幕上的桌宠插件,为 DeepSeek Harness 而生。 A floating desk pet for DeepSeek Harness.

preview


中文

它是什么

桌宠有自己的小窗口(透明、无边框、置顶),不占用也不依附 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 运行时。不会静默下载,流程是:

  1. 打开桌宠时先检查环境(不联网、不下载)
  2. 本机已有可用的 Electron(≥ 28)→ 直接复用,跳过下载
  3. 缺失或版本过旧 → 弹窗询问(显示包名,不显示体积)→ 点「下载」才开始下载
  4. 下载完成后桌宠直接出现;点「取消」则什么都不做,右下角保留 🐾 入口

下载目标:

~/.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:

  1. Opening the pet first checks the environment (no network, no download).
  2. A local Electron ≥ 28 is reused as-is — nothing is downloaded.
  3. Missing or too old → a card asks for confirmation (it names the package but shows no size) → only then does the download start.
  4. 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