dsh-token-meter-panel：DeepSeek Harness Token 用量与花费面板插件

DSH（DeepSeek Harness）客户端会记录每次调用的 Token 用量，但内核中不包含计费逻辑。dsh-token-meter-panel 插件将用量转化为成本数据，在侧栏增加一个独立面板，展示今日消费、预算进度、成本构成以及缓存命中节省的费用。

插件定位¶

• 类型：社区插件（非 DeepSeek 官方）。
• 作者：olimc2016。
• 定位：DSH 生态中满足“兼容 DSH 0.2.x、零外部依赖、峰谷计价、账户余额”的 Token 统计面板插件。

核心功能¶

该插件主要提供以下数据维度：

1. 官方用量 30 天（免登录）
   直接读取 DSH 账号会话，无需浏览器登录或 API Key，即可查看按天趋势、按模型、请求数的官方用量。

2. 财务数据

   • 今日消费：金额大字展示、预算进度条、与上次对比。
   • 账户余额 / 累计消费：余额支持 DeepSeek 账号登录或 API Key；累计消费需通过官方接口查询，无需网页登录。

3. 可视化面板

   • 四宫格：缓存命中输入、未命中输入、输出 Token 数量及调用次数。
   • 每日趋势：近 7 天或 30 天的柱状图堆叠，支持悬浮查看明细。
   • 今日分时：24 小时 Token 分布，标出峰值。
   • 成本构成：三类 Token 的花费占比，以及“若无缓存今天的花费”。

4. 会话明细

   • 按会话明细：今日每个会话的 Token、调用次数及消费，子代理会话有特殊标记。
   • 本会话实时：当前对话的实时用量投影。

计费逻辑与价格¶

插件内置了 DeepSeek 官方定价（采集自官方定价页），并支持峰谷分档计价。

1. 分档计价

   • 高峰时段：周一至周五 9:00–12:00、14:00–18:00。
   • 空闲时段：高峰价的一半。
   • 注：插件暂不识别法定节假日。

2. 缓存价格
   缓存命中输入的价格约为未命中输入的 1/50。这是面板重点展示的省费数据。

3. 特殊计价规则

   • reasoningTokens 已包含在 outputTokens 内，不重复计费。
   • 未知模型不进行价格估算，仅累加 Token 数量。
   • 会话标题生成与联网搜索调用不落 usage，无法计入花费。

安装与启用¶

安装命令¶

使用官方安装命令指定版本 v0.6.0：

dsh plugin --profile desktop add github:olimc2016/dsh-token-meter-panel#v0.6.0

双包名机制¶

插件以两个包名发布，代码完全相同，安装任一即可：
- 主力包：dsh-token-meter-panel
- 短名孪生包：dsh-token-mb（推荐新用户使用，因主力包在 npm 停止发布新版本）

由于插槽和路由前缀独立，同时安装两个包名不会冲突，会在侧栏生成两个“Token”面板。

启用与配置¶

1. 安装后必须重启 DSH Desktop 才能生效。
2. 零配置：重启后侧栏最下方会出现“Token”仪表盘图标。
   • 余额：插件会自动读取浏览器登录态（Local Storage），无需手动配置 API Key。
   • 多帧 zstd 解码：自带解码逻辑，无需安装系统级的 zstd 或 zstdcat。
3. 设置：可在设置 → 插件 → dsh-token-meter-panel 中调整费率、刷新间隔、告警阈值及是否显示余额。

数据来源与注意事项¶

数据来源¶

• 全量日志聚合：读取本机会话日志（session.v3.jsonl.zstd），按北京时分桶聚合。
• 官方投影：当前会话实时用量来自 DSH 的 useProjection('tokenUsage')。
• 官方用量：通过浏览器登录态读取官方 userToken 获取 30 天用量。

注意事项¶

1. 本地估算：面板金额为本机估算，非官方账单，价格可能变动，请以官方页面为准。
2. 权限边界：插件只读会话日志，不写文件，不执行命令，不联网（除余额查询外，可关闭）。
3. 数据盲区：
   • 会话标题生成与联网搜索调用不记录在 usage 中。
   • 活跃会话仍在追加写入，因此“今日”数据为下界。
4. 版本要求：仅兼容 DSH 0.2.x。