dsh-usage-card：DSH Web 側邊欄用量卡片

在 DeepSeek Harness 的 Web 界面開發中，頻繁查看 token 消耗和餘額是一個常見需求。手動切換頁面或查看後臺數據效率較低。dsh-usage-card 插件將用量卡片直接嵌入側邊欄，提供 7 天/30 天的用量統計與餘額查詢，節省切換窗口的時間。

是什麼¶

這是一個由用戶 kazma258 維護的 DSH 插件，用於在 DeepSeek Harness Web 側邊欄上方顯示用量信息，包括 token 消費、花費金額和剩餘額度。它遵循 MIT 許可證。

核心功能¶

側邊欄顯示：在 Web 側邊欄的設置按鈕上方展示用量卡片。
時間範圍：支持查看近 7 天或近 30 天的 token 用量與消費。
餘額查看：支持查看剩餘額度。
數據源切換：支持在“官方數據”（需登錄 token）和“估算數據”模式之間切換。
側邊欄適配：側邊欄收起時，卡片會顯示爲小圖標，點擊仍可查看詳情。
自定義配置：支持自定義價格與幣種配置。

安裝與啓用¶

確保你使用的是 DeepSeek Harness Web 介面（0.1.x）。

執行安裝命令：

dsh plugin --profile web add github:kazma258/dsh-usage-card

重啓 dsh web 服務，並在瀏覽器中刷新頁面以激活插件。

典型用法¶

切換數據模式¶

卡片默認顯示估算數據。點擊卡片右上角的按鈕，可以在“估算”、“官方”和“無數據”模式間切換。

若需查看官方數據，需要提供平臺登錄 token。

獲取官方數據 Token¶

在瀏覽器中打開 platform.deepseek.com 並登錄，然後打開瀏覽器開發者工具的 Console 面板，輸入以下命令獲取 userToken：

JSON.parse(localStorage.getItem('userToken')).value

自定義價格與幣種¶

在對應的 profile 配置文件 cordis.patch.yml 中覆寫價格與幣種配置。注意，價格配置項是整行替換，不會只修改其中某一個字段。

- id: usage-card
  name: dsh-usage-card
  config:
    estimatePrices:
      inputUncached: 0.28
      cacheRead: 0.07
      cacheWrite: 0.28
      output: 1.1
    estimateCurrency: USD
    officialCurrency: USD

適用場景與注意¶

環境要求：插件僅適用於 DeepSeek Harness Web 介面（0.1.x）。
Token 類型：查看官方數據需要平臺登錄 token (userToken)，而非 API Key。
配置細節：價格配置採用整行替換方式，修改時需提供完整的配置行。
自動更新：卡片會在對話結束、切回分頁、每 60 秒或點擊刷新時自動更新。

DSH 的設計理念是“一切皆插件”。該插件通過側邊欄集成，讓用量監控變得觸手可及。