前言¶
DeepSeek Harness (DSH) 作爲一個開放的插件生態，允許用戶根據需求擴展功能。在頻繁調用大模型進行開發或測試時，實時掌握賬戶餘額以及 DeepSeek 官方的峯谷計費規則（尤其是 2026 年起實施的週末全天低谷規則）非常必要。dsh-valley-meter 專注於解決這一痛點，它不依賴其他插件，直接在 DSH Web 界面的輸入框上方提供餘額查詢與峯谷時間軸可視化。
這是什麼¶
dsh-valley-meter 是一個客戶端插件，由用戶 uckkk 開發。它通過在輸入框上方掛載一個餘額數字徽章，並在懸停時展示 24 小時峯谷時間軸，幫助開發者直觀地監控費用消耗。該插件獨立查詢官方餘額、獨立監聽實時計費，並維護本地賬本。
核心功能¶
餘額數字徽章
默認情況下，輸入框右上角顯示一枚極簡的餘額數字徽章，僅包含人民幣符號「¥」和當前數值。官方餘額通過插件獨立查詢，每 5 秒自動刷新一次。
一鍵充值
點擊徽章中的「¥」符號，會在新頁籤中打開 DeepSeek 官方充值頁面。該入口設計爲懸浮於徽章左側，與徽章左端圓角重合，方便快速充值。
懸停時間軸
當光標懸停在餘額徽章上時，左側會浮現一條 24 小時橫向時間軸。時間軸使用峯/谷雙色區分時段（峯爲橙色，谷爲藍色），頂部刻度包含 00/06/12/18/24。一條白色發光指針指示當前本地時刻。若當天爲週末，整條時間軸將顯示爲谷色。
獨立計費
插件完全獨立運行，不依賴其他插件。
* 今日消耗：監聽 llm/stream 事件捕獲每次調用的用量，按內置模型價格表（含峯/谷兩檔）折算費用，並寫入本地賬本 ~/.dsh/storages/valley-meter/ledger.json。
* 賬戶餘額：使用 DSH 憑據庫或環境變量 DEEPSEEK_API_KEY 查詢 DeepSeek 官方 /user/balance 接口。
週末全天低谷規則
根據官方規定，自 2026-08-23 00:00 起，週六、週日全天不再區分峯谷，統一按低谷價計費。插件按北京時間判斷週末，當天整條時間軸顯示爲谷色，計費自動走低谷價。
配色方案
內置 10 套沉穩配色預置（包括 One Dark、Dracula、Nord 等編輯器主題及中國傳統色、潘通色），支持通過拾色器自定義峯谷顏色，配置即時生效。
安裝與啓用¶
使用 npm 安裝：
npm install dsh-valley-meter
安裝完成後，重啓 dsh web 頁面即可在輸入框上方看到餘額數字徽章。
進入 設置 → 峯谷電錶 面板，可以進行配色調整、開關餘額/花費標題、開啓或關閉週末全天低谷規則等配置。
典型用法¶
- 打開 dsh web 頁面，輸入框上方會出現餘額數字徽章。
- 將鼠標懸停在餘額徽章上，查看 24 小時峯谷時間軸及當前時刻指針。
- 點擊徽章中的「¥」符號，在新頁籤中打開官方充值頁面。
- 觀察時間軸顏色判斷當前是否處於峯時或谷時，或是否爲週末全天低谷。
注意事項¶
- 獨立運行：該插件獨立計費與查詢，不依賴其它插件。
- 網絡權限：插件需要網絡權限訪問
https://api.deepseek.com以查詢餘額和進行計費。 - API Key 配置：如果未配置 API Key，餘額顯示爲「暫無數據」，但今日消耗仍會正常累計。
- 兼容性：需安裝 DeepSeek Harness 版本
>=0.1.0-rc.5。
總結¶
dsh-valley-meter 是一款功能單一但聚焦的工具，它通過數字徽章和懸停時間軸，將複雜的峯谷計費規則和餘額查詢變得直觀。對於需要精細控制使用成本的開發者，這是一個實用的輔助插件。
插件目錄與源碼：dsh-valley-meter
