前言¶
DeepSeek Harness（命令名 dsh）是 DeepSeek AI 開源的智能體運行時，目前仍是開發者預覽。它的核心理念是「一切皆插件」：模型、工具、技能、會話、沙箱和界面都可以用插件替換或組合。社區裏還有一份獨立的插件目錄站點 deepseek-harness-plugin.com，它和 DeepSeek / 幻方沒有官方從屬關係，收錄的是帶 dsh-plugin 話題的社區倉庫。
日常用網頁界面跑 DeepSeek 模型時，餘額往往要另開平臺頁面才能看到。2026-08-17 起，官方 API 又按北京時間引入峯谷定價：高峯時段（9:00–12:00、14:00–18:00）價格是空閒時段的兩倍。會話還在進行，計費檔位已經切過去了，如果界面上沒有任何提示，只能事後對賬單。
crazywoola 維護的 dsh-balance 把這件事收進 Harness 自己的設置頁和聊天框下方：用本機已經保存的 API Key，查詢官方餘額和當前可用模型。密鑰只在 Host 側使用，不會發到瀏覽器。
本文按插件目錄頁、GitHub 倉庫 README / package.json / 源碼、npm 包頁，以及 DeepSeek 官方餘額接口與定價文檔交叉覈對後整理。GitHub 上還有 deepforce/dsh-balance、LemCAE/dsh-balance 等近名倉庫，功能和安裝命令都不相同；本文只寫 crazywoola/dsh-balance。
這是什麼¶
dsh-balance 是一款面向 DeepSeek Harness Web UI 的「工具與能力」插件，由 crazywoola 維護，倉庫地址是 crazywoola/dsh-balance。npm 包名是 @pinkbanana/dsh-balance，當前版本 0.4.1（2026-08-17 發佈）。許可證 MIT，主要語言 TypeScript，要求 Node.js ≥ 20。GitHub 倉庫創建於 2026-08-14。截至 2026-08-17，GitHub 顯示 19 顆星；目錄頁當時仍標註 14 顆，星標以倉庫頁面爲準。
目錄頁的短簡介是「設置頁的 DeepSeek 餘額插件」。倉庫 README 寫得更完整：查詢 API 餘額和當前可用模型；API Key 僅由本機 Host 使用，不會發送到瀏覽器。package.json 裏的 dsh.client.platform 爲 web，客戶端會注入設置頁和會話輸入框下方的槽位。
它解決的問題很具體：不必離開 Harness 去打開 DeepSeek 平臺，就能看到總餘額、充值餘額、贈送餘額，以及當前密鑰能調哪些模型；聊天框下方再掛一條摘要，高峯時段用橙色指示燈提醒。
核心功能¶
設置頁裏的餘額和模型¶
安裝後，設置側欄會出現「DeepSeek 餘額」入口，源碼裏把它掛在 settings.section 槽位，order 爲 21，README 說明該入口位於「Agent 預設」下方。頁面分兩塊：
- DeepSeek API 餘額：按幣種展示總餘額、充值餘額、贈送餘額，以及賬戶是否還有可用餘額。數據來自官方
GET /user/balance。DeepSeek 文檔裏該接口會返回is_available，以及balance_infos中的currency（CNY/USD）、total_balance、granted_balance、topped_up_balance。 - DeepSeek 可用模型：列出當前 API Key 能訪問的模型 id 與提供方。數據來自官方
GET /models。
兩塊都有手動刷新按鈕。Host 默認把結果緩存 30 秒；刷新時客戶端會帶上 ?refresh=1，跳過緩存再查一次。頁面會標明更新時間，緩存命中時附帶「緩存」字樣。
聊天框下方的餘額摘要¶
客戶端還往 conversation.composer.dock 注入一條緊湊摘要，顯示在已有會話的輸入框下方。摘要按幣種拼接總餘額，例如 CNY … · USD …。源碼裏這條摘要每 60 秒 自動再查一次（走緩存，不會每次都打到 DeepSeek）。
2026-08-17 北京時間 00:00 起，官方峯谷定價生效。插件在高峯時段把這條摘要的指示燈改成橙色，並標出「高峯時段」或「低谷時段」。源碼把高峯窗口寫成左閉右開：北京時間 [09:00, 12:00) 與 [14:00, 18:00)，其餘爲空閒；每 30 秒重算一次當前時段，並提示下一次切換時間。官方定價頁寫的是「高峯時段爲北京時間 9:00 - 12:00、14:00 - 18:00，空閒時段價格爲高峯時段的一半」，和插件採用的窗口一致。
這項能力只做檔位提示，不估算本會話已經花了多少錢，也不改模型路由。
密鑰留在 Host，瀏覽器只拿結果¶
插件分成 Host 和 Web 客戶端兩半：
- Host 注入
webServer和credentials，註冊兩條本機路由：/dsh-balance/api/balance、/dsh-balance/api/models。查詢時通過憑證服務解析DEEPSEEK_API_KEY（可改配置項apiKeyRef），用 Bearer 調用https://api.deepseek.com。默認超時 10 秒。 - 瀏覽器只請求上述同源路由，拿到已經去掉密鑰的 JSON。README 和設置頁文案都寫明：密鑰不會發送到瀏覽器。
默認配置裏 allowRemote 爲 false：非本機迴環地址訪問這兩條路由會得到 403。baseUrl 必須是 HTTPS；只有指向 localhost / 127.0.0.1 / ::1 的 HTTP 才被接受，方便本地測試。
未配置密鑰時，Host 返回 401，界面提示先到「設置 → 模型」保存 DeepSeek API 密鑰。密鑰無效、限流、超時、上游不可用，都會映射成界面上的對應錯誤文案，響應裏不帶回上游原文或憑證。
中英文跟隨系統語言¶
界面文案內置簡體中文和英文，並註冊到 Harness 的 locale 命名空間 dsh-balance，跟隨系統語言切換。導航名在中文環境下是「DeepSeek 餘額」，英文是 “DeepSeek Balance”。
安裝與啓用¶
目錄頁給出的安裝命令是：
dsh plugin add github:crazywoola/dsh-balance
如需可復現安裝，目錄頁要求固定 commit 哈希：
dsh plugin add github:crazywoola/dsh-balance#commit
把 commit 換成倉庫裏實際的提交哈希。插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前請檢查源代碼倉庫和許可證。
這個插件聲明瞭 Web 客戶端，倉庫 README 推薦寫到 web profile，並從 npm 安裝當前版本：
dsh plugin --profile web add @pinkbanana/dsh-balance@latest
dsh --profile web
dsh --profile web 會啓動網頁界面，官方倉庫說明默認地址是 http://127.0.0.1:3080。裝完後打開 Web UI，進入「設置 → DeepSeek 餘額」。API Key 可在「設置 → 模型」中保存，或通過環境變量 DEEPSEEK_API_KEY 提供。
兩條安裝路徑指向同一份倉庫：GitHub 源是 crazywoola/dsh-balance，發佈到 npm 時包名是 @pinkbanana/dsh-balance。不要把目錄裏的 github:crazywoola/dsh-balance 改成其他同名倉庫。
典型用法¶
- 確認本機已經能打開 DeepSeek Harness 的 Web UI，並且在「設置 → 模型」裏保存了可用的 DeepSeek API Key，或導出了
DEEPSEEK_API_KEY。 - 按上一節安裝插件，並用 web profile 啓動。
- 打開「設置 → DeepSeek 餘額」。第一次進入會看到「查詢中…」，隨後出現總餘額、充值餘額、贈送餘額，以及當前密鑰可用的模型列表。
- 需要最新數字時點「刷新余額」或「刷新模型」。默認 30 秒內的重複查詢會命中 Host 緩存。
- 回到已有會話，輸入框下方應出現「DeepSeek 餘額」摘要。高峯時段指示燈爲橙色，並提示何時回到低谷價；空閒時段則提示下一次進入高峯的時間。
Host 側還可以改這些配置（均來自倉庫 src/index.ts 的 Config，不是文檔裏的口頭約定）：
| 配置項 | 默認值 | 含義 |
|---|---|---|
apiKeyRef |
DEEPSEEK_API_KEY |
憑證服務裏的密鑰引用名 |
baseUrl |
https://api.deepseek.com |
DeepSeek API 根地址 |
timeoutMs |
10000 |
上游請求超時，範圍 1–60000 |
cacheMs |
30000 |
餘額和模型列表的緩存時間，範圍 0–300000 |
allowRemote |
false |
是否允許非本機訪問查詢路由 |
沒有特殊需求時保持默認即可。尤其不要在不瞭解暴露面的情況下把 allowRemote 打開。
適用場景與注意事項¶
適合已經在 DeepSeek Harness Web UI 裏使用官方 DeepSeek API、希望把餘額和模型列表留在本機界面上的開發者。高峯 / 空閒切換頻繁的白天，聊天框下方的橙色指示燈比事後對賬單更及時。
下面這些邊界需要事先清楚：
- 只覆蓋 Web UI。
package.json把客戶端平臺標成web，終端 TUI 或其他 profile 不會出現設置頁和輸入框摘要。 - 不是賬單或會話成本面板。 它查詢賬戶餘額和
/models列表，不統計本次會話的 token，也不按單價估算花費。社區裏其他近名插件可能帶/balance斜槓命令或會話費用，那不是這一份。 - 依賴已保存的官方密鑰。 沒有
DEEPSEEK_API_KEY，或密鑰無效，界面只會提示去「模型」設置裏保存，不會替你登錄 DeepSeek 平臺。 - 默認只服務本機。 Host 路由拒絕非迴環請求。把 Harness 暴露到局域網或公網時，不要指望瀏覽器隔着另一臺機器直接查餘額。
- 峯谷提示跟官方窗口走。 官方保留改價權利。插件把生效起點寫死爲 2026-08-17 00:00（北京時間）；若官方以後調整時段，需要看倉庫是否同步更新
src/client/pricing.ts。 - 插件以當前 dsh 進程權限運行。 安裝時可能執行代碼。安裝前檢查 GitHub 源碼和 MIT 許可證；生產環境用目錄頁寫的
#commit固定版本。DeepSeek Harness 仍是開發者預覽，官方 README 標明會有破壞性變更。
小結¶
dsh-balance 把官方 GET /user/balance 和 GET /models 接到 DeepSeek Harness 的設置頁，並在聊天框下方留一條餘額摘要。密鑰只在本機 Host 使用；2026-08-17 起的峯谷時段會把摘要指示燈打成橙色。它不替代平臺賬單，也不估算單次會話花費，但能減少「開着 Harness 卻不知道還剩多少餘額、現在是不是高峯價」這類往返。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-balance/
GitHub：https://github.com/crazywoola/dsh-balance
