Vai al contenuto principale
N

dsh-desktop-pet-naiwa

night-maze/dsh-desktop-pet-naiwa

Windows desktop pet for DSH: a Cordis host plugin drives a transparent, always-on-top WPF subprocess over an authenticated loopback bridge, projecting turn, step and tool events into a progress bar with localized tool labels, playing completion and failure sounds, showing daily token totals with a list-price cost estimate plus the real wallet balance, and accepting weighted click interactions, long-press drag with edge half-hide, and file drops to the Windows Recycle Bin; a sidebar entry and settings panel configure scale, volume, assets and thresholds. Windows only, and the cost figure is an estimate. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Installazione

dsh plugin --profile web add github:night-maze/dsh-desktop-pet-naiwa

README

桌宠-奶娃小时候 (DSH Desktop Pet)

npm GitHub

A Windows desktop companion built as a DeepSeek Harness plugin. It renders a transparent, frameless, always-on-top WPF window and reports real Agent progress, today's estimated Token cost, and the real Platform wallet balance. It supports click interactions, long-press drag, edge hiding, and drag-and-drop files to the Windows Recycle Bin.

中文完整说明:README.zh.md。

Why a Host plugin plus a WPF child process

DSH client plugins are browser-side React UI running in a sandbox; they cannot create native OS windows. The plugin therefore consists of:

  • a Cordis Host plugin (lib/index.js) that observes session/event, maintains a replay-aware daily token ledger, reads the real account balance, and owns a child process;
  • a WPF subprocess (pet/DesktopPet.ps1 + DesktopPet.cs) that renders the pet and performs gestures/file drops;
  • an authenticated loopback newline-JSON bridge between them.

Features

  • Agent turn/start, step/start, tool/call, turn/end, agent/error projection.
  • Progress bar plus step/tool text; no invented percentages.
  • Completion sound (original cute-monster WAVs), failure/cancel cues.
  • Today's token totals and estimated cost from public list prices (peak/off-peak aware); UI labels the result with ≈.
  • Real balance via ctx.deepseekAccount.getBalance; failures keep the last value as stale, never zero.
  • Six built-in click interactions (blink, jump, shake, heart, random line, dance), configurable weights/texts.
  • Long-press pickup with pendulum/spring drag, natural release, edge half-hide with hover slide-out.
  • Transparent hit-testing: transparent pixels pass clicks through.
  • Drag-and-drop files/directories to the Recycle Bin via IFileOperation + FOFX_RECYCLEONDELETE; no permanent-delete fallback. AppContainer/low-integrity processes are refused.
  • Configurable image/audio assets, thresholds, refresh intervals, currency, precision, pricing, protected paths.
  • A client half registers a 🐾 桌宠 sidebar entry and a settings panel for scale, volume, stats display, drag thresholds, refresh/restart/show/hide. See docs/client-plugin.md.

Quick start

Install from npm:

dsh plugin --profile desktop add dsh-desktop-pet-naiwa

Or install a local checkout:

dsh plugin --profile desktop add link:F:\path\to\dsh-desktop-pet-naiwa

Then enable the dsh-desktop-pet-naiwa bundle in Plugins (or add it to dsh.profile.bundles), remove any absolute-path development row, and restart/reload. After the first client-graph scan, the sidebar shows 🐾 桌宠; refresh the page if it is not there yet.

See README.zh.md for installation, configuration, security guarantees, tests, acceptance, and known limitations. Full config sample: config.example.yml. Acceptance checklist: docs/acceptance.md.

Tests

node test/run-tests.mjs          # host unit tests
node test/mock-host.mjs          # real WPF + mock Cordis integration
powershell -STA -File scripts/demo.ps1

The recycle test must run in a normal user process, not the DSH workspace sandbox:

powershell -STA -File scripts/test-recycle.ps1

Safety boundary

The only file-removal path is the Windows Shell recycle API with FOFX_RECYCLEONDELETE. If the Shell cannot recycle, the operation fails and the original stays. The pet refuses drive roots, system directories, reparse points, and restricted (AppContainer/low-integrity) processes. Cost is an estimate, balance is real, and progress is not fabricated.

Plugin correlati