前言¶
在 DeepSeek Harness（DSH）裏寫提示、選模型時，賬戶裏還剩多少錢、當前算不算高峯價，往往要另開頁面或去平臺查。高峯與低谷價差可達一半，批量跑任務時若不清楚時段，成本不好預估。dsh-balance 是社區客戶端插件，把餘額和 DeepSeek 峯谷計費狀態放進輸入框工具行，與模型選擇器並排，減少來回切換。
下面介紹插件定位、能力、安裝條件與注意點。插件以你當前 DSH profile 的進程權限運行，安裝前建議瀏覽源碼與 MIT 許可證；DSH 社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
@cy2s1ne/dsh-balance（npm 包名，GitHub 倉庫 Cy2s1ne/dsh-balance）由維護者 Cy2s1ne 發佈，分類爲客戶端插件。當前 package.json 版本爲 0.2.0，要求 DSH >=0.2.0-rc.1、Node >=20.0.0。
一句話：在輸入框工具行（模型選擇器旁）實時顯示 DeepSeek 賬戶餘額與當前峯谷計費時段；點擊可展開明細。數據來自 DSH 內置 deepseekAccount 服務，不在瀏覽器裏直接持憑證訪問平臺。
核心功能¶
工具行膠囊¶
膠囊上顯示主錢包餘額（人民幣優先）。左側狀態燈表示 DeepSeek 當前峯谷計費時段（不是餘額查詢是否成功）：
| 顏色 | 含義 |
|---|---|
| 綠色 | 低谷價（高峯價的 5 折） |
| 琥珀 | 高峯價（標準價） |
膠囊內另有「低谷 / 高峯」文字標籤。懸停或展開面板可看當前時段、下次切換時間與倒計時。
峯谷規則自 2026-08-17 起按 DeepSeek 官方價目表 判定，時區固定 UTC+8，不隨瀏覽器時區變化：
- 高峯：北京時間週一至週五（不含中國法定節假日）9:00–12:00、14:00–18:00
- 低谷：其餘時段（含週末、調休上班的週末、法定節假日全天）
節假日表內置在 client.js 的 HOLIDAY_RANGES，已覆蓋 2026–2027；未覆蓋年份僅按工作日 + 時段判斷，週末仍按低谷處理。
餘額查詢失敗時，狀態燈外圈會出現紅色描邊，峯谷底色仍保留，兩種信號互不覆蓋。
明細麪板¶
點擊膠囊展開：
- 當前計費時段、下次切換時間與倒計時
- 充值餘額（各幣種）
- 贈送額度（若平臺有下發）
- 用量明細 / 去充值入口
- 最近更新時間
刷新策略：每 20 秒自動刷新；標籤頁重新可見時立即補一次；打開面板時強制刷新。未登錄、服務缺失、查詢失敗會降級爲可讀提示，不會讓輸入框報錯。
數據鏈路與安全¶
瀏覽器不直接訪問 DeepSeek 平臺接口，憑證只在宿主側：
瀏覽器餘額膠囊
└─ GET /api/dsh-balance （本插件宿主端註冊的只讀路由，僅迴環可訪問）
└─ ctx.deepseekAccount.getState() / getBalance()
└─ DeepSeek 平臺賬戶接口
宿主端 15 秒緩存與單飛合併，上游查詢 10 秒超時。接口只讀、響應不含 token；僅接受迴環地址（127.0.0.1 / ::1）請求，未走 DSH 令牌鑑權，姿態與同類插件（如 dsh-mcp-manager）一致。
前置條件¶
插件讀取 DSH 內置 deepseekAccount 服務，必須在 DSH 中 登錄 DeepSeek 賬號（平臺會話）。
只配置 DEEPSEEK_API_KEY、未在 DSH 裏登錄賬號時，膠囊會顯示「餘額未登錄」——這是預期行爲，不是故障。
安裝與啓用¶
將 <你的profile名> 換成實際 profile。
從 GitHub 安裝（推薦）¶
dsh plugin --profile <你的profile名> add github:Cy2s1ne/dsh-balance
從 npm 安裝¶
dsh plugin --profile <你的profile名> add @cy2s1ne/dsh-balance
本地源碼安裝（開發）¶
link: 會把目錄軟鏈進 profile，源碼改動立即生效：
dsh plugin --profile <你的profile名> add link:/絕對路徑/dsh-balance
安裝後刷新瀏覽器頁面即可看到膠囊。首次加載餘額可能短暫延遲，膠囊會先顯示「餘額 …」。
卸載：
dsh plugin --profile <你的profile名> remove @cy2s1ne/dsh-balance
典型用法¶
日常使用無需額外配置：登錄 DeepSeek 賬號並安裝插件後，在輸入框工具行觀察膠囊顏色與餘額即可。需要明細、充值或用量時點擊膠囊展開面板；利用綠色低谷時段安排大批量調用，可對照官方價目表與面板上的切換倒計時。
維護者本地驗證峯谷邏輯可執行：
npm test
測試從 client.js 的 pricing 區域提取規則，覆蓋工作日、週末、節假日邊界與下次切換點，不依賴瀏覽器或餘額接口。
適用場景與注意¶
適合：長期在 DSH Web 客戶端寫提示、調模型，希望成本和峯谷時段一眼可見的用戶；已使用 DSH 平臺賬號登錄、而非僅 API Key 的場景。
注意：
- 插件隨當前 DSH 進程運行，安裝前請自行審閱 倉庫源碼 與 MIT 許可。
- 餘額查詢爲外部網絡請求，受緩存與超時策略影響。
- 若需收緊
/api/dsh-balance訪問方式，可按 README 說明改爲經ctx.connection.authenticatedUrl訪問（屬進階改造）。
結尾¶
dsh-balance 把賬戶餘額與峯谷計費時段收進輸入框工具行，依賴 DSH 已有登錄態，通過宿主只讀路由查詢，並在失敗時友好降級。目錄與詳情見 SkillHub 插件頁，源碼與 README 見 GitHub。
