用量账本 cp990207/dsh-usage-ledger

Usage Ledger（用量账本）

本地优先的用量账本，面向 DeepSeek Harness：挖掘本机会话日志，统计每日 / 每模型 / 每工作区的 token 消耗、缓存命中率、工具请求与聊天请求的占比，并估算开销。

本地用量账本插件：从本机会话日志统计每日 / 每模型 / 每工作区的 token 消耗、缓存命中率、工具请求占比，并按配置单价估算开销。

安装

把它当作 DeepSeek Harness 插件，从本仓库安装 —— 在桌面应用里打开插件市场（插件市场）的安装输入框，粘贴：

github:cp990207/dsh-usage-ledger

或者用本地克隆，把同一个输入框指向检出目录的绝对路径。bundle 补丁会注册 usage-ledger 条目，并在页头挂上账本面板；无需额外配置。

功能

- 每日 token 与开销总览，支持今天 / 7 天 / 30 天 / 全部时间范围筛选
- 每模型表格：请求数、未命中缓存的输入、缓存读/写、输出、命中率、开销
- 占比饼图（token 与开销）、每日开销柱状图
- 工作区拆分（按 cwd 合并会话）与工具调用排行
- 价格配置：页头的 ⚙ Prices 按钮打开每模型价格编辑器（输入 / 输出 / 缓存读 / 缓存写，按每 1M token 计）

计价方式

1. 内置价目表 —— 插件自带已知模型的美元标价（Kimi、GLM、MiniMax、DeepSeek coding-plan 系列模型，已对照官方定价页核对）。价目表价格随插件更新。
2. 观测到的模型 —— 模型名来自你自己的会话日志，所以编辑器列出的永远是你实际用过的模型。
3. 自定义覆盖 —— 在 ⚙ 对话框里改过的行会写进你的用户配置档补丁（走宿主的配置编辑器），优先级高于内置价目表。没改过的行继续跟随价目表。
4. 兜底 —— 没有任何价格的模型按 * 兜底行估算（默认每 1M token 输入 $0.50 / 输出 $2.00），并在界面上标记出来。

保存后会重算所有已存开销（账本在读取时折叠事件），所以历史日期立刻按新价格重述。

配置

插件配置是 { currency: string, prices: Record<string, {input, output, cacheRead, cacheWrite}> }。优先用 ⚙ 对话框；手改配置档 cordis.patch.yml 里的 usage-ledger 行也可以：

- insert:
- id: usage-ledger
name: 'dsh-usage-ledger'
config:
currency: CNY # display currency label (USD default)
prices:
glm-5.3-flash: { input: 0.15, output: 0.5, cacheRead: 0.03, cacheWrite: 0 }

如果宿主环境没有配置编辑器，⚙ 按钮会隐藏，面板上会说明怎么改补丁。

隐私

所有数据都在本地从会话日志算出。HTTP 端点只监听回环接口，并拒绝跨站请求。

宿主要求

⚙ Prices 编辑器需要宿主挂载 configEditor 服务（DeepSeek Harness 桌面端和 Web 端都支持）。在没有它的主机上，插件仍会折叠会话日志并提供仪表盘——只读，价格取自内置目录。

更新日志

- 1.1.1 —— 通过 ctx.fiber.entry 和 ctx.get('configEditor') 解析主机配置编辑器，不再使用注入的服务访问方式。这样只要主机提供价格编辑器，就会显示出来（主机不提供时，保存路由也不会崩溃）。配置 schema 只返回用户自己的行，因此解析后的配置不再把内置目录折叠进配置档补丁。入口查找接受任何以 usage-ledger 结尾的包名。

许可证

MIT © 2026 白白酱 (cp990207)