apodemakeles/dsh-token-dashboard

Name: apodemakeles/dsh-token-dashboard
Author: apodemakeles

插件Plugin 原生Native ⭐ 2 MIT cat_label.dashboardcat_label.dashboard cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh cat_label.heatmapcat_label.heatmap cat_label.token-dashboardcat_label.token-dashboard cat_label.token-usagecat_label.token-usage

DeepSeek Harness（DSH）插件：本地每日/每周令牌使用量仪表板与热力图

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

这是 DSH 网页 GUI 插件，提供类 GitHub 贡献图的 Token 消耗热力图。常驻 Worker 监听会话事件并把用量增量原子写入本地 SQLite，面板仅读取快照，展示本机所有项目的每日/每周总 Token。适合需要快速查看用量趋势时使用。注意：投影仅限本机会话，缓存读取计入总量，且依赖 Node 24 实验性 node:sqlite。

A DSH web GUI plugin that adds a Token sidebar panel with a GitHub-style token-usage heatmap. A persistent Worker listens to session events, durably projects minimal usage deltas into local SQLite, and serves one snapshot endpoint; the panel renders daily and weekly totals without scanning logs. Use it to review local token-consumption trends. Caveat: data is machine-local, cache reads count in totals, and it relies on Node 24's experimental node:sqlite.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-token-dashboard】【https://github.com/apodemakeles/dsh-token-dashboard】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:apodemakeles/dsh-token-dashboard

把 apodemakeles/dsh-token-dashboard 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.0 KB · 缓存于 2026-08-27 05:41:41 · 3.0 KB

@apodemakeles/dsh-token-dashboard

English | 中文

A DeepSeek Harness (DSH) web GUI plugin: a token-consumption heatmap panel. It shows your total token usage per day / per week across all projects on this machine, GitHub-contributions style. Usage facts are projected into a local SQLite database by a persistent Worker, so opening the panel never scans session logs.

Status: released v0.2.0 — GitHub distribution is live. The package is not currently published to npm.

Screenshots

Weekly heatmap

Weekly token-usage heatmap

Daily view

Daily token-usage bar chart

What it does

Host half — listens to live session/event, flushes through DSH's durability barrier, and sends minimal usage deltas to a persistent Worker. The Worker owns SQLite (node:sqlite), commits facts/checkpoints atomically, and serves one consistent snapshot endpoint.
Client half — registers a Token entry in the sidebar and opens a dedicated panel rendering the heatmap (weekly grid + daily view). It fetches a single GET /api/token-dashboard/snapshot per open/refresh/page change.
CLI — dsh-token-dashboard status|verify|rebuild|backups|restore|cleanup for local maintenance.

Installation

From GitHub:

dsh plugin --profile web add github:apodemakeles/dsh-token-dashboard

Then restart dsh web. Open any project session and click the Token entry in the sidebar.

The npm package is not currently published; use the GitHub installation above.

Data and operations

Projection database: $DSH_HOME/data/token-dashboard/usage-v1.sqlite (default ~/.dsh).
Total tokens = inputTokens + outputTokens + cacheReadTokens (cache reads count into the headline).
The panel only calls the snapshot route; it does not trigger listSnapshots, inspect, readFrom, flush, or backfill.
First startup initializes the database in the background; the panel shows phase/progress until ready.

Development

git clone https://github.com/apodemakeles/dsh-token-dashboard.git
cd dsh-token-dashboard
pnpm install && pnpm build
dsh plugin --profile web add link:$(pwd)

See .scratch/dsh-token-dashboard/map.md for the project map (planning tracker), docs/durable-usage-architecture.md for the architecture contract, and docs/dev-loop.md for the full dev loop.

Known limitations

Projection is machine-local: it reads sessions stored on this machine (~/.dsh/sessions is the authority; SQLite is a rebuildable projection).
Host/Worker changes require restarting DSH; client HMR does not cover the persistent Worker.
SQLite is experimental in Node 24 (node:sqlite); the plugin checks capability at startup and does not hide the warning globally.

License

MIT

渲染基于仓库 apodemakeles/dsh-token-dashboard 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install