TokenLedger

项目详情摘要

TokenLedger 把 DeepSeek Harness 的 Token 用量算清楚，并归属到**实际服务这次请求的中转站**——不用配置，不用凭据。 Token-usage accounting for DeepSeek Harness, attributed to the relay site that served each request. The existing Web GUI (`dsh web`) and renderer-neutral consumers share the same host-owned aggregation. Zero configuration. 展示图使用演示数据与本机模拟中转站；面板上的每个数字都由真实代码路径算出，只是数据是造的。插件不会把 API Key 或上游原始响应发送到浏览器。 一眼看懂 / At a glance | 能力 | 说明 | --- | --- | --- | 🎯 | **中转站归属** | 按 provider 的 `baseURL` 归一化 origin 分组——同一站的多把 key 合成一行，站名就是域名，不是你自己起的路由别名 | 📁 | **按项目归属** | 用量按会话启动时所在的目录分组——工作区注册过的用它的标题，没注册过的用目录名，子目录里起的会话照样算进去 | 🔍 | **零配置发现** | 从宿主的 provider 配置里读出中转站，不用你再填一遍。只读 `baseURL`，绝不碰旁边的凭据 | 💳 | **余额** | DeepSeek 官方、New API、Sub2API，每个账户一把普通 key 即可；不限额度的 key 报"已用"而不是假余额 | ⏳ | **订阅配额** | 卖套餐不卖余额的家数越来越多——5 小时 / 每周 / 每月各自滚动、各自重置，每个窗口一条进度条和一个重置时刻 | 📊 | **用量分析** | 今日/本月/累计三窗口、按站点/模型下钻、缓存命中率、一年活跃度热力图（悬停看当天模型构成） | 🧮 | **费用估算** | 生效日期分段的费率表、分桶计价、峰谷时段；未定价的模型显示破折号而不是 0 | 🗂 | **导出与诊断** | CSV / JSON 导出，索引健康度，归因不上的行数单独列出 | 🔒 | **只读回环** | 两个端点仅接受回环 GET，且在 peer socket 地址上设防；从不读取提示词、工具参数或响应内容 | 快速安装 / Quick start 需要 DeepSeek Harness `web` profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。 重启已经在跑的 `dsh web`，浏览器硬刷新。侧边栏底部会出现「用量账本」入口。 升级或卸载： 重装同一个 spec 会重新解析，所以 `add` 一遍就能拿到最新的 `main`（实测过，不是推测）。 要钉某个版本，必须用完整的 40 位 commit SHA。** 包管理器把 ref 拿去和 `git ls-remote` 广播的引用列表比对，而那份列表里只有完整 SHA 和分支/标签名——**短 SHA 匹配不到任何东西，会直接报 `Could not resolve`**： spec | | --- | --- | `github:zh667/TokenLedger` | ✅ | `github:zh667/TokenLedger#main` | ✅ | `github:zh667/TokenLedger#947247a` | ❌ 短 SHA 解析不了 | `github:zh667/TokenLedger#947247a86f0835f0e746695538569b1a76356dd1` | ✅ | 如果 `package.json` 里已经被写进了一个解析不了的 spec，`add` 也会失败——它会先解析整份清单。改掉那一行再 `install` 即可。 装完之后 `/tokenledger diagnostics` 会打印当前的路由归属和索引里的路由——**排查「我的中转站为什么不显示」看这里**，不用猜。 装完即可用：没有要填的配置，也不需要任何凭据就能看到全部用量与中转站分布