dsh-token-data
dsh Web GUI 的令牌使用情况仪表板、提供商余额和订阅配额
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dawsondx/dsh-token-data#552b1601ff24fb6b3ab6ceaedbc6acd591112bc4Token Data 以 dsh-token-data 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 · English
dsh-token-data：面向 DeepSeek Harness Web 图形界面的 Token 用量仪表盘——每日用量热力图、供应商余额与订阅配额，尽在一个浮动面板
dsh-token-data 是 DeepSeek Harness（DSH）的插件，把实时 Token 用量仪表盘带进 dsh web 图形界面。点击侧边栏底部的徽章即可打开浮动面板，查看每日 Token 消耗、各供应商余额与订阅配额窗口——不必在多个供应商后台之间来回切换，也无需手工记账。
| 你想知道什么 | 面板会告诉你 |
|---|---|
| 今天 / 这个月烧了多少 Token？ | Hero 汇总卡片 + Codex 风格每日热力图 |
| Token 都花到哪去了？ | 按日、按模型的明细 + 7 日堆叠趋势图 |
| DeepSeek 余额是不是快用完了？ | 供应商余额（DeepSeek、OpenRouter、Moonshot/Kimi、Z.ai 等） |
| 订阅窗口还剩多少？ | OpenCode Go、Z.ai、Kimi、MiniMax 的配额窗口 |
| 提示词缓存真的有用吗？ | 每日缓存命中率，就在总数旁边 |
sessionPersistence 的分页日志读取（list / open / read），不再依赖已废弃的同步 Session 事件读取；供应商连接信息改由 settings.describe() 的实时配置投影取得；前端不再 import 任何 Harness 客户端包（图标自绘），因此不会因为 primitives 图标集改名而渲染崩溃。__ModuleLoader__ 模块（无打包器、使用者无需 npm install）；服务端是纯 ESM。clone、添加、重启即可。GET 端点，位于 peer-socket 回环防护之后；绝不会写入你的会话。<DSH_HOME>/storages/usage-stats-cache.json），按日志产物的稳定标识（大小 + 事件数）判重；无论日志多大，稳态成本始终是 O(新增事件)（实测本地 121 个会话约 0.2 秒）。| 供应商 | 余额 | 订阅 / 配额 |
|---|---|---|
| DeepSeek | GET /user/balance（CNY） | - |
| OpenRouter | GET /api/v1/credits（需 Management Key） | - |
| Moonshot / Kimi | GET /v1/users/me/balance | Kimi coding 用量 |
| Z.ai（GLM） | GET /api/paas/v4/balance | Coding Plan 配额窗口 |
| OpenCode Go | - | 未公开的用量端点 + 工作区面板兜底 |
| MiniMax | - | Token 套餐余量（global / CN） |
| 其他 | 通用 new-api / sub2api / general 适配器，以及声明式 JSON Pointer 配置 |
没有公开余额 API 的供应商会明确显示无公开余额接口状态，而不是猜测一个数字。
前置条件： 可正常运行的 DSH（dsh web 能启动）、Node.js ≥ 20。
dsh plugin --profile web add dsh-token-data
git clone https://github.com/dawsondx/dsh-token-data.git
cd dsh-token-data
dsh plugin --profile web add \
--ignore-scripts --config.auto-install-peers=false \
.
dsh plugin --profile web add \
--ignore-scripts --config.auto-install-peers=false \
github:dawsondx/dsh-token-data
dsh plugin --profile web add link:C:/path/to/dsh-token-data
安装完成后重启 dsh web。面板从侧边栏底部徽章打开；用 profile 的 cordis.patch.yml 配置监视器（示例见下）。
本插件是一个 DSH profile bundle（dsh.bundle.patch），内部插件 id 为 usage-stats。在 web profile 的 cordis.patch.yml 中挂载监视器并配置各供应商选项：
- id: usage-stats
config:
monitors:
deepseek-official:
adapter: deepseek-balance
allowPrivateNetwork: true # 放行本地代理（TUN/fake-ip）解析
minimax-cn:
adapter: minimax-token-plan
region: cn # MiniMax 中国区账号
flowchart LR
S[会话事件日志] --> F[增量折叠<br/>按日 / 按模型]
F --> C[(usage-stats 缓存<br/>DSH_HOME/storages)]
C --> E[5 个只读回环端点]
E --> P[网页面板<br/>热力图 · 余额 · 配额]
K[凭据缝隙] -. 请求时解析 Key .-> E
服务端在 /api 下注册了 5 条精确路由，优先于连接插件的 /api 前缀处理器。聚合以 sessionPersistence 为准：list() 给出每个已存会话的日志产物，open(id, "read") + read(offset) 增量取回新事件；产物未变化（大小 + 事件数相同）的会话整轮跳过，因此稳态成本与历史日志总量无关。
折叠规则与 Harness 自身的 token-meter 投影一致：用量取自 assistant/message 的 data.usage，缺失时退回该事件 stream 里最后一个 usage chunk；assistant/attempt（失败 / 重试的尝试）同样计入。同一 (turn, step) 重复上报时替换而非累加，llm/retry-started 会清空该槽位，使重试后的新尝试正常累加。fork 出的会话只统计自身事件（inheritedEventCount 之后），所以祖先会话的用量不会被重复计算。无法打开的旧格式日志会被记住并排除在总量之外，只汇总为一条警告，不会反复拖慢每次刷新。
| 端点 | 用途 |
|---|---|
GET /api/usage-stats/usage | 所有会话的按日 Token 用量 |
GET /api/usage-stats/providers | 已配置的供应商 + 余额方案 |
GET /api/usage-stats/balance?provider=<id> | 单个供应商的余额 |
GET /api/usage-stats/subscriptions | OpenCode Go + Z.ai 配额窗口 |
GET /api/usage-stats/account | 单个供应商的统一账户快照 |
GET；不会写入你的会话或日志。Host 头）；Host 头只是二次校验。authorization、cookie、api-key 等）。npm run check # 对每个 lib 文件执行 node --check
npm test # 折叠语义（替换 / 重试 / 模型归属）的纯函数断言
lib/usage.js 与 lib/balance.js 是纯模块（无 cordis 依赖）——折叠与余额解析可以在 DSH 之外对真实日志做单元测试与验证。浏览器端没有任何构建步骤：改完 lib/client.js 直接刷新页面即可（Harness 的 client-hmr 会按文件变更重新提供 bundle）；服务端 lib/index.js 属于 Node 模块图，改动后需要重启 dsh web。
usage-stats 与 API 路由保持不变以兼容既有配置，包名与前端 bundle 为全新实现。formatTokensShort 本地化数字格式逻辑（zh/ja 用 亿/万，en 用 K/M/B）。MIT © dawsondx