DSH Marketplace

TokenLedger

zh667/TokenLedger

侧边栏用量面板:把 Token 归属到实际服务该请求的中转站,站点从已有的 provider 配置中读出,无需额外配置;含今日/本月/累计三窗口、按站点与模型下钻、一年活跃度热力图,以及 New API / Sub2API / DeepSeek 余额。

19918JavaScriptMIT源码

安装

把 TokenLedger 装进 DeepSeek Harness

装到哪

npm 方式

直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。

GitHub 方式 · npm 包

从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。

我们跑过之后

我们跑过,装得上

这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 昨天,DeepSeek Harness 0.2.2-rc.5.

挂进你的 README

实测可装 — dshmarketplace

给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。

安装前须知

装 TokenLedger 之前,先看这几条

  • 源码在这里: zh667/TokenLedger——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
  • 开源协议:MIT。

安全

装 TokenLedger 会执行什么

构建脚本

我们这次实装里没有构建脚本被拦。

来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.5,昨天。

安装钩子

package.json 里没有 preinstall / install / postinstall 脚本。

来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。

README 里提到

shell 命令(bash、exec、spawn 之类)

来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。

这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。

AI 锐评

是什么 — 在 DSH web 侧边栏按中转站和模型拆开 token 用量,并带上余额、订阅窗口和一年热力图。

谁该装 — 你在 DSH web 里跑 agent,官方 DeepSeek 与 New API / Sub2API 同一天轮着打,对账还得切到各站控制台才能看见请求落在哪、余量还够不够。 月结只认 DeepSeek 官方面板那一条总额的人,按 origin 拆站不是他们的对账方式。

注意 — 实测在全新 profile 里能装上并被 harness 注册。已经在跑的 dsh web 必须重启并硬刷新浏览器,钉版本必须写完整 40 位 commit SHA,短的会解析失败。OpenRouter 查额度只认 Management Key;安装过程会执行 shell 命令。

锐评 — 装。费用列在我没维护费率表之前会是破折号,那一列我不计入值不值。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。

TokenLedger 是做什么的

Provider records and session paths converge into a usage index, with separate arrows for balance queries.

TokenLedger 是一个 DeepSeek Harness 插件,用来统计 token 用量,并把每次请求归到实际提供服务的中转站,而不是只按路由别名归类。它从已有 provider 配置读取 baseURL,按 origin 合并同一站点的多把 key;会话启动目录则用于按项目归组。面板和命令行读取同一套聚合数据,提供今日、本月、累计用量,站点与模型下钻,缓存命中率、年度热力图、费用估算、余额和订阅窗口。数据索引保留会话、日期、站点、provider、模型等汇总字段,不读取提示词、工具参数或响应正文。

DeepSeek Harness 插件还会在 web profile 中增加 /tokenledger 命令,可导出数据、检查索引和重建索引。通常不需要额外配置或凭据;余额查询使用已有 provider 的 apiKeyEnv,OpenCode Go 还可回退读取 ~/.local/share/opencode/auth.json。自定义余额端点会向已配置 provider 的 origin 发起带密钥的 GET 请求,因此不适合不需要用量归因、不能使用 web profile,或不接受此类外部查询的环境。插件也会接触 DeepSeek Harness 的终端命令面,用于提供这些命令。

TokenLedger 的文档

TokenLedger 的环境要求

DeepSeek Harness 在 web profile 中加载 TokenLedger,要求 @deepseek-ai/dsh >= 0.1.0-rc.6。安装后需重启 dsh web 并刷新浏览器。插件读取 provider 配置中的 baseURL,聚合索引按会话、日期、站点、provider、模型保存用量汇总。

TokenLedger 的配置

通常无需配置。可在已有 settings.yaml 中使用:

配置项 作用
tokenledger.relays 自动发现不到时,补充路由名和中转地址。
tokenledger.rates 配置费用估算费率;默认是 [],未定价模型显示 —。
tokenledger.fingerprint 控制中转站指纹探测;默认是 false。
tokenledger.endpoints 为已配置 provider origin 声明备用余额接口。

自定义端点支持 origin、displayName、path、fields、windows 和 raw。path 必须是单斜杠开头的绝对路径;只发送 GET,不跟随跨源重定向,并有响应大小和超时限制。密钥仍从匹配 provider 的 apiKeyEnv 读取。

TokenLedger 的命令

DeepSeek Harness 提供 /tokenledger [days] [site],可按天数和站点查询;/tokenledger site 列出中转站,site add <route> <address> 与 site rm <route> 管理覆盖项。/tokenledger export csv 30 导出数据,也支持 export json;/tokenledger diagnostics 检查索引健康度和无法归因的记录;/tokenledger reindex 丢弃索引并重建。

已知限制与账户查询

内置查询支持 DeepSeek、New API、Sub2API、Moonshot/Kimi、GLM/Z.ai、OpenRouter、OpenCode Go、Kimi For Coding、MiniMax Coding Plan 和 Z.ai Coding Plan。OpenRouter 必须使用 Management Key;OpenCode Go 在没有 apiKeyEnv 时可读取 ~/.local/share/opencode/auth.json。

根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README

同一分类

TokenLedger 的同类插件

dsh-context

bowenliang123

3.1k

DSH 上下文洞察面板:Context 仪表盘 + /context命令 + Context 浏览器,查看 Context的分类组成、内容详情、演进趋势、压缩/注入事件、统计等一站式 Context 全生命周期管理。

我们跑过,装得上

npm 包TypeScript1 个月前

AI 锐评

dsh-context

