前言¶
在 DeepSeek Harness（DSH）里跑多 provider、多模型时，会话里会陆续产生 input、output、cache、reasoning 等用量记录，但分散在各次 session 里，很难一眼看到总量、按模型拆分，或对照单价做粗略成本估算。社区插件 harness-ledger（维护者 yuyuanjingxuan）从 Harness 已有 session 数据读取 usage，在可拖拽的浏览器面板里展示汇总、日历热力图和单次请求明细；它不发起模型调用，缓存写在 dsh 用户数据目录。下面介绍其定位、能力与安装方式。
这是什么¶
harness-ledger 是面向 DSH 的 Token 用量与费用台账 插件：读取 Harness 已写入 session 的 usage，展示账户级合计、按 provider / model 分组、当月活动日历、session 与近期 request 明细，并支持按百万 token 配置单价做估算。npm 包名 harness-ledger，当前资料中版本为 0.1.1，许可证 MIT，亦发布于 npm。
核心功能¶
资料中明确列出的能力如下。
用量统计
- 账户合计：input、output、cache read、cache write、reasoning 与 total tokens。
- 按 provider 或 model 分组；model 视图会把不同 provider 下同名 model 合并展示，展开后可看各 provider 拆分。
- 当月活动日历：选中某一天可列出该日有 token 记录的 session（含较早 session）。
- Session 合计与近期 request：含时间、provider、model 与各 token 计数。
面板行为
- 每 10 秒 刷新一次。
- 最多展示用量最高的 30 个 session；展开某 session 时最多 12 条近期 request。
费用估算
- 对每个 Harness 发现的 provider / model，默认单价为 0，不配价格也能正常使用面板。
- 面板头
¥按钮可编辑 input / output 单价（百万 token 计价）。 - 模式二选一：By provider 或 By model；仅当前选中模式参与估算。model 费率按 provider + model 区分。
- 费率表保存在浏览器 localStorage；provider 模式下，本地 provider 费率优先于 profile 里配置的费率。
界面
- 主题：Auto、Midnight、Paper、Matrix。
- 面板文案支持中文与英文。
数据与缓存
- 通过 Harness 服务读 session 历史；缓存为折叠后的 session 元数据与用量合计，不含完整消息正文。缓存命中时先返回合计，后台再刷新 session 历史。
- 默认缓存目录：
~/.dsh/storages/harness-ledger（与其它 dsh storage 并列，重装或升级插件后仍保留）。可通过DSH_HOME改 dsh 根目录，或在启动 Harness 前设置HARNESS_LEDGER_CACHE指向专用目录；旧环境变量名DSH_LEDGER_CACHE仍支持。
安装与启用¶
插件为标准 dsh plugin bundle，走常规插件流程，出现在已安装插件列表中并自带启用开关；不需要在用户的 cordis.patch.yml 里手动添加入口。
插件管理页¶
打开 Plugins 页面，用仓库地址安装，然后重启 Harness：
https://github.com/yuyuanjingxuan/harness-ledger
命令行¶
将 desktop 换成你的 profile 名称，安装完成后重启 Harness：
dsh plugin --profile desktop add https://github.com/yuyuanjingxuan/harness-ledger
典型用法：配置 profile 侧单价¶
若希望在多浏览器间共享费率或由 profile 集中管理，可在 ledger 插件配置里写 pricing（provider 键须与 Harness 报告的 ID 一致）。inputPerM、outputPerM 分别表示每百万 未缓存 input token 与 output token 的价格；0 表示免费。
- id: ledger
config:
pricing:
GWDG_CHAT_AI:
inputPerM: 2.0
outputPerM: 6.0
面板里仍可用 ¥ 在浏览器本地改价；provider 模式下本地表会覆盖 profile 中同 provider 的费率。
适用场景与注意¶
适合谁
- 长期在 DSH 里切换 provider / model，需要看总量、按模型对比用量，或结合自填单价做粗算成本的开发者。
使用注意
- 插件以 当前 dsh 进程权限 运行，并读取 session 与本地缓存；安装前建议自行查看 GitHub 源码 与 MIT 许可证。
- 费用仅为基于你配置单价的 估算，不等同于账单；未填价时默认 0。
- SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；插件信息以仓库 README 为准。
结尾¶
harness-ledger 把 Harness 已记录的 token usage 收敛到一块可拖拽面板：合计、分组、月历、session / request 明细，再配合百万 token 单价做估算，且不发模型请求。目录页：https://www.skillhub.cn/plugins/yuyuanjingxuan/harness-ledger；源码与安装说明：https://github.com/yuyuanjingxuan/harness-ledger。
