dsh-credits：DeepSeek Harness 额度与消耗可视化插件

前言¶

DeepSeek Harness（dsh web）为开发者提供智能体运行环境。在长期运行或多账号切换场景下，实时掌握账户余额、会话消耗及累计成本是刚需。dsh-credits 是 DeepSeek Harness 的额度插件，在界面中直观展示余额、消耗与 TPS，支持多供应商与自定义接口。

功能概览¶

该插件在输入框下方显示账户余额与本会话估算消耗，右下角提供可拖动的累计消耗胶囊。设置位于侧栏「额度」（货币硬币图标），支持多张可折叠卡片。核心能力包括：
* 多源额度支持：支持 DeepSeek 官方余额或 OpenCode Go 订阅用量，或通过自定义 HTTP 接口接入其他额度源。
* 峰谷价与 TPS：支持 DeepSeek V4 峰谷价自动套用，并从 DSH Session v2 的 settlement 数据计算生成吞吐 TPS。
* 多供应商配置：支持多个供应商独立配置，互不干扰。
* 可视化与导出：支持本会话估算、跨会话累计消耗可视化，以及 YAML 导出配置。

安装与启用¶

使用以下命令安装插件：

dsh plugin --profile web add dsh-credits

本地开发时，请使用绝对路径：

dsh plugin --profile web add <本目录绝对路径>

安装完成后需重启 dsh web 以加载变更。

配置说明¶

插件配置以 providerQuotas 为准。敏感凭证（如 Token）保存到 DSH credentials，不写入普通 YAML 配置。配置文件通常位于 $DSH_HOME/profiles/web/cordis.patch.yml，也可在侧栏「额度」设置中修改后点击保存。

供应商额度配置¶

在「设置 → 额度 → 额度查询」中，以 DSH 已启用的供应商为列表。每个供应商可独立选择：
* 内置模板：使用模板的查询地址和解析规则，支持 DeepSeek、OpenCode Go 及其他内置余额/套餐模板。
* 复用另一供应商额度：两个模型供应商共用同一账号时，直接展示另一项已查询到的额度。
* 自定义 HTTP 接口：自行填写 URL、鉴权、返回字段映射与数值换算。

YAML 配置示例¶

以下示例展示了为两个 OpenCode Go 账号配置额度及设置人民币计价：

- id: dsh-credits
  config:
    providerQuotas:
      - providerId: opencode-go
        enabled: true
        sourceType: template
        templateId: opencode-go
        thresholdMode: percent
        warningThreshold: 30
        dangerThreshold: 10
        refreshIntervalMs: 300000
      - providerId: go-personal
        enabled: true
        sourceType: template
        templateId: opencode-go
        thresholdMode: percent
        warningThreshold: 30
        dangerThreshold: 10
        refreshIntervalMs: 300000
    currency: CNY

兼容性与注意事项¶

版本要求：适配 DSH Session v2（dsh 0.1.3-alpha.2 起），不再兼容旧版会话事件。
敏感信息：直接填写的 Token 或 Cookie 保存到 DSH credentials，不写入导出的普通配置。
本地开发：安装本地插件需使用绝对路径。
生效时机：修改配置后需重启 dsh web 才能生效。

总结¶

dsh-credits 为 DSH Web 提供了完整的额度管理方案，从余额查询、消耗估算到成本可视化，帮助开发者更精细地控制运行成本。插件支持灵活的配置方式，既可使用内置模板快速接入主流服务商，也可通过自定义接口适配更多场景。

链接：GitHub 仓库