前言¶

用 DeepSeek API 做開發時，有三個問題經常需要停下來確認：賬戶還剩多少錢、現在是不是半價時段、剛纔那次調用扣了多少。餘額要靠接口單獨查詢，峯谷計價又讓成本隨時段浮動，純靠切換頁面和心算並不現實。

DSH 的 Web 界面右下角有鯨魚掛件可以看餘額（數據與官方接口同源），但如果你希望在寫代碼的同時，把雙幣種餘額、峯谷狀態和每次扣款都放在視線裏，deepseek-balance-banner 把這些做成了頁面頂部的一條橫幅。下面介紹它的功能、安裝和日常使用。

這是什麼¶

deepseek-balance-banner 是 DeepSeek Harness（DSH）Web 界面的一個社區插件，作者是 iskshadow195563，採用 MIT 許可證。它是一個標準的 DSH bundle 包，安裝後在頁面頂部右側、主題切換（白晝/夜間）按鈕的左側，同時顯示 USD 與 CNY 兩個餘額膠囊，負值高亮，每 60 秒自動刷新。

插件由社區獨立開發，與 DeepSeek 官方無隸屬關係。

核心功能¶

雙幣種餘額與負值高亮¶

插件調用官方 GET /user/balance，解析返回的全部 balance_infos，USD 與 CNY 各渲染一個膠囊。任一幣種餘額小於 0 時以警告色高亮，欠費一眼可見。

扣款與充值動畫¶

檢測到扣款時，從餘額膠囊旁彈出紅色遊戲化扣血飄字（如 -¥0.03），上浮、放大、漸隱；充值或入賬時彈出綠色正向飄字（如 +¥0.05）。懸停橫幅可以查看本次頁面會話的扣款總額與充值總額。

峯谷時段識別¶

徽章即時顯示當前處於高峯（標準價）還是低谷（半價），並附當前北京時間；週六、週日全天自動顯示爲低谷價。時段規則依據 DeepSeek 官方 2026-08-23 生效的計價規則。

刷新機制¶

每 60 秒自動刷新；點擊任意膠囊可以立即手動刷新。宿主側另有 25 秒 TTL 緩存，避免請求過於頻繁地打到官方接口。

演示模式與主題適配¶

樣式使用 DSH 主題變量（--dsw-*），深色、淺色皮膚均協調。頁面 URL 加 ?dsb-demo=1 會循環播放扣血/充值動畫，用於開發或預覽。

安裝與啓用¶

前置條件¶

1、dsh >= 0.1.0-rc.6，推薦 0.1.1-rc.2+；
2、已在 DSH 憑據中配置 DEEPSEEK_API_KEY（用於請求 GET https://api.deepseek.com/user/balance）；
3、存在 Web Profile 目錄 $DSH_HOME/profiles/web/（Windows 默認 %USERPROFILE%\.dsh\profiles\web\）。

一條命令安裝¶

# 從 npm 安裝
dsh plugin --profile web add deepseek-balance-banner

# 或從 GitHub 直裝（不需要 npm 賬號）
dsh plugin --profile web add github:iskshadow195563/DeepSeek_Harness_Balance_Banner#v1.0.0

--profile 爲必填參數，web 是默認的 Web 界面 profile，如果使用其他 profile 名請替換。安裝完成後插件加入該 Profile 的 bundle 層，重啓 dsh web 並 F5 刷新頁面即可生效。

手動安裝¶

不想走包管理時，可以把 deepseek-balance-banner.mjs 放進 Web profile 目錄：

# macOS / Linux
cp deepseek-balance-banner.mjs "${DSH_HOME:-$HOME/.dsh}/profiles/web/"

# Windows PowerShell
Copy-Item deepseek-balance-banner.mjs "$env:USERPROFILE\.dsh\profiles\web\"

再編輯同目錄的 cordis.patch.yml，追加 insert 條目：

- insert:
    - id: deepseek-balance-banner
      name: ./deepseek-balance-banner.mjs?v=1

?v=1 用於破瀏覽器 ESM 緩存，插件升級時把數字加一。保存後通常熱生效，若 5 秒內沒反應，重啓 dsh web 並 F5 刷新頁面。

注意：同一插件不要以包形態和文件形態重複安裝。卸載包形態使用：

dsh plugin --profile web remove deepseek-balance-banner

文件形態安裝則刪除 .mjs 文件，並移除 cordis.patch.yml 中對應的 insert 兩行，刷新頁面。

日常使用與排查¶

• 查看餘額：頂部右側膠囊同時顯示 ¥ 人民幣與 $ USD，負值以警告色高亮；
• 手動刷新：點擊任意膠囊，或等 60 秒自動刷新；
• 數據來源：官方 GET /user/balance，與 DSH 右下角鯨魚掛件同源；
• 演示模式：頁面 URL 加 ?dsb-demo=1。

兩種常見情況：膠囊一直顯示 — 或加載中，先檢查 DEEPSEEK_API_KEY 是否已在 DSH 憑據中配置；只顯示一個幣種，通常是你的賬號只返回了一種幣種。

工作原理與安全設計¶

數據鏈路如下：

瀏覽器頁面 ──(同源 fetch)──> 本機 dsh web(/dsb-balance.json)
                                    │ ctx.credentials 解析 DEEPSEEK_API_KEY(不落頁面)
                                    ▼
                     https://api.deepseek.com/user/balance  (balance_infos: USD + CNY)

宿主插件把餘額端點掛在本機 dsh web 上，頁面腳本以 60 秒輪詢訪問，宿主側用 25 秒 TTL 緩存合併請求。整個流程是隻讀的，沒有任何寫操作；插件本身不包含密鑰，DEEPSEEK_API_KEY 由 DSH 憑據服務在宿主進程內解析，頁面只與本機 dsh web 同源通信，不跨域、不落 Key。

適用場景與注意事項¶

插件適合長期開着 DSH Web 界面、希望隨時掌握餘額、峯谷價和單次扣款的使用者。安裝前有幾點建議：

1、插件以當前 dsh 進程的權限運行，安裝前先閱讀源碼倉庫，確認代碼行爲符合預期；
2、確認許可證（本項目爲 MIT）與你的使用方式一致；
3、如果你自行維護插件版本，每次發佈記得把安裝補丁裏的 ?v= 數字加一，避免瀏覽器緩存舊腳本。

小結¶

deepseek-balance-banner 把餘額查詢、峯谷計價提示和扣款反饋壓縮成頁面頂部的一條橫幅，是 DSH「一切皆插件」思路下一個典型的小而完整的能力補充。項目主頁與社區目錄如下：

• GitHub：https://github.com/iskshadow195563/DeepSeek_Harness_Balance_Banner
• 社區插件目錄：https://www.skillhub.cn/plugins/iskshadow195563/DeepSeek_Harness_Balance_Banner （社區獨立站點，與 DeepSeek / 幻方無官方從屬關係）