前言¶
在使用 DeepSeek Harness (DSH) 處理第三方 API 請求時，若頻繁查看餘額或手動切換 Key，會打斷工作流。這個插件直接在 DSH 的輸入框底部集成狀態顯示，解決上述痛點。
插件介紹¶
插件名稱：mengshang-spec/dsh-third-party-api-balance-wallet
這是一個由 Mengshang-spec 維護的聯網工具類插件。它面向使用 Sub2API 構建的第三方 API 站點，在 DSH 界面中實時展示賬戶餘額、Key 有效性及今日用量。插件版本爲 0.3.1，採用 MIT 許可證。
核心功能¶
- 狀態展示：在輸入框底部顯示賬戶餘額。
- 有效性檢測：顯示 API Key 是否有效及當前賬戶模式。
- 詳情懸停：鼠標懸停可查看今日請求數、Token 數、原價和折後實付金額。
- 自動刷新：啓動後立即查詢，之後每 30 分鐘自動刷新一次。
- 配置靈活：支持 Sub2API 站點的自動發現和手動配置。
- 安全存儲：API Key 僅保存在 DSH 宿主側，瀏覽器端不保存完整 Key，只接收打碼後的 Key。
- 地址限制：餘額 URL 強制使用公網 HTTPS，拒絕本機地址和內網 IP。
安裝與啓用¶
在 DSH 終端中執行以下命令安裝：
dsh plugin --profile web add github:Mengshang-spec/dsh-third-party-api-balance-wallet
安裝或升級後，需要重啓 DSH，讓宿主和瀏覽器端插件重新加載配置。
典型用法¶
零配置自動發現¶
如果 DSH 已經配置了目標站點的模型 provider，插件可以自動找到餘額地址和 Key。前提是：
~/.dsh/settings.yaml中的 provider 包含baseURL和apiKeyEnv。~/.dsh/.credentials.yaml的refs中有對應的apiKeyEnv。- API Key 以
sk-開頭。
插件會按順序選擇滿足以下條件的 provider：
* baseURL 是公網 HTTPS 地址。
* 不是 DeepSeek、OpenAI 等官方模型 API 地址。
* 有對應的 apiKeyEnv 和憑據。
自動發現後，插件會查詢 {provider.baseURL}/v1/usage。
手動配置¶
自動發現失敗時，點擊餘額面板右側的設置按鈕（齒輪圖標）。
- API Key：填寫目標站點的長期 API Key（例如
sk-xxxxxxxxxxxxxxxx），不要填寫網頁登錄的 JWT 令牌。 - 餘額接口地址：填寫 Sub2API 站點的用量接口，通常爲
/v1/usage。例如https://hgapi.dieqiyun.top/v1/usage。 - 保存：點擊保存，Key 會存入
<DSH_PROFILE_DIR>/dsh-wallet-switcher/settings.json。
環境變量¶
也可以在啓動 DSH 前設置環境變量來覆蓋配置：
DSH_WALLET_USAGE_URL='https://你的站點/v1/usage'
DSH_WALLET_API_KEY='sk-xxxxxxxxxxxxxxxx'
DSH_WALLET_CURRENCY='USD'
配置優先級從高到低爲：插件面板保存 > 環境變量 > 自動發現 > 舊 accessToken 配置 > 默認地址。
適用場景與注意¶
- 適用對象：主要適配 Sub2API 構建的站點。對於非 Sub2API 站點，接口路徑或返回字段可能不同，需手動調整。
- 安全機制：瀏覽器端不再將 API Key 寫入
localStorage。升級時會自動清理舊版本遺留憑據。錯誤響應也不會包含完整 Key。 - 地址限制：爲了防止 SSRF 攻擊，插件只允許公網 HTTPS 地址，拒絕
http://、localhost、127.0.0.1以及內網 IP。 - 排查建議：若查詢失敗，首先確認 Key 是否屬於當前餘額接口對應站點，確認地址格式是否爲
/v1/usage，並檢查是否因查詢過於頻繁觸發限流（默認 30 分鐘刷新一次）。
總結¶
該插件通過在 DSH 輸入框底部集成餘額查詢功能，簡化了第三方 API 的管理流程。它支持零配置自動發現和手動配置兩種模式，同時注重安全性，確保 Key 僅在宿主側存儲。
