English · 简体中文

Harness Widgets

A beautiful, extensible right-side widget system for DeepSeek Harness.
Multi-column grids · 2×4 tiles · continuous magnification · built-in component marketplace

Harness Widgets is a persistent DSH bundle plugin built on the Cordis composition model. It provides a customizable multi-column widget rail on the right side of the conversation page — real-time session insights, usage monitoring, and quick actions — with an extensible declarative registry.

Features

Multi-Column Grid

Continuous Magnification

macOS-Dock-style hover magnification with two modes (toggle in Settings → 组件 → 无极变化):

• Stepless (continuous follow): truly stepless — every card's scale is driven by its own continuous Euclidean distance to the pointer, so the peak glides smoothly between cards on any pointer movement. It snaps to its steady right-anchored geometry every frame (transition: none), so a card's right edge stays flush with the rail even mid-motion — no width/right desync while the pointer moves.
• Discrete (default): reuses the same continuous geometry but snaps the pointer onto a quantized grid (row/column centres + the midpoints between adjacent ones: 2·rows−1 Y points, 2·cols−1 X points), with a 0.2s tween gliding the peak between grid points.

In both modes the magnified deck is painted by a fixed overlay outside the rail's scroll-clip box, so leftward growth escapes clipping while the resting rail width (and the conversation column distance) never changes. Scaling preserves the square card shape and constant spacing; magnification is adjustable in settings (1.0–1.4).

Built-in Widgets

Component Marketplace

• Browse all widgets (system + external), search, size-switch preview, install per widget@size;
• The installed list supports drag-reorder, config editing, and one-click 2×2 ↔ 2×4 (auto-dedup — one instance per widget/size);
• The widget-config tab supports per-card customization (quote of the day, heatmap window alignment, etc.).

OpenCode Go Usage

Rolling / weekly / monthly usage windows + percentage + reset time. The host half registers a same-origin route proxying opencode.ai; the browser makes no cross-origin requests, and keys go through DSH credentials.

Architecture

• Widget registry: WIDGETS declarative descriptors (id / name / size / group / render); the rail and the settings page share one registry — adding a widget is just one descriptor;
• Data collector: mounted on the conversation.composer.dock slot, which renders only when an active session exists — a natural "session alive" signal;
• Host half: webServer + credentials services; registers the /api/opencode-usage same-origin proxy route;
• Reversible cleanup: all registrations are managed by the fiber-effect lifecycle; uninstalling restores everything;
• Slot integration: shell.overlay (panel), conversation.session.header.utilities (capsule toggle), settings.section (settings page).

Installation

# via npm (plugin market)
dsh plugin --profile web add harness-widgets

# local development (link)
dsh plugin --profile web add link:D:/dsh-home/plugins/harness-widgets

After installing, hard-refresh the browser (Ctrl+Shift+R) and click the "组件" (widgets) capsule in the session header to expand the rail. The OpenCode Go widget needs OPENCODE_GO_API_KEY configured in the Models settings.

Development

pnpm install
pnpm run build      # tsdown builds lib/
pnpm run check      # typecheck + tests + build

• peerDependencies: @deepseek-ai/dsh-client-ui-slots, dsh-client-runtime (provided by the DSH web profile);
• cordis.patch.yml inserts one widgets row; the host half and browser half are loaded by the loader and client-modules respectively.

Compatibility

• DeepSeek Harness 0.1.0-rc.6 and compatible later 0.1.x;
• Integrates via shell.overlay / conversation.session.header.utilities / conversation.composer.dock / settings.section;
• Coordinates explicitly with dsh-better-sidebar's right rail (shares --dsh-sidebar-width); no residue after uninstall.

Changelog

v1.0.0

New

• Settings → 组件: add a "无极变化（连续跟随）" switch exposing the real-time continuous magnification mode (peak follows the pointer every animation frame).
• Truly stepless magnification: every card's scale is driven by its own continuous Euclidean distance to the pointer (rail-content coords) instead of a discrete nearest-card anchor, so the peak glides smoothly between cards on any pointer movement.
• Discrete mode now REUSES the same stepless geometry: the live pointer coordinates are snapped onto a discrete grid of row/column centres plus the midpoints between adjacent ones (rows → 2·rows−1 Y points, cols → 2·cols−1 X points), and the 0.2s tween glides the peak between those grid points. Both modes therefore share one right-edge-anchored posture.

Fixed

• Hover magnification no longer widens the rail or pushes the conversation column right (bell-curve overshoot removed from --dsx-rail-w); a magnified card's leftward growth is painted by a fixed overlay OUTSIDE the rail's scroll-clip box, so it escapes clipping while the resting rail width and conversation distance stay unchanged.
• The magnify overlay mirrors the rail's exact box model (same padding/box-sizing + inner deck), so magnified cards stay flush with the resting rail's right edge with no extra hit-test cost.
• The rail's add button fades with the static cards while magnifying; the overlay mirrors it at its resting position so it stays visible and right-aligned.
• Stepless mode snaps to its steady right-anchored geometry every frame (transition: none) — a tween left cards in a non-steady intermediate pose while the pointer moved, letting the right edge stray past the rail until the pointer stopped. Discrete mode keeps its 0.2s settle tween.

v0.3.0

New

• Multi-column grid: 1 / 2 / 4 columns (2 by default), magnification supported.
• 2×4 tiles: context-waterline 2×4 version (top-right % + extended segment bar); the same widget can be installed as both 2×2 and 2×4.
• Component marketplace with system widgets + per-instance (widget@size) install; installed and preview both support 2×2 ↔ 2×4 (auto-dedup).
• Continuous wave animation: hover magnification changed from discrete steps to continuous exponential decay, responding smoothly as the pointer moves in X/Y.
• Gap-free packing (best-fit) — no holes at any drag order.

Fixes

• 2×4 card height wrongly filled by width, causing abnormal occupancy.
• Switching sizes no longer duplicates; deleting no longer removes same-name/same-size instances.
• Magnification didn't respond vertically at horizontal peak transitions.

v0.2.2

• Fix daily usage not resetting across days (token cumulative baseline bound to the date; auto-clears across days).

v0.2.1

• Fix heatmap count spikes (ledger baseline persisted; re-mount only counts genuine new increments).
• Fix seed update not applying (forced overwrite; version raised to .3).

v0.2.0

• macOS-Dock-style hover magnification (discrete steps + layout swap).
• Per-card config: quote text/alignment/wrapping, heatmap window alignment.
• New widgets: tasks, one-click compact, context waterline, usage heatmap (self-tracked), quote of the day.
• Brand-blue title; one-click compact button moved to the bottom-right.

v0.1.1

• Widget rail transparent background, hidden scrollbar (cross-browser), removed top padding.

v0.1.0

• Right widget rail + 7 built-in stat widgets + 3 OpenCode Go usage widgets;
• Settings → widgets page (preview / install / reorder);
• In-progress turn LLM/tool time refreshed every second.

Roadmap

The widget registry (WIDGETS descriptors) already lays the foundation for more — adding a widget is just one descriptor.

• Multi-platform usage widgets: Z.ai, DeepSeek balance, etc., reusing the host same-origin proxy + credentials pattern;
• Utility widgets: one-click compact (needs DSH official compaction) and more;
• External integrations: Feishu / WeChat push & interaction, keys strictly via DSH credentials;
• Widget marketplace: open a third-party widget registration mechanism so community widgets can join like plugins.

License

MIT