dsh-balance：在 dsh Web 底部顯示 DeepSeek 賬戶餘額

在 DeepSeek Harness (DSH) 的開發流程中，頻繁查看賬戶餘額是常態。這通常需要切換標籤頁或打開官方面板，打斷工作流。dsh-balance 將這一數據直接嵌入 Web 界面。

插件簡介¶

dsh-balance 是一個由 ywleeo 維護的客戶端插件，用於在 dsh Web 對話底部顯示 DeepSeek 賬戶餘額。它不依賴複雜的構建過程，直接讀取環境變量中的 API Key 並獲取餘額數據。

核心功能¶

位置與樣式：顯示在 token 統計行前面（conversation.composer.dock，order: -1）。樣式與 token 統計保持一致（12px / label-tertiary / 居中）。
數據刷新：頁面加載時自動獲取，之後每 5 分鐘輪詢一次。點擊數字旁的 ⟳ 圖標可手動刷新。
時段着色：根據北京時間實時判定計費時段。週一至週五 09:00–12:00 / 14:00–18:00 爲高峯時段，餘額顯示橙色；其餘時間爲空閒時段，顯示正常色。懸停可查看當前時段說明。
交互：點擊餘額數字，會在新標籤頁打開官方餘額/用量面板。
安全與架構：API Key 不離開本地 host，僅通過 fetch 請求同源 JSON 接口。不寫入會話日誌，不註冊投影，無污染風險。採用純 ESM，零構建。

安裝與啓用¶

    cd ~/.dsh/profiles/web

使用 pnpm 安裝插件（支持本地路徑或 GitHub 倉庫）：

    pnpm add file:/path/to/dsh-balance   # 或 pnpm add github:ywleeo/dsh-balance

在 ~/.dsh/profiles/web/cordis.patch.yml 文件中追加以下配置：

    - insert:
        - id: dsh-balance
          name: dsh-balance

重啓 dsh web 並刷新瀏覽器頁面。

工作原理¶

插件採用“Host 殼”機制防止崩潰。index.js 作爲殼，不直接依賴 dsh 核心模塊，確保 boot 審計通過。它運行時動態加載 host.js，host.js 負責解析 DEEPSEEK_API_KEY 並調用官方 API。client.js 負責在界面展示。如果 host.js 加載失敗，插件會停用但不會導致 dsh 進程退出。

適用場景與注意¶

適合需要實時監控 DeepSeek 賬戶成本的開發者。插件遵循 MIT 許可證。安裝前建議檢查源碼。插件以當前 dsh 進程的權限運行，API Key 僅在本地傳輸。

總結¶

dsh-balance 解決了在開發過程中頻繁切換窗口查看餘額的痛點，將關鍵信息通過精簡的小字直接展示在對話底部，並提供了基於時段的視覺提示。更多細節可參考 GitHub 倉庫：https://github.com/ywleeo/dsh-balance。