前言¶
在 DeepSeek Harness（DSH）里跑智能体或编码助手时，会话会不断产生 token 消耗：输入、输出、缓存读写、工具调用与对话各占多少，往往只有账单或厂商控制台才能事后核对。若想在同一台开发机上按日、按模型、按工作区汇总，并顺带估算费用，通常得自己解析 session 日志或写脚本。
下面介绍社区插件 dsh-usage-ledger（维护者 cp990207）。它在 DSH 生态里归类为「记忆」类插件，定位是 local-first 用量账本：从本机会话日志挖掘数据，在本地仪表盘展示统计，并按可配置单价估算成本。数据不上传，HTTP 仅监听 loopback。
这是什么¶
dsh-usage-ledger 是 DeepSeek Harness 插件，当前版本 1.1.1（MIT 许可证）。一句话：在本机统计每日 / 每模型 / 每工作区的 token 消耗、缓存命中率、工具与对话占比，并给出估算开销。
安装后 bundle 会在头部注册 usage-ledger 入口，打开用量仪表盘；除可选的价格配置外，README 说明无需额外配置即可使用。
核心功能¶
以下能力均来自插件 README 与 package.json 描述，可在安装后对照界面验证。
时间与维度筛选¶
- 日维度总览：支持 今天 / 近 7 天 / 近 30 天 / 全部 范围。
- 按模型表格：请求数、未缓存输入、缓存读/写、输出、命中率、成本。
- 按工作区拆分：按
cwd合并会话；工具调用排行。 - 图表：token 与成本占比饼图、按日成本柱状图。
定价与成本估算¶
插件在读取会话事件时折叠成本，定价逻辑分四层：
- 内置目录：对已知模型（如 Kimi、GLM、MiniMax、DeepSeek coding-plan 等）附带 USD 标价，随插件更新与官方定价页对齐。
- 观测到的模型名：来自你的 session 日志，价格编辑器只列出你实际用过的模型。
- 用户覆盖：在头部 ⚙ Prices 中编辑的行会写入用户 profile 的 patch，优先于内置目录；未改动的行仍跟目录。
- 兜底：无单价的模型用
*行（默认 input $0.50 / output $2.00 每 1M tokens），界面会标记。
保存价格后会重算所有已存储成本，历史日期会按新单价立即重述。
配置结构为 { currency, prices }，currency 为展示用货币标签（默认 USD）。也可手改 profile 中的 cordis.patch.yml，例如在 usage-ledger 条目下：
- insert:
- id: usage-ledger
name: 'dsh-usage-ledger'
config:
currency: CNY
prices:
glm-5.3-flash: { input: 0.15, output: 0.5, cacheRead: 0.03, cacheWrite: 0 }
若宿主未挂载 configEditor 服务，⚙ 按钮会隐藏，仪表盘会说明如何改 patch；此时仍可读会话并展示仪表盘，成本按内置目录估算（只读）。
隐私与宿主要求¶
- 全部计算在本地完成；服务端只接受本机访问，并拒绝跨站请求。
- ⚙ Prices 需要宿主提供
configEditor（DSH 桌面版与 Web 版均支持）。1.1.1 起通过ctx.fiber.entry与ctx.get('configEditor')解析编辑器，避免在无编辑器时保存路由崩溃。
安装与启用¶
DSH 理念是「一切皆插件」；社区目录页在 SkillHub，与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
在 DSH 桌面应用中打开 插件市场 的安装框，粘贴官方仓库给出的标识：
github:cp990207/dsh-usage-ledger
若已在本地 checkout，同一安装框也可填写该目录的绝对路径。bundle patch 会注册头部账本入口，无需再写额外启用步骤。
安装前建议自行浏览 GitHub 源码 与 LICENSE；插件以当前 DSH 进程权限运行，会读取本机 session 日志。
典型用法¶
- 按上文完成安装，重启或刷新 DSH 后，在头部进入 usage-ledger 仪表盘。
- 先用默认时间范围查看「今天」或「近 7 天」的总 token 与估算成本。
- 打开 按模型 表，核对缓存命中率与 uncached / cache read / write 分布。
- 需要人民币等展示标签时，点 ⚙ Prices（若可见），设置
currency与各模型input/output/cacheRead/cacheWrite（每 1M tokens），保存后历史日成本会一并重算。 - 对比 工作区 与 工具调用 排行，定位哪条
cwd或哪类 tool 占用量最高。
以上步骤均可在纯本地完成，不依赖外网报表服务。
适用场景与注意¶
适合谁
- 长期在本机用 DSH 做编码或智能体开发、希望量化「哪模型、哪项目、哪工具」吃 token 的开发者。
- 需要在改单价或换模型后，快速看历史日成本如何变化的人（保存价格即全量重算）。
注意
- 估算成本依赖内置目录、你的覆盖价或
*兜底，与厂商真实账单可能不一致，仅作本地参考。 - 无
configEditor的宿主只能只读看板 + 内置目录价，改价需手编辑cordis.patch.yml。 - 星标与社区收录信息以目录页为准；功能与版本以 GitHub README 与 release 为准。
结尾¶
dsh-usage-ledger 把 DSH 本机会话日志变成可筛选的用量账本：日 / 模型 / 工作区维度、缓存与工具占比、可配置的估算成本，且默认本地计算、loopback 访问。若你在找「记忆」分类里偏运维向的用量可视化，可以从插件市场安装上述 GitHub 标识试用。
