Repository navigation
dsh-usage-stat v1.0.0
首个公开版本。
它是什么
DeepSeek Harness(DSH)的用量统计插件。它把每一次模型调用的 token 用量记成一份本机账本,再把同一份数据放在三个地方显示:侧边栏左下角的用量卡、输入框下方那枚「本次对话」胶囊、设置里的「用量统计」页。除此之外它还会查询各供应商的账户余额与编程套餐剩余额度,余量偏低时在侧边栏对应供应商前点一个红点。
数据只有两个来源:DSH 自己的会话事件(用量)和供应商自己的接口(余额与套餐)。余额与套餐不做任何本地估算 —— 查不到就写明原因,不猜一个数字出来。
这一版有什么
- 侧边栏用量卡:折叠时一行「今日用量 + 总量」,点开是各供应商与模型的占比条;有提醒的供应商不会被排名上限藏起来
- 本次对话胶囊:输入框下方显示这段对话自己的 token 总数,点开是它的分供应商、分模型明细
- 用量统计页:时间范围(今天 / 近 7 天 / 近 30 天 / 全部 / 自定义)驱动页面上所有卡片;含每日用量柱状图,峰值标在卡片头部
- 账户页:余额与套餐(5 小时 / 本周 / 本月)合并显示,查不到的供应商折叠在最下面并写明原因
- 余量提醒:余额、5 小时、本周、本月四项阈值可自设,填 0 表示该项不提醒
- 历史补录:首次启动会回放本机已有的会话日志,把插件装上之前的用量补进账本
- 只在本机:账本与配置放在
$DSH_HOME/usage-stat/,API Key 不出宿主进程
安装
dsh plugin --profile desktop add git+https://github.com/SereneJi/dsh-usage-stat.git装完重启 dsh(宿主那一半改动需要重启才生效)。另一种从源码 link: 安装的方式见 README。
校验
npm test—— 170 个单元测试通过npm run check-tokens—— 客户端只用 shell 的--dsw-*语义 token,对着正在运行的 shell 校验npm run verify-served—— 宿主服务的客户端文件与源码逐字节一致
界面截图是用插件自己的组件渲染的(npm run preview),不是应用截图。