在使用 DeepSeek Harness 時，如果同時運行多個會話或後臺任務，容易忽略當前的負載情況。如果沒有顯式的 UI 指示，很難直觀看到有多少會話處於活躍狀態，或者 API 配額是否即將耗盡。此插件通過右下角卡片解決了這個問題。
插件簡介¶
插件名稱爲 lovstudio/dsh-account-balance，由用戶 lovstudio 維護。它是一個組合行，安裝在 DeepSeek Harness 網頁端後，會固定在界面右下角。插件負責統一展示當前會話和後臺任務的狀態，以及 GLM、KIMI 的配額條和 OpenRouter、DeepSeek 的餘額信息。
核心功能¶
-
會話與任務狀態
顯示當前會話和後臺任務的數量。卡片會顯示爲「空閒」或「N 會話 · M 任務」的形式。狀態每 3 秒輪詢一次，通過ctx.agents.list()和ctx.jobs.list()獲取內存快照。 -
配額可視化
針對 GLM 和 KIMI，顯示 5 小時和每週的配額條。配額條顏色根據使用率變化：綠色（<50%）、橙色（≥50%）、紅色（≥80%）。鼠標懸停可查看具體使用量、剩餘量及重置倒計時。 -
餘額顯示
顯示 OpenRouter（美元）和 DeepSeek（人民幣）的剩餘餘額。餘額數據通過 Host API 每 60 秒輪詢一次，並在緩存中保存 55 秒。 -
Host API 暴露
插件通過 Host API 暴露了兩個接口：accountBalance.status(): 返回{ sessions, tasks }。accountBalance.quotas(): 返回{ at, rows: { glm, kimi, or, ds } }。
安裝與啓用¶
在安裝前，請確保環境滿足以下要求：
* Node.js 22.19+ 或 24+
* pnpm 11
使用以下命令安裝插件：
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-account-balance#v0.1.3
安裝後，重啓 DSH Web 界面即可看到右下角的卡片。插件是組合行，安裝後會存活於頁面重啓。
典型用法¶
UI 直接查看¶
無需配置。插件會自動讀取憑證服務中的憑據並展示數據。如果缺少某個 API Key，對應行會顯示爲「—」。
通過 Host API 獲取狀態¶
可以通過 accountBalance.status() 方法獲取當前的會話和任務快照：
const result = await accountBalance.status();
// result.data 爲 { sessions: number, tasks: number }
通過 Host API 獲取配額¶
通過 accountBalance.quotas() 獲取包含 GLM、KIMI、OpenRouter、DeepSeek 四家提供商的配額快照：
const result = await accountBalance.quotas();
// result.data 爲 { at: string, rows: { glm, kimi, or, ds } }
適用場景與注意事項¶
適用場景：
* 需要持續監控 DeepSeek Harness 後臺任務運行情況的用戶。
* 需要直觀查看 GLM/KIMI 配額消耗，避免超額扣費的用戶。
* 需要通過 API 集成餘額和狀態數據的開發者。
注意事項：
* 權限與可見性：jobs.list() 的可見性可能受限。非當前會話擁有的作業可能不計入 tasks 統計中。
* 無模型調用：插件本身不執行任何模型調用，因此不會產生 Token 消耗，也不會影響 KV Cache。
* 容錯處理：GLM 和 KIMI 的 API 形狀變化時，插件會顯示 no-data 而不是崩潰。
* 憑證讀取：插件直接通過 ctx.credentials 讀取憑據，不會將憑據發送到外部。
