在使用 DeepSeek Harness (DSH) 進行開發或調用服務時,經常需要打開網頁或第三方平臺查看 API Key 的餘額或訂閱額度,這會打斷操作流。下面介紹一個 Web GUI 插件,它能在 DSH 界面右下角常駐顯示用量卡片,解決頻繁查看餘額的問題。
插件簡介¶
插件名稱爲 loommii/dsh-provider-usage,由 loommii 維護,開源協議爲 MIT。這是一個 Web GUI 插件,核心功能是在 DSH 的 Web 界面右下角懸浮顯示 AI 服務的用量或餘額,支持多實例配置和本地 Token 統計。
核心功能¶
- 常駐右下角懸浮用量卡片:在主界面右下角顯示用量或餘額,位置可拖動。
- 自動刷新:每 30 秒自動更新數據;點擊卡片上的 ↻ 可手動刷新。
- 多實例配置:支持同時配置多個提供方(如多個賬號),點擊卡片上的 Logo 或名稱可切換查看。
- 本地 Token 統計:讀取本地會話文件進行離線統計,不聯網。
- API Key 加密存儲:密鑰僅在 DSH 進程內使用,界面顯示時打碼,支持 AES-256 加密。
安裝與啓用¶
安裝前請確保已安裝 DSH。安裝命令如下:
# 安裝
dsh plugin --profile web add github:loommii/dsh-provider-usage
安裝後重啓 dsh web 即可生效。
典型用法¶
- 打開 DSH 設置,進入「用量中心」。
- 點擊「提供方」添加實例:
- OpenCode Go:支持訂閱查詢。
- DeepSeek:支持餘額查詢。
- Command Code:支持訂閱/餘額查詢。 - 添加賬號後,返回主界面,右下角會出現用量卡片。
注意事項¶
- 密鑰安全:密鑰僅在 DSH 進程內使用,界面顯示時打碼,不會上傳或泄露。
- 本地統計:本地 Token 統計功能不聯網,僅讀取本地會話文件。
可選配置項¶
插件支持部分配置項,默認值通常可用。如需調整,可寫入 profile 的 bundle 配置(cordis.patch.yml 或設置頁):
| 配置項 | 默認值 | 說明 |
|---|---|---|
timeoutMs |
15000 |
出站請求超時。 |
subscriptionTimeoutMs |
5000 |
Command Code 訂閱端點超時。 |
maxSessions |
30 |
本地 Token 統計掃描的會話文件數上限。 |
sessionsDir |
$DSH_HOME/sessions |
本地 Token 統計的會話目錄。 |
更多細節可查閱 GitHub 倉庫。