Token 用量看板 skyzhao1223/dsh-agent-token-stats

dsh-agent-token-stats

面向 DeepSeek Harness(web profile)的跨 Agent 本地 LLM token 用量看板。跨 Agent 的本地 token 用量看板。

将来自 Claude Code、WPS Claude、OpenCode、DSH、OpenClaw、QClaw、CodeWhale、WorkBuddy、Cursor IDE 和 Hermes 的本地对话日志(以及待命中的 Codex CLI、Gemini CLI、Cline/Roo 和 Pi 解析器,外加对 Trae / Lingma / CodeGeeX / Comate / Ollama / AionUi / Copilot 的仅检测探针)聚合到持久化棘轮台账中,并在 DSH web GUI 侧边栏渲染完整分析面板。

聚合本机 10+ 个 AI 工具的对话日志到持久化台账(源日志删除后历史仍保留),在 DSH web 侧边栏提供完整分析面板。

安装

dsh plugin --profile web add github:skyzhao1223/dsh-agent-token-stats
then restart: dsh web

需要系统安装 sqlite3、jq 和 zstd(macOS:brew install zstd)。宿主:DSH >= 0.1.5-rc。

功能

- 指标:输入 / 输出 / 推理 / 缓存读取 / 缓存写入拆分、缓存命中率、请求次数、上报成本 vs. 估算成本(内置参考价目表,绝不混用)
- 视图:带环比变化的概览卡片、供应商与提示词构成环形图(悬停 + 点击筛选)、堆叠趋势图(悬停提示 + 点击下钻到某天)、活动热力图(点击下钻)、模型明细表(排序 / 搜索 / 展开每日迷你折线图 / 合计页脚)、时段对比、Agent 对比、会话浏览器、带 schema 漂移哨兵的来源状态
- 持久化:~/.agent-token-stats/ledger.json —— 按来源 × 模型 × 日期进行棘轮式合并;重新扫描绝不重复计数;源日志删除后历史仍保留
- 报告:每周 / 每月 Markdown 下载;CSV 导出
- 吸顶工具栏:来源标签、时间范围、供应商选择、模型搜索、带一键清除的活动筛选摘要
- 国际化:中文 / English 切换
- 自动刷新每 2 分钟一次;客户端缓存即时打开

配置(全部可选,全部位于 ~/.agent-token-stats/)

| 文件 | 用途 |
| config.json | {"budgets":{"dailyTokens":0,"monthlyTokens":0,"dailyCost":0,"monthlyCost":0}} —— 预算告警阈值 |
| pricing.json | {"rules":[{"pat":"model-substr","i":3,"o":15,"cr":0.3,"cw":3.75}]} —— 每 100 万 token 的美元价格,覆盖内置价格 |
| quota.json | {"deepseek":{"apiKey":"sk-..."},"kimi":{"apiKey":"..."}} —— 余额查询(环境变量 DEEPSEEK_API_KEY / MOONSHOT_API_KEY 也可用) |
| export-*.csv | CSV 导出文件存放于此 |

架构

一个 bundle 行,两半:
- 宿主(lib/index.js,注入 shell + webServer):基于签名的增量扫描器、台账、定价,以及路由 GET /agent-token-stats/{data,export,sessions,report,quota}(回环地址,带 Origin 校验)
- 客户端(lib/client.js,dsh.client web bundle):侧边栏面板 + 主插槽仪表盘,纯 React.createElement,编辑无需构建步骤

开发

node --check lib/index.js && node --check lib/client.js
node scripts/smoke.mjs
维护：编辑源文件 → dsh plugin --profile web update dsh-agent-token-stats → 重启 dsh web。

MIT © skyzhao1223