前言¶

DSH 支持通過插件擴展界面和數據展示。使用 DeepSeek 時，除了當前對話本身，還需要看到賬戶餘額、當前會話預估消耗、歷史對話成本，以及不同模型按歷史平均消耗還能使用多少次。

@gongshiyun/dsh-usage-dashboard 是 gongshiyun 維護的 DSH 插件，用於展示 DeepSeek 賬戶餘額、當前會話預估消耗、歷史對話明細，並根據歷史會話的平均消耗估算各模型剩餘對話次數。

插件定位¶

• 包名：@gongshiyun/dsh-usage-dashboard
• 維護者：gongshiyun
• 許可證：MIT
• 適用 profile：desktop 或 web
• Node.js 要求：^22.19.0 || >=24.0.0

注意：npm 上不帶 scope 的 dsh-usage-dashboard 是另一個同名但無關插件。安裝時應使用：

@gongshiyun/dsh-usage-dashboard

核心能力¶

餘額展示¶

調用 DeepSeek 官方接口：

GET /user/balance

展示總餘額、充值餘額、贈送餘額，貨幣可爲 CNY 或 USD。

當前會話預估¶

在輸入框下方即時顯示：

• 當前會話預估金額
• 當前餘額
• 預估還能對話幾輪

該信息隨對話每 4 秒自動刷新。

全局看板¶

在「設置 → 用量與餘額」中展示：

• 餘額卡片
• 歷史對話明細
• 各模型剩餘對話次數

歷史對話明細¶

歷史對話明細按創建時間倒序展示：

• 創建時間
• 輸入 token
• 輸出 token
• 折算金額

空會話會被自動跳過。

模型聚合¶

插件會按模型聚合歷史會話，估算剩餘對話次數，並展示：

• 會話數
• 平均消耗
• 累計消耗
• token 明細

價目覈算¶

支持通過 pricing 價目歷史按生效時間、模型和峯谷時段覈算成本。

安裝與啓用¶

插件必須能被 Cordis Loader 從 profile 目錄按名稱解析。下面以 desktop profile 爲例；Web 版把命令中的 desktop 換成 web 即可。

推薦安裝命令：

dsh plugin --profile desktop add @gongshiyun/dsh-usage-dashboard

安裝後重啓或刷新 DSH Desktop。可以用下面命令確認 usage-dashboard 條目已生效：

dsh --profile desktop --dump-config

手動安裝¶

如果需要使用手動安裝方式，先將包安裝進 profile 的 node_modules，再編輯 cordis.patch.yml 並重啓。

1、進入 profile 目錄並安裝依賴：

cd "$DSH_HOME/profiles/desktop"
pnpm add <本包路徑或包名>

2、編輯：

$DSH_HOME/profiles/desktop/cordis.patch.yml

插入 usage-dashboard 配置。最小配置示例：

- insert:
  - id: usage-dashboard
    name: '@gongshiyun/dsh-usage-dashboard'
    config:
      currency: CNY

3、重啓 DSH Desktop。

配置¶

插件可配置項包括：

默認價目歷史爲內置，不會自動跟隨 DeepSeek 官方後續調價。

限制與注意¶

• 餘額接口爲按需輪詢：側邊欄膠囊 60s、儀表盤 4s，不是即時推送。
• 無網絡或未配置 API Key 時，餘額會顯示錯誤提示；成本統計仍可用，取決於本地會話數據。
• 跨會話的歷史平均依賴 dsh-session-query 服務，DSH 默認組合已包含。
• 插件以當前 DSH 進程權限運行。安裝前應檢查源碼、配置和許可證，並確認包名爲 @gongshiyun/dsh-usage-dashboard。

結尾¶

@gongshiyun/dsh-usage-dashboard 適合在 DSH 中查看 DeepSeek 餘額、當前會話消耗、歷史對話成本和各模型剩餘對話次數。

項目地址：

https://github.com/gongshiyun/dsh-usage-dashboard