dsh-daily-ledger

DSH Daily Ledger

面向 DeepSeek Harness 的本地每日打卡与 token/金额账本。插件不联网、不上传数据，安装启用后自动监听 DSH 已提交的模型用量事件。

功能

• daily_check_in：每日打卡，可附 500 字以内备注；同日重复调用只更新备注。
• daily_token_cost_report：按指定日期或最近 1–366 天统计，并按 provider/model 拆分。
• daily_ledger_status：快速查看今日打卡、连续天数和今日用量。
• Web 漂浮窗：右下角显示，可展开/收起和拖拽；包含“今日、统计、背景”三页。
• token 分为未缓存输入、缓存读取、缓存写入、输出、推理；推理 token 已包含在输出中，不重复计费。
• 每次模型调用保存当时的价格快照。没有价格的模型显示“未定价”，绝不按 0 元处理。

安装

dsh plugin --profile web add D:\DSH\dsh-daily-ledger

随后重启 dsh web。在聊天中说“今日打卡”“统计最近 7 天 token 和金额”“按模型看本月消费”即可。

漂浮窗

• 今日：当天金额、token 分类、连续打卡、备注和打卡按钮。
• 统计：1/7/30/90 天范围、CNY/USD 切换、每日趋势和按模型明细。
• 背景：深海/紫霞/森林/日落预设，自定义纯色、图片网址或 2 MB 以内的本地图片，并可调整内容遮罩强度。本地图片只转成浏览器本地数据，不会上传外网。
• 展开时拖动标题栏、折叠时拖动胶囊按钮均可改变位置；窗口会在浏览器缩放后自动回到可见区域。
• 窗口位置、展开状态和背景设置保存在浏览器本地；无数据变化时定时刷新不会重建窗口。

数据与价格

首次启动后数据位于：

• $DSH_HOME/daily-ledger/ledger.json：打卡和用量账本
• $DSH_HOME/daily-ledger/pricing.json：价格表

默认时区为 Asia/Shanghai，可用环境变量 DSH_DAILY_LEDGER_TIME_ZONE 修改。

默认价格来自 DeepSeek 官方中英文价格页，单位均为每百万 token：

• CNY：https://api-docs.deepseek.com/zh-cn/quick_start/pricing/
• USD：https://api-docs.deepseek.com/quick_start/pricing

其他 provider/model 可直接加入 pricing.json。键必须写成 provider/model，例如 openrouter/deepseek/deepseek-v4-pro；重启后新调用会保存新价格快照。

限制

• 自动统计从插件启用后的模型调用开始；不会猜测或重复导入此前的压缩会话日志。
• 金额是基于模型返回 token 和配置价格的估算。服务商账单、税费、汇率或时段价可能造成差异，应以最终账单为准。