DeepSeek Harness 用量日报插件

前言¶

在使用 DeepSeek Harness (DSH) 进行开发或日常对话时，掌握当日 token 消耗和费用是刚需。手动统计效率低，且容易遗漏。该插件通过读取 DSH 自身的会话日志，在 Web 界面右下角提供实时汇总。

插件定位¶

这是一个给 DSH Web 界面用的用量日报挂件。常驻右下角，自动统计当天各会话的 token 消耗、消息数、轮数，并用 DeepSeek 价格估算费用。插件由 HaoR325 维护，开源协议为 MIT。

核心功能¶

• 今日用量汇总：展示输入/输出/缓存 token、消息数、轮数以及估算费用。
• 自动刷新与缓存：支持 60s 自动刷新，服务端缓存机制确保不刷屏，不额外压榨 API。
• 费用估算：按 DeepSeek 默认价格计算，支持通过环境变量覆盖单价。
• 浮窗 UI：在右下角显示半透明卡片，具备 NaN 安全处理，刷新即用。
• HTTP 接口：提供 GET /api/dsh-usage-daily/report 接口，返回当日聚合 JSON，方便二次开发。

安装与启用¶

使用本地链接方式安装，避免依赖网络仓库。

dsh plugin --profile web add link:<本仓库绝对路径>

安装完成后，重启 dsh web，在浏览器中按 F5 刷新，右下角即可看到用量日报浮窗。

环境变量配置¶

插件默认按 DeepSeek 官方价格计算费用。如需调整，可通过环境变量覆盖，单位为 USD / 百万 token。

接口说明¶

插件通过 webServer 注册了 HTTP 接口，用于获取数据。

接口地址：

GET /api/dsh-usage-daily/report

返回示例：

{
  "ok": true,
  "date": "2026-01-01",
  "sessions": 3,
  "messages": 41,
  "turns": 12,
  "totals": { "input": 12345, "output": 6789, "cacheRead": 0, "cacheWrite": 0 },
  "totalTokens": 19134,
  "costUsd": 0.0087,
  "perSession": [
    { "id": "session-1", "messages": 20, "turns": 8, "tokens": 12345 }
  ]
}

技术细节¶

• 数据来源：数据直接来自 DSH 自身的会话日志（sessionQuery.readSession），无需任何令牌或调用平台费用接口。
• 技术栈：纯 Node ESM，无外部依赖。
• 实现方式：通过 tapIndex 注入右下角浮窗脚本，并使用 sessionQuery.listSessions / readSession 聚合当日事件。

总结¶

该插件通过服务端缓存和本地日志读取，实现了对 DSH 每日消耗的精准监控，适合需要控制成本的智能体开发者使用。更多细节可查阅生态目录或GitHub 仓库。