前言¶
在 DeepSeek Harness（DSH）裏跑任務時，賬戶餘額是否夠用往往要到 DeepSeek 官網或賬單頁才能確認。側欄只有賬號頭像，沒有和計費相關的即時信息。任務跑完才發現餘額不足，會打斷開發節奏。
下面介紹社區插件 dsh-avatar-balance（維護者 adrian-atlas）：在側欄底部、頭像正上方增加一行全寬餘額展示，並用顏色標記是否低於你設定的閾值；餘額會在任務結束等時機自動刷新。插件分類爲客戶端，當前 GitHub 星標爲 0，許可證 MIT，版本 1.0.1（以倉庫 package.json 爲準）。
這是什麼¶
dsh-avatar-balance 是 DSH 的 Web 客戶端插件：登錄 DeepSeek 賬號後，在側欄腳註區域顯示賬戶總餘額（充值 + 贈送），並在餘額旁給出狀態標記。未登錄時不顯示。
與「偶爾打開賬單頁查餘額」相比，它把餘額固定在 Harness 界面內，並與任務生命週期、頁面可見性掛鉤刷新，適合長期在 DSH 裏調試智能體、反覆提交任務的開發者。
核心功能¶
展示位置與形態¶
- 餘額行位於側欄底部，緊挨賬號頭像上方。
- 一行全寬顯示餘額；旁邊有狀態標記：總額低於閾值時爲琥珀色 ⚠，達到或高於閾值時爲綠色 ✓。
- 鼠標懸停可查看餘額明細（breakdown）。
- 側欄收起時，改爲圓形錢包按鈕，不佔全寬行。
可配置閾值¶
- 默認閾值爲 20（單位與 DeepSeek 賬戶餘額一致，以官方展示爲準）。
- 點擊狀態標記可修改閾值；數值保存在本地（瀏覽器側），不會上傳到插件倉庫以外的未知服務端——具體存儲方式以實現爲準，安裝前建議閱讀
client.js等源碼。
餘額刷新時機¶
README 列出的刷新策略如下：
- 頁面加載時
- 任意任務結束後約 3 秒
- 頁面處於可見狀態時，每 2 分鐘 一次
- 窗口重新獲得焦點時
- 點擊界面上的 ⟳ 刷新時
餘額爲賬戶級，同一 DeepSeek 賬號下的各會話共享同一餘額數據（由 DeepSeek 賬戶 API 決定，插件負責拉取與展示）。
安裝與啓用¶
環境要求（來自 README）：
- DeepSeek Harness 0.2.1-rc.3 及以上
- 已登錄 DeepSeek 賬戶
在 DSH 中：Settings → Plugins → Install，填入下列標識（須與官方 README 一致，不要自行改寫爲 CLI 子命令）：
github:adrian-atlas/dsh-avatar-balance
安裝完成後，客戶端插件會按 package.json 中 dsh.client.immediately: true 在 Web 端加載；具體補丁見倉庫中的 cordis.patch.yml。
典型用法¶
- 完成安裝並登錄 DeepSeek 賬號後，打開 Harness Web 界面，側欄底部應出現餘額行與狀態標記。
- 若標記爲琥珀色，表示「充值 + 贈送」總額低於當前閾值；點擊標記，在面板中調整閾值（默認 20），保存於本地。
- 跑完一次 DSH 任務後等待約 3 秒，觀察餘額是否更新；也可切換窗口焦點或點擊 ⟳ 手動觸發刷新。
- 收起側欄時，通過圓形錢包按鈕仍可訪問餘額相關入口（具體交互以當前版本 UI 爲準）。
倉庫 README 提供 assets/balance-ok.webp、balance-low.webp、threshold.webp 等截圖，可在 GitHub 頁面覈對視覺效果。
適用場景與注意¶
適合誰
- 經常在 DSH 裏提交任務、希望不用離開界面就能盯餘額的開發者。
- 需要自定義「低餘額」提醒線（本地閾值）的用戶。
務必注意
- DSH 生態是「一切皆插件」；SkillHub 目錄頁 爲社區收錄站點，與 DeepSeek、幻方無官方從屬關係，本文介紹不代表官方背書。
- 插件在當前 DSH 進程 / 瀏覽器上下文中運行，會代表已登錄用戶請求賬戶餘額相關接口；安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認行爲符合你的安全策略。
- 閾值與展示樣式依賴插件版本；升級 DSH 或插件後若異常，可對照
engines.dsh（>=0.2.1-rc.3）與 Release 說明。
結尾¶
dsh-avatar-balance 把 DeepSeek 賬戶餘額和閾值狀態放進側欄頭像旁，並在任務結束、定時、聚焦等時機刷新，減少「任務跑着跑着才發現沒錢」的情況。
