MIT-licensed, read-only DSH analytics plugin: turns session logs into cost / token / tool-call reports with deterministic findings, collaboration review and PNG / HTML / PDF export.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-06
License
MIT
01What can it help you accomplish?
Turn DSH session logs into daily / weekly / monthly / yearly / custom analytics reports
Cost, tokens, tool calls, retry bursts, dangerous ops and a secret-pattern scan, with deterministic findings
DSH users who want to see what their agent spent and did, per session and per period
Export a DeepTrace report for sharing or archiving
Web panel report, PNG, printable HTML page, and PDF (A4) — plus a markdown report from the `whale_report` tool
Teams reviewing agent spend and collaboration, or archiving period reports
02How to install into DeepSeek Harness
Prerequisites
- DSH (DeepSeek Harness, web) environment; official compatible baseline DSH 0.1.1-rc.2 (peer `>=0.1.1-rc.2 <0.2.0`)
- (optional) DSH-better-sidebar to surface the 深迹 Tab in the + menu; without it a floating button is the fallback
Installation steps
- 01
Run `dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"` to register into dsh web (recommended, full features)
$ dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"
- 02
Restart dsh web so the host code takes effect; the client bundle auto-updates with the plugin
- 03
(dependency only) `npm install dsh-whale-report@0.6.1` — installs the package but does NOT register it as a DSH plugin
$ npm install dsh-whale-report@0.6.1
Verify the integration
- Open the 深迹 Tab from the + menu in the DSH web sidebar (or the bottom-right floating button if better-sidebar is not installed)
Rollback
- Uninstall via the dsh plugin manager; data goes through the official seam and uninstall is clean
03DSH integration and capability boundaries
DSH plugin registered into dsh web via `dsh plugin --profile web add` (official seam ctx.sessionQuery + storage domain)
Period reports (6 presets)
DSH session event logs (official seam ctx.sessionQuery + storage domain)→daily / weekly / monthly / yearly / 24h-rolling / custom reports with baseline deltas
Cost & token accounting (read-only)
session events→cost (official peak/off-peak pricing, historically correct), tokens, tool calls, retry bursts, dangerous ops, secret-pattern presence scan
Read-only by default; controlled Apply seam (shell.timeoutMs)
deterministic findings (Repeated Tool Failure / Retry Waste / Peak Cost)→recommendation + evidence + verification plan; on approval, a single `shell.timeoutMs` change, then VERIFIED / NOT IMPROVED / INCONCLUSIVE
only writes the `shell.timeoutMs` setting after user approval; no other config is changed automaticallyExport (Web / PNG / HTML / PDF)
canonical report→Web report, PNG (main report), printable HTML page, A4 PDF; `whale_report` tool returns markdown
04Who is it for? When not to use it?
Good for
- DSH users who want to see what their agent spent and did, per session and per period
- Teams reviewing agent spend and collaboration, or archiving period reports
Not for
- Cost is an estimate, not the provider invoice — computed from official peak/off-peak pricing and real effective dates; final numbers follow the DeepSeek Platform bill.
05Compatibility, maintenance and safety notes
- Cost is an estimate, not the provider invoice — computed from official peak/off-peak pricing and real effective dates; final numbers follow the DeepSeek Platform bill.
- Apply supports only `shell.timeoutMs`: a single, user-approved, revertible change. No arbitrary config / shell / code mutation, no auto-rollback, no self-healing.
- Read-only by default: never rewrites session history; secret scan records only pattern labels (no raw secrets); corrections store only category + count.
readme_verified
06Frequently asked questions
How do I install DeepTrace into DeepSeek Harness?
Run `dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"` then restart dsh web. It registers as a full-featured DSH plugin; the npm package alone only installs the engine, not the web UI or the `whale_report` tool.
What does DeepTrace measure?
It aggregates session event logs into cost (official peak/off-peak pricing, historically correct), tokens, tool calls, retry bursts, dangerous operations, a secret-pattern scan (presence only, no raw secrets) and session drilldown, across 6 report periods.
Is DeepTrace safe — does it change my data?
By default it is read-only and never rewrites session history. The only write it can make is a user-approved `shell.timeoutMs` adjustment; it does not auto-rollback and does no self-healing.
Are the cost numbers exact?
No — cost is an estimate from official peak/off-peak pricing and real effective dates, not your provider invoice. Final numbers follow the DeepSeek Platform bill.
How do I export a report?
Inside the panel you get a full Web report; you can also export the main report as PNG, a printable HTML page, or print the panel to PDF (A4). The `whale_report` tool can return a markdown report in chat.
07Related DSH workflows
weknora
by tencent
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
honcho
by plastic-labs
Memory library for building stateful agents
webnovel-writer
by lingfengqaq
A long-form Chinese web-novel writing assistant for Claude Code and DeepSeek Harness, designed to reduce memory loss and hallucinations in serialized projects of up to 2 million characters.
mirage
by strukto-ai
The World's First Virtual Terminal for AI Agents
08Data and sources
**① DSH 插件安装（推荐，完整功能）** —— 注册进 dsh web
dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-06. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.