前言¶

DeepSeek Harness（DSH）采用插件化架构。开发者在 Web 端使用时，往往需要直观了解 API 消费、账户余额以及 Token 的具体构成。现有的方式可能需要切换到官方控制台或查看本地日志，不够直观。dsh-plugin-usage 插件通过读取本地会话日志全量重建数据，按 DeepSeek 官方峰谷价估算费用，直接在 DSH 界面上提供看板。

插件定位¶

这是一个由 1998moye 维护的客户端插件，遵循 MIT 协议。它集成在 DSH 输入框工具条中，不做悬浮窗，不会覆盖对话内容。

安装与启用¶

安装前请确保环境满足要求：
* Node.js 20+
* DSH 0.1.5 及以上版本

执行以下命令进行安装：

git clone https://github.com/1998moye/dsh-plugin-usage.git
dsh plugin --profile web add /path/to/dsh-plugin-usage

安装后需要重启 dsh web 进程，并在浏览器中强制刷新（Ctrl+F5 / Cmd+Shift+R）以加载插件。

核心功能¶

插件提供以下核心能力：

• 全量历史重建：启动时扫描 $DSH_HOME/sessions/**/session.jsonl.zstd，重建包含插件安装之前的用量历史。
• 账户余额查询：直连 DeepSeek 官方接口查询余额，区分充值余额与赠送余额。
• 峰谷分时计价：根据北京时间计算高峰/空闲时段，按不同模型和计费项（输入/输出/缓存）应用不同单价。
• 请求与 Token 统计：统计 API 请求次数，并按“未命中缓存”、“命中缓存”、“输出”拆分 Token 明细。
• 趋势图表：提供近 7 天或近 30 天的消费趋势图。
• 分组明细：支持按模型或 API Key（provider）分组查看明细。

使用方法¶

插件按钮集成在输入框工具条右侧，与“完全权限”、“模型选择”等控件在同一行。当有活跃会话时，按钮会显示今日消费金额。
点击按钮即可弹出看板。看板包含以下操作：

• 时间维度切换：今日 / 本周 / 本月 / 全部（本周从周一算起，本月从 1 号算起，均为北京时间）。
• 指标查看：消费金额、API 请求次数、Token 消耗。
• 页签切换：
  • Token 页签：查看未命中、命中、输出的占比。
  • 余额页签：查看充值与赠送余额。

数据来源与计费逻辑¶

插件数据完全来源于本地日志。日志落盘于 $DSH_HOME/storages/用量看板.json，只记录数值型 Token 和费用，不含对话内容。
余额查询由宿主进程发起，API 密钥取自 DSH 凭据，不会下发到浏览器。
费用计算基于官方定价估算，包含峰谷分时逻辑。缓存命中价格通常远低于未命中价格。

注意事项¶

• 日志依赖：可统计范围取决于本地日志，日志被清理的时段无法补出。若官方面板显示区间大于本地日志覆盖范围，两者对不上是正常的。
• 计费差异：费用为按 token 与官方单价估算，与账单实际扣费可能因官方调价、赠送余额抵扣顺序而略有差异。
• 数据缓存：余额查询结果缓存 30 秒。
• 维度说明：明细里的“API Key”维度实际是 provider。DSH 会话日志中只有 provider 字段，无法区分同一 provider 下的不同 Key。
• 按钮显示：插件按钮只在有会话时显示，欢迎页没有输入工具条，因此按钮不会显示。

总结¶

该插件通过本地日志重建和官方定价估算，为 DSH Web 用户提供了透明的用量与费用监控能力，适合需要精细控制 API 消费成本的智能体开发者。项目源码位于 GitHub。