DeepSeek Harness 插件：dsh-usage-stats-plus 用量与余额面板增强

前言¶

DSH（DeepSeek Harness）采用「一切皆插件」的架构。对于智能体开发者而言，用量与余额的监控是刚需。dsh-usage-stats-plus 是一个针对官方面板的增强插件，旨在解决本地估算不准、缺乏全渠道消耗追踪的问题。它 fork 自 dsh-usage-stats，由 Nixz0824 维护，采用 MIT 协议。

核心功能¶

该插件主要包含以下能力：

• 官方余额实时拉取：直接调用 /user/balance 接口获取余额，不依赖本地估算。
• 逐事件精确计价：基于官方峰谷价目表，对会话日志中的每个事件进行精确计费。
• 全渠道消耗估算：通过官方余额接口的每日快照差值计算消耗，能对齐开放平台账单口径（需前一日快照，次日生效）。
• Codex 风格活动时间轴：提供 12 个月滚动视图，支持每日/每周/累计三种视图。
• 黑白灰单色系 UI：与 DeepSeek 官方鲸鱼 Logo 同源的视觉风格，支持明暗主题自适应。
• 无额外依赖：纯 JavaScript 实现，无需构建步骤，无新增运行时依赖。

安装与启用¶

插件仓库为公开状态，可通过以下命令安装。推荐使用 GitHub Release 预构建包：

dsh plugin --profile web add https://github.com/Nixz0824/dsh-usage-stats-plus/releases/latest/download/dsh-usage-stats-plus-0.3.0.tgz

或者从 GitHub 源码安装：

dsh plugin --profile web add github:Nixz0824/dsh-usage-stats-plus

安装完成后，刷新浏览器页面以加载客户端资源，并重启 dsh web 以确保侧边栏条目正确显示。

配置与计价口径¶

插件支持通过配置覆盖价格。在 cordis.patch.yml 中添加 insert 条目：

- insert:
    - id: usage-stats
      name: dsh-usage-stats-plus
      config:
        prices:
          "deepseek-v4-pro": { peak: { hit: 0.30, miss: 9.0, output: 27.0 }, offpeak: { hit: 0.15, miss: 4.5, output: 13.5 } }
          # 其他模型可在此补充

计价基于官方价格文档（2026-08-17 生效），包含缓存命中、输入未命中、输出三种计费维度。高峰时段判定基于北京时间。

注意事项¶

• 缓存计费：缓存写入按输入未命中价计费。
• 时区限制：高峰时段判定严格基于北京时间，与机器时区无关。
• 未知模型：除了 V4-Pro 和 V4-Flash 外，其他模型默认不计价，显示为 unknown。
• 全渠道估算：全渠道消耗估算需要前一日余额快照，数据在次日生效。
• 版权保留：保留上游 dsh-usage-stats contributors（2026）的版权声明。

该插件通过重构计价引擎与 UI，为 DSH 用户提供了更贴近官方账单的消耗视图。源码与文档见下方链接。

• 插件目录页
• GitHub 仓库