Harness Insights
中文文档
A bundled Cordis plugin for DeepSeek Harness. It adds a local-first Usage insights settings page without modifying upstream Harness source.
Published package: @anarkhgatsby/deepseek-harness-insights.
Preview
The plugin adds a Usage insights page under Harness settings, with token
activity, model usage, active sessions, cache hit rate, activity breakdown, and
the most frequently used tools.
- Dual-Theme Support:
- ☀️ Light Mode: Pure classic emerald/forest green gradient.
- 🌙 Dark Mode: Codex-inspired deep obsidian canvas with vibrant neon hot-pink/magenta (
#ff3388) saturation curve.
- Golden Ratio Heatmap Matrix: Dense, breathable 2.7px grid spacing with enlarged cells.
Harness Insights usage dashboard
Install as a Harness bundle
The package follows the official Harness bundle manifest and can be installed
into a profile with dsh plugin:
dsh plugin --profile demo add @anarkhgatsby/deepseek-harness-insights
dsh --profile demo
To remove it later:
dsh plugin --profile demo remove @anarkhgatsby/deepseek-harness-insights
The plugin is web-only and supports both the legacy 0.1.2+ projection cache
API and the 0.1.5+ session-persistence API. On its first startup after a
Harness runtime upgrade, it rebuilds local derived projection checkpoints from
the session event log. If a retired runtime format prevents DSH from replaying
a legacy subagent log, Insights can safely recover only its previously stored
usage aggregate after verifying the session lifecycle; it never reads message
content for that recovery. Large histories may populate progressively; no
message content is sent anywhere. It is an independent, unofficial community
plugin and is not published by DeepSeek.
Compatibility and dependencies
| Item | Supported / validated version |
|---|
| Harness host | Legacy cache API 0.1.2+; session-persistence API 0.1.5+ |
| Validated current runtime | DeepSeek Harness 0.1.5-rc.1 and 0.1.5-rc.2 |
| Cordis | ^4.0.2 |
| Harness projection client services | matching RC1 or RC2 release |
| Plugin release | @anarkhgatsby/deepseek-harness-insights@0.1.9 |
The next desktop bundle can ship this exact 0.1.9 plugin release. The
plugin has no native dependency and uses only the local Harness host.
For local development, the same bundle can be installed from a checkout:
dsh plugin --profile demo add ./packages/harness-insights
The package also retains its dsh.client metadata so the browser entry is
loaded with the required Harness client services.
Data boundary
Harness Insights folds only structured session metadata:
assistant/message.data.usageassistant/message.data.message.source.provider/modeltool/call.data.name- event timestamps and session projection identity
It does not request session history in the browser, store message content, read API keys, or upload usage data. Historical aggregation runs in the local host through Harness's official session projection APIs and persists only the derived projection checkpoint owned by Harness.
Packaging
The package is developed independently under packages/harness-insights and copied into each bundled runtime at build time. Harness Desktop deploys its tiny pure-JavaScript runtime copy to the standard out-of-tree plugin root under $DSH_HOME/node_modules and loads it through a --patch overlay.
The plugin contains no architecture-specific native modules and is shared by macOS arm64, macOS x86_64, and Windows x86_64 builds.
Tool icon assets
assets/tool-icons contains the project-provided Codex-style Harness tool icon set: 26 matching SVG pairs for light and dark interfaces. The build embeds the optimized pairs into the client bundle; the UI switches them through Harness's body[data-ds-dark-theme] contract without its own theme preference.
