前言¶
在 DSH 里混用 DeepSeek、本地模型和其他厂商 API 时，会话能正常进行，但「花了多少 token、账户里还剩多少钱」往往要另开控制台或翻日志。DeepSeek Harness 的插件生态支持把这类能力挂进客户端界面。下面介绍社区插件 dsh-tok-qty：在对话输入框右下角状态栏显示总余额，并基于本机会话日志统计今日、本周、本月的用量，同时区分 DeepSeek 与其他 provider 的占比。
这是什么¶
dsh-tok-qty 由维护者 loiter1EM 发布，在 SkillHub 插件目录 中归类为 admin-security。当前 package.json 版本为 1.1.0，许可证 MIT，面向 web 客户端（dsh.client.platform: web）。
一句话定位：在 composer 状态栏展示 DeepSeek 账户余额，并从本地 assistant/message 事件聚合 token 统计；余额可走官方 GET /user/balance，统计范围覆盖 DSH 会话里记录的调用，也能把非 DeepSeek 模型按厂商分组展示。
核心功能¶
状态栏与面板¶
输入框右下角状态行会出现钱包图标和总余额（例如 总余额 ¥31.99）。点击后展开面板：
- 今日 / 本周 / 本月 切换，顶部总量随当前标签变化（面板顶部的总量仅统计 DeepSeek 调用）。
- 分时段面积图：今天按 24 小时分桶，本周按 7 天，本月按当月每天；悬停显示竖线、圆点与该时段数值。
- 横向柱状图：同一时间段内，本地模型与 Anthropic、OpenAI、OpenRouter 等厂商各用多少，便于对比 DeepSeek 占比。
- 明细行：缓存读取、未缓存输入、输出、缓存命中率。
- 右上角刷新即时重算；旁侧齿轮进入设置（面积图峰谷配色、柱状图分组配色、五类字段显隐，底部「恢复默认」）。
设置保存在浏览器 localStorage；关闭面板再打开仍回到统计视图，不会留在设置页。
数据来源与凭据¶
- 余额：DeepSeek 官方
GET /user/balance，由宿主进程代发，浏览器侧不接触 API key。 - 用量：读本机会话日志中的
assistant/message事件，全部在本机计算，不上传任何数据。 - 读取 API key 的顺序：DSH 凭据服务 → 环境变量
DEEPSEEK_API_KEY。只要 DSH 本身能调用 DeepSeek，此处即可显示余额。
与其他统计方式的区别¶
插件只统计写入会话日志的调用；在 DSH 之外用同一 API key 产生的消耗不会进入用量图表（余额本身仍是全账户）。「其他模型」分组按 provider 前缀识别 WorkBuddy、本地模型（lm-*、omlx、local）和常见厂商，其余归入「其他」。
安装与启用¶
在能使用 dsh plugin 的环境中执行（命令来自仓库 README）：
dsh plugin --profile web add dsh-tok-qty
装完后重启 DSH。插件自带 cordis.patch.yml bundle patch，一般无需再改宿主侧的 cordis.patch.yml。
兼容性要点：
- 需要能在
conversation.composer.dock注册的 DSH 客户端（依赖@deepseek-ai/dsh-client-ui-conversation）。 - 用量统计依赖多帧 zstd 解压（Node 20+ 的
zlib.zstdDecompressSync）；更旧 Node 可能只读到第一帧，面板显示为 0。package.json中engines.node为>=20。
典型用法¶
- 完成安装并重启 DSH，进入已有会话（dock 不在新建会话欢迎页渲染）。
- 在输入框右下角点击钱包与余额药丸，打开统计面板。
- 在「今日 / 本周 / 本月」间切换，查看对应总量与面积图、柱状图。
- 需要最新数据时点刷新；要调整图表样式或隐藏字段时打开齿轮，改完后关闭面板即可，下次仍从统计界面进入。
无额外配置文件；偏好存在浏览器 localStorage。
适用场景与注意¶
适合谁：经常在 DSH web 客户端里对话、希望在同界面掌握 DeepSeek 余额与本机会话 token 分布的开发者；需要对比 DeepSeek 与本地 / 第三方模型用量占比时也有柱状图可用。
运行与信任边界：插件以当前 DSH 进程权限运行，并会读取本机会话日志与凭据服务中的 DeepSeek key（仅用于余额请求）。安装前建议在 GitHub 仓库 阅读源码与 MIT 许可证，确认符合你的安全策略。
已知边界（README 原文）：
- 新建会话欢迎页无状态栏药丸。
- 用量不含 DSH 外的同 key 消费。
- 厂商分组依赖前缀启发式，未知 provider 落在「其他」。
社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本插件是社区贡献之一。
结尾¶
dsh-tok-qty 把 DeepSeek 余额和基于本地日志的 token 统计收进 composer 状态栏，今日 / 本周 / 本月切换、分时段图与按厂商柱状图都在同一面板完成，数据本地计算、不上传。若你使用 DSH web 客户端并希望少切窗口看用量，可按上文命令安装并重启验证。
- 目录页：https://www.skillhub.cn/plugins/loiter1EM/dsh-tok-qty
- 源码与说明：https://github.com/loiter1EM/dsh-tok-qty
