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 倉庫