前言¶

在本地運行 DeepSeek 模型時，持續監控 API 餘額是必要的操作。手動查詢網頁或終端既低效又不直觀。dsh-balance-local 針對此場景設計，將餘額查詢集成到 DSH 界面中，提供直觀的顯示面板和徽章，同時嚴格遵守安全原則，確保 API Key 不離開 Host 進程。

它是什麼¶

這是一個 DeepSeek Harness (dsh) 插件，由維護者 chenpengye 開發。它是一個 Cordis bundle，旨在爲 dsh 提供餘額查詢能力，包含設置頁面板和輸入框徽章。插件核心價值在於：在 Host 端完成 API 請求，僅將脫敏後的餘額數據返回給瀏覽器。

該插件提供以下功能：

設置頁面板：在 DSH 的設置頁面顯示「DeepSeek 餘額」面板，包含總餘額、充值餘額和贈送餘額。面板提供手動刷新按鈕。
輸入框徽章：在會話輸入框下方顯示餘額狀態徽章。綠色代表有餘額，橙色代表無餘額，灰色代表加載中或錯誤。
自動刷新：默認每 60 秒自動刷新余額。Host 側對響應進行 30 秒緩存。
安全機制：API Key 僅在 Host 進程的憑據庫中解析，永不發送至瀏覽器。插件提供的路由僅允許本機迴環訪問（默認 allowRemote: false）。錯誤信息經過分類處理，不透傳上游響應體。

由於插件未發佈至 npm，需通過源碼安裝。

    git clone https://github.com/chenpengye/dsh-balance-local.git
    cd dsh-balance-local
    pnpm install && pnpm build

構建完成後，會在 `lib` 目錄下生成 `index.js` 和 `client.js`。

    cd ~/.dsh/profiles/web
    pnpm add /absolute/path/to/dsh-balance-local -w

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

重啓與刷新
重啓 dsh web（或觸發 HMR 熱加載），並在瀏覽器中執行硬刷新（Cmd+Shift+R / Ctrl+Shift+R）。

無需額外配置。API Key 直接複用 dsh 憑據庫中保存的 DEEPSEEK_API_KEY（即設置 → 模型中保存的同一個 Key）。插件啓動後會自動讀取該憑據並查詢餘額。

運行環境：插件以當前 dsh 進程的權限運行，需確保對 ~/.dsh/profiles/ 目錄有讀寫權限。
安全配置：默認情況下，插件路由拒絕非 Loopback 請求。如需在局域網其他設備訪問餘額查詢接口，需修改配置項 allowRemote: true。
響應頭：API 返回的響應頭包含 no-store 和 nosniff，這是標準的安全實踐。
更新：修改源碼後需重新運行 pnpm build 並重啓 dsh。

dsh-balance-local 通過將餘額查詢本地化並集成到 DSH 界面，解決了開發者監控成本的問題。其安全設計確保了 Key 的安全。更多細節與源碼，請訪問：GitHub 倉庫。