是什么 — 给 DeepSeek Harness 加上下文看板:构成、趋势、压缩/注入事件、跨会话用量、agent 网络和 /context。

谁该装 — 在 DeepSeek Harness 上用 DeepSeek 跑多个 subagent 的长任务,工具输出把窗口堆满,却看不清 token 花在系统、工具还是对话上,也不知道哪次请求触发了压缩。把 DeepSeek Harness 只当执行层、用量已进自建监控的人不必装,侧栏面板插不进那条流水线。

注意 — 沙箱里在全新 profile 安装后,已被 harness 注册进 profile。费用按 models.dev 标价估算,DeepSeek 的高峰按 off-peak 标价 2 倍计,对不上账单。

锐评 — 装。多几个 tab 换不靠猜窗口被谁撑爆,这个交换我做。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
详情

dsh-cost-meter

Han-1413141

445

会话与当日 API 费用统计、预算图框(已用%)、官方余额、历史看板,支持峰谷计价与官方价格一键同步。

我们跑过,装得上

npm 包JavaScript1 个月前

AI 锐评

dsh-cost-meter

是什么 — 把会话级与每日 API 花费、预算占比、官方余额和历史看板接到 DeepSeek Harness 网页 GUI,并一键同步官方峰谷价。

谁该装 — 在 DeepSeek Harness 网页 GUI 里用官方 DeepSeek API 或 Anthropic / Kimi / MiniMax 这类 Coding Plan 赶代码,界面里却看不到本会话账单、官方余额和当前是否峰时计价。 主机仍停在 DSH 0.1.x 的不必装,它声明的下限是 0.2.0,这一档已经不再适配。

注意 — 实测在全新 profile 里能装上,并被 harness 注册进 profile。更新后必须整进程重启 DSH;启动时报 Ledger is busy,费用组件会缺席,要做账本锁恢复。DSH 0.2.1-rc.x 上 pnpm 的供应链策略可能让安装或卸载失败;它会执行 shell 命令。

锐评 — 官方按量和 Coding Plan 共跑同一套 DSH 时我会装,要的是订阅配额和现金花销分账,不是多一行会话金额。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1详情
276

在 DSH Web 界面追踪 DeepSeek Token 用量、单次与会话费用及账户余额,并显示缓存感知的扣费动画。

我们跑过,装得上

npm 包JavaScript26 天前

AI 锐评

dsh-damage-pulse

是什么 — dsh-damage-pulse 是 DeepSeek Harness 插件,记录 DeepSeek token 用量、单次和会话费用,并显示账户余额。

谁该装 — 在使用 DeepSeek Harness 时,使用 DeepSeek 模型进行对话的用户,需要了解 token 用量和账户余额的情况。 不使用 DeepSeek 模型的用户可以从不关注 token 消耗的角度考虑。

注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 插件会执行 shell 命令。 未发现明显的坑。

锐评 — 我会装它,因为它能提供 DeepSeek token 用量的持久记录。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1详情

dsh-usage-stats

Ychris12138

179

多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。

我们跑过,装得上

npm 包JavaScript1 个月前

AI 锐评

dsh-usage-stats

是什么 — dsh-usage-stats 为 DeepSeek Harness web GUI 提供多供应商账户监测与 Token 用量分析。

谁该装 — 使用 DeepSeek Harness web profile 进行多供应商 token 用量分析和账户余额监控时适合安装它。 如果用户仅需分析单一供应商的 token 用量而不需跨 provider 数据聚合,可以通过其他方式监控。

注意 — 需要提供 API key 或 token 来获取账户数据。沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。会执行 shell 命令。

锐评 — 如果需要跨多个供应商的 token 用量和余额分析,我会装它,因为它提供了估算费用和预算预警,但前提是愿意提供凭据。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
2详情

dsh-usage

Aisland-SJL

125

🌊 Persistent dock & fully-customizable balance/usage panel for DeepSeek Harness — activity heatmap, dual-channel comparison, local-only & privacy-first

我们跑过,装得上

GitHub 源码JavaScript1 个月前

AI 锐评

dsh-usage

是什么 — 插件提供持久 dock、token 使用面板和活动热图。

谁该装 — 在 DeepSeek Harness web profile 下进行 token 使用管理时,需要实时监控 token 余额和使用情况,并希望自定义界面布局,此插件适合你。 如果你仅需简单统计而不涉及跨渠道比较,则可跳过安装。

注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 插件仅在本地运行,凭证不被暴露。 没发现明显的坑。

锐评 — 我装它,因为它整合了多个 widget 到单一 persistent dock,但前提是 profile 版本匹配。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码
115

DeepSeek Harness 个人中心:跨会话用量统计(按供应商/模型分别统计,自动读取已配置模型)、按模型成本估算、全局自定义指令、数据驱动的桌面宠物(位图/矢量皮肤)与会话状态概览,纯本地离线运行。

我们跑过,装得上

npm 包JavaScript21 天前

AI 锐评

dsh-personal-center

是什么 — DeepSeek Harness 插件,在设置中新增个人配置分区,提供 Token 用量统计、个性化自定义指令和桌面宠物。

谁该装 — 如果你需要查看 DeepSeek Harness 中的 Token 用量和模型分布,那么这个插件适合你。 如果不使用 DeepSeek Harness 的工作区指令功能,那么无需安装此插件。

注意 — 沙箱实测通过,在全新 profile 里装上,并被 harness 注册进 profile。 没发现明显的坑。

锐评 — 我会装它,因为它支持模型成本估算和情绪驱动的桌面宠物,但前提是 token 用量需要实时跟踪。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
源码