跳到主内容

TokenLedger 使用指南

自动归类 DSH Web 端每次请求的中转站与项目归属，统计 token 用量、余额与订阅配额，无配置无需凭据。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

TokenLedger

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-tokenledger

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

    • kind: weekly # session / daily / weekly / monthly / billing
  • 请求发往匹配到的那条 provider 的 origin，origin: 字段只是用来找它的键。声明一个没配过的地址，不会产生任何请求。
  • path 必须是单斜杠开头的绝对路径。//host/x 是协议相对 URL，会解析到别的主机上；构造完还会再校验一次 origin。
  • 只发 GET，没有请求体，声明里的 method / headers 一概不生效。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后要不要重启 dsh web？

需要。安装或升级插件后必须重启已经在跑的 dsh web，再在浏览器里硬刷新一次；侧边栏底部才会出现"用量账本"入口。

需要我自己填中转站地址吗？

不需要。插件会从宿主的 provider 配置里读 baseURL 自动发现中转站，按 origin 归一化分组；只有在 DSH 没挂 settings 服务或 provider 是 agent preset 内联挂载这两种边缘情况下才需要手动配置 relays。

余额信息需要提供 API Key 吗？

不需要新填一把。余额接口直接复用你在该路由上已经配的 API key，仅 OpenRouter 例外——它的额度接口只认 Management Key，用推理 key 会 401，面板会直接说明要哪一把。

数据存在哪里？

SQLite 索引文件，默认在 DSH 主目录下（cordis.patch.yml 里写成 dshHomePath('tokenledger.sqlite')），可丢可重建；DSH 自己的会话日志由宿主管理，本插件只读不写。

支持哪些订阅配额服务？

内置支持 OpenCode Go、Kimi For Coding、MiniMax Coding Plan、智谱 GLM / Z.ai Coding Plan，每个显示独立的滚动窗口（5 小时 / 日 / 周 / 月）与重置时刻；不卖余额只卖配额的服务用窗口而非金额呈现。

"未知路由"那一行是什么意思？

表示这些请求走的路由在当前的 provider 配置里找不到了——可能改过名、删过，或当时跑在另一台机器上。数据没丢，把同名路由重新配回去会触发索引重建，历史流量自动归位。

能不能覆盖内置的余额读法？

不能。endpoints 里声明的自定义接口只在内置表答不上来时才生效，无法改变已知供应商的读数；声明也只能 GET，不能指定 method、headers、凭据或请求体。

怎么彻底卸载？

执行 dsh plugin --profile web remove dsh-tokenledger，重启 dsh web；侧边栏的用量账本入口随即消失，SQLite 文件可手动删除。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

TokenLedger 使用指南