linkbag/dsh-capyreporter

🐾 CapyReporter

English | 简体中文

A local task reporter for DeepSeek Harness Web: a page pet, plus an optional transparent always-on-top Electron companion.

What it reports

• Live workspace + session labels and a bounded assistant milestone preview: the collapsed bubble follows the assistant's latest statement instead of tool chatter. Reasoning stays hidden unless you opt in to *Report thinking*; prompts, tool arguments and tool output are never displayed.
• Separate completed, cancelled, failed, blocked, interrupted and output-limit outcomes, using actual DSH turn/end events. Idle alone is not success.
• Independent unread results for parallel sessions: starting another session does not erase a result. Up to 20 results are retained in memory for six hours.
• Compact headlines and explicit Details / Go to chat / Mute / Dismiss result controls. Keyboard support and reduced-motion-safe styling.
• Ten-language UI with a live switcher (English, 中文, Español, हिन्दी, العربية, Português, Русский, 日本語, Français, Deutsch) that follows the browser/OS language by default, applies to the page pet and the desktop companion, and flips to right-to-left for Arabic.
• Optional away notifications: off by default, require both the plugin toggle and browser permission, and do not notify a focused page. Different open DSH tabs may each notify.

Install

dsh plugin --profile web add dsh-capyreporter

0.6.19 was re-verified against DeepSeek Harness 0.2.1-alpha.1 (routes, slots, client bundle serving, and agent/session events). The only peer dependencies are @deepseek-ai/cordis and react, which DSH supplies to the plugin; no DSH package version range is pinned. Refresh after a client update; host-code updates need plugin reactivation or a DSH restart. A page refresh alone cannot replace a loaded host module.

Optional desktop companion

Desktop mode is on by default: an install without saved preferences starts the always-on-top window, so the pet appears as a desktop overlay right away. The page pet stays visible until that window is healthy, and *Use page pet instead* turns it off. Use DSH_PET_ELECTRON_PATH (or ELECTRON_PATH) for an existing Electron executable. The plugin also checks $DSH_HOME/electron/electron.exe on Windows (electron on Linux), the user npm installation, and legacy Windows install locations. No binary is downloaded automatically. macOS should use an explicit executable path.

The host's actual port is used automatically. DSH_CAPYREP_BASE_URL can override it with an exact loopback HTTP(S) origin, not a URL with credentials, paths or auth tokens. Remote/reverse-proxied origins are deliberately not supported by this plugin's local-only route boundary.

The page pet is hidden only after the desktop has decoded its image, fetched activity, and reported healthy. Missing Electron, a failed renderer, or a stale heartbeat keeps/restores the page fallback. Some exclusive fullscreen applications can still cover a topmost window. Empty window background is click-through; the artwork element and bubble are interactive rectangles.

Controls

Action · Result Drag the pet · Move it; dragging does not dismiss results or open DSH Ctrl / Cmd + wheel over the pet · Resize, 50–250% (ordinary scrolling remains available) Click, right-click, or Enter/Space on pet controls · Open controls Details / Collapse · Toggle scrollable session details Go to chat · Open the session the headline refers to (running, else finished) in the current window via DSH workspace navigation; also in the pet menu Dismiss / Dismiss result · Always shown: hide the current bubble (new activity resurfaces it); after a run ends, acknowledge the result Drag any bubble edge/corner, arrow keys on the corner handle, or Ctrl + wheel over the bubble · Resize the bubble (width 260–560, height 160–720 px), remembered per browser; buttons stay pinned to the bottom edge and the details area scrolls when the bubble is short Drag any edge/corner of the desktop bubble · Resize the always-on-top bubble; its window follows so the pet stays anchored above the bubble Double-click a resize handle, or Reset bubble size in the pet menu · Restore the default 360 px width and content-driven height Mute 30 min · Silence the bubble for the configured duration (default 30 min) Restore bubble · Show current activity again and end a mute early Double-click desktop pet / Open DeepSeek Harness · Open the configured DSH origin Escape · Close controls/details

Appearance and preferences

Settings → 🐾 CapyReporter controls visibility, desktop mode, size, artwork, notifications, the Status bubble mute duration (10/30/60/240 min, default 30), Report thinking (opt-in 💭 reasoning as the live milestone, off by default) and the interface Language (Auto plus the ten supported locales; Arabic switches to RTL and the desktop companion follows). *Auto* tracks your browser/OS language and anything unsupported falls back to English; the choice persists on the host. Artwork must be a PNG, at most 4 MiB, with each side 1–4096 px. SVG, arbitrary data URLs and malformed/truncated containers are rejected. Custom-to-custom changes invalidate the image revision immediately.

Image, size and toggles are saved atomically to $DSH_HOME/capyreporter.json (default ~/.dsh). A legacy homura-pet.json is read only when that file is absent. Page position is stored separately in this browser's local storage; desktop position is session-only. Corrupt settings are logged, not silently replaced with unrelated legacy settings. Failed writes leave the previous preferences active.

Hide pet is not uninstall. Remove the package using DSH's plugin manager or:

dsh plugin --profile web remove dsh-capyreporter

Security and diagnostics

Plugin HTTP handlers are separate from DSH's SPA authentication gate. This plugin rejects cross-origin/opaque browser requests, non-loopback callers/Host headers and GET mutations; it does not expose wildcard CORS. The desktop uses an activation-scoped capability held in its main process, a sandboxed renderer, restrictive CSP and an allowlisted IPC broker. See architecture for boundaries, including what they do not protect against.

No telemetry or outbound service is used. Notifications and the desktop window can expose session titles/assistant previews on your screen; disable them in shared-screen environments.

• Troubleshooting
• Audit, comparisons and validation
• Architecture

Development

Handwritten JavaScript is the shipped source; there is no build step.

npm ci
npm test
npm run verify
npm run test:browser
npm pack --dry-run

Browser smoke tests use installed Chrome by default (DSH_TEST_BROWSER_CHANNEL=chromium for a Playwright browser) and an optional existing Electron executable. They use temporary settings and ephemeral loopback fixtures, never your installed preferences or running DSH server. Electron coverage is explicitly skipped when no binary is found. Tests and dev dependencies are not runtime requirements.

MIT. Artwork is replaceable; other projects referenced in the audit were studied for architecture, not copied into this package.