前言¶
在使用 DeepSeek Harness (DSH) 进行本地模型推理时，记录每日用量、统计成本以及保持打卡习惯是常见需求。dsh-daily-ledger 插件解决了这个问题。它是一个本地工具，不联网，不上传数据，安装启用后自动监听 DSH 已提交的模型用量事件，进行本地记账。
插件简介¶
dsh-daily-ledger 是 DeepSeek Harness (DSH) 的本地每日打卡与 token/金额账本。插件由 jijiz1 维护，采用 MIT 许可证。
核心功能¶
- 每日打卡：支持在聊天中打卡，可附 500 字以内备注。同日重复调用只会更新备注。
- Token 与成本统计：支持按 1-366 天统计，可按 provider/model 拆分查看。
- 用量状态查看：快速查看今日打卡状态、连续天数和今日用量。
- Web 漂浮窗：右下角显示悬浮窗，可展开/收起和拖拽。包含“今日”、“统计”、“背景”三页。
- Token 分类统计：支持未缓存输入、缓存读取、缓存写入、输出、推理（推理已包含在输出中，不重复计费）的细项统计。
- 价格快照：每次模型调用保存当时的价格快照。没有价格的模型显示“未定价”，绝不按 0 元处理。
安装与启用¶
使用官方提供的安装命令添加插件路径：
dsh plugin --profile web add D:\DSH\dsh-daily-ledger
安装完成后，重启 dsh web 进程即可启用。
典型用法¶
在聊天中发送以下指令即可使用：
- 今日打卡：在聊天中说“今日打卡”。
- 统计用量：在聊天中说“统计最近 7 天 token 和金额”。
- 模型消费：在聊天中说“按模型看本月消费”。
配置与数据¶
首次启动后，数据默认位于以下位置：
$DSH_HOME/daily-ledger/ledger.json：打卡和用量账本。$DSH_HOME/daily-ledger/pricing.json：价格表。
时区设置¶
默认时区为 Asia/Shanghai。可通过环境变量 DSH_DAILY_LEDGER_TIME_ZONE 修改。
价格配置¶
默认价格来自 DeepSeek 官方中英文价格页（单位：每百万 token）。
其他 provider/model 可直接在 pricing.json 中添加。键必须写成 provider/model 格式（例如 openrouter/deepseek/deepseek-v4-pro）。重启后，新调用会保存新价格快照。
Web 漂浮窗¶
漂浮窗右下角显示，支持以下操作：
- 页面切换：包含“今日”、“统计”、“背景”三页。
- 拖拽：展开时拖动标题栏，折叠时拖动胶囊按钮均可改变位置。
- 背景设置：
- 预设：深海、紫霞、森林、日落。
- 自定义：支持自定义纯色、图片网址或 2 MB 以内的本地图片。本地图片只转成浏览器本地数据，不会上传外网。
- 遮罩：可调整内容遮罩强度。
- 记忆：窗口位置、展开状态和背景设置保存在浏览器本地；无数据变化时定时刷新不会重建窗口。
注意事项¶
- 数据统计范围：自动统计从插件启用后的模型调用开始，不导入历史日志，不会猜测或重复导入此前的压缩会话日志。
- 金额估算：金额为基于 Token 和配置价格的估算，服务商账单、税费、汇率或时段价可能造成差异，以最终账单为准。
结语¶
dsh-daily-ledger 为 DSH 用户提供了本地化的成本追踪与习惯管理能力。如需查看更多细节或获取源码，请访问 GitHub 仓库。
