前言¶

DeepSeek Harness (DSH) 採用插件化架構。在開發或調試時，經常需要確認當前路由在提供者賬本上的實際餘額，而不是基於本地 Token 的估算。dsh-gateway-wallet 插件將此功能集成到側邊欄中，直接讀取站點賬本。

插件介紹¶

這是一個獨立第三方社區項目，由 MuAllen 維護。它讀取當前 API key 在站點賬本上的剩餘額度和實扣，支持 Sub2API、New API 與 DeepSeek 官方。本插件與 TokenLedger（用量賬本）是互補關係：用量賬本記的是本機會話裏的 token；本插件讀的是站點給這把 key 的餘額。

安裝與啓用¶

需要使用 DeepSeek Harness 的 web profile。

dsh plugin --profile web add github:MuAllen/dsh-gateway-wallet

重啓 DSH，並硬刷新瀏覽器。側邊欄底部會出現「站點餘額」。

升級或卸載：

dsh plugin --profile web update dsh-gateway-wallet
dsh plugin --profile web remove dsh-gateway-wallet

核心功能¶

插件在 DSH 側邊欄左下角增加“站點餘額”入口，點開後顯示：

• 當前路由、令牌名、脫敏 Key（sk-••••xxxx）；配了多條路由時可切換查看。
• 金額信息：餘額、今日實扣、累計已用。
• 用量統計：今日 / 累計 token 桶與請求數。
• 套餐信息：套餐名、RPM / TPM。
• 餘額告警：餘額低於 $1 / ¥5 時，側邊欄按鈕打點（側欄收起時仍能看見）。

支持範圍與接口¶

插件通過探測接口返回來識別站點類型，並讀取相應數據：

• Sub2API（如部分國內中轉）：讀取 /v1/usage。獲取餘額、今日/累計實扣、token 桶。
• New API / One API 等分支：讀取 /api/usage/token/。獲取額度、已用；今日僅日誌完整返回時顯示。key 額度不限時餘額顯示爲未公佈，令牌欄單獨標明這把 key 不限。
• DeepSeek 官方：讀取 /user/balance。僅顯示餘額；沒有今日實扣。

對不匹配的站點會說明原因，不會按另一套程序換算額度。

注意事項¶

• 本插件是獨立第三方社區項目，與 DeepSeek、各中轉站均無隸屬、贊助或背書關係。
• 面板上的金額以站點當時返回爲準，不是對賬單或稅務憑證。接口變更、站點口徑或網絡失敗都可能導致空白或與控制台不一致。
• 本軟件按 MIT 許可證「按現狀」提供，作者不對使用本插件造成的損失承擔責任。
• 完整 API Key 僅在本機 Host 進程內用作 Authorization 頭，不會進入瀏覽器，也不會發到本插件作者的任何服務器。

鏈接¶

• GitHub: https://github.com/MuAllen/dsh-gateway-wallet