前言¶
在 DSH Web 裏跑智能體或對話時，賬戶餘額、當月用量和 DeepSeek 峯谷時段往往要另開頁面或翻設置才能看清。DeepSeek 按北京時間區分峯時與谷時，切換點又和法定節假日有關，單靠記憶容易誤判當前計價區間。下面介紹 maintainer lamp23333 維護的 dsh-balance-simple：一塊常駐側邊欄的狀態牌，把餘額、用量、費用、緩存命中率與峯谷倒計時放在同一處，摺疊側邊欄後仍保留最關鍵數字。
這是什麼¶
dsh-balance-simple（npm 包名 dsh-balance-simple，當前版本 1.0.2，MIT 許可證）是面向 DSH Web 的插件：在賬戶頭像上方渲染 DeepSeek 賬戶狀態卡片，不堆報表，只保留會頻繁查看的指標。它只支持 DeepSeek 賬戶級數據；OpenAI、Anthropic、OpenRouter 等其它供應商不在支持範圍內，同一 DeepSeek 賬戶下其它模型會自然聚合進用量統計。
源碼與說明見 GitHub：lamp23333/dsh-balance-simple；社區目錄頁：skillhub.cn 插件頁。DSH 生態強調「一切皆插件」；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
設計與信息佈局¶
插件強調三塊原則（來自項目 README）：
- 簡約：無報表式堆疊；摺疊態壓縮爲約 44px 高的狀態塊。
- 直觀：餘額爲視覺中心；峯時 / 谷時用顏色區分；倒計時直接回答「何時切換」。
- 信息集中：餘額、月度 token、費用、緩存命中率、請求數與峯谷狀態在同一張卡片內讀完，無需打開設置頁。
展開時以當前餘額爲主，月度 token、費用及構成放在次級位置；側邊欄收起時仍顯示摺疊餘額塊、當前峯 / 谷狀態與切換倒計時。
核心功能¶
賬戶數據與刷新¶
- 餘額、用量等每 30 秒輪詢；窗口重新聚焦或恢復可見時會刷新；展開卡片支持手動刷新。
- 插件複用 DSH 已保存的 DeepSeek 賬戶授權，不需要額外填寫 API Key。瀏覽器僅訪問 DSH 同源的
/dsh-deepseek-usage/*接口；DeepSeek 授權 token 留在 Host，不返回瀏覽器。Host 側會訪問platform.deepseek.com讀取餘額、用量與費用。
峯谷規則與校時¶
峯谷規則按 北京時間 與 DeepSeek 官方定價一致（詳見 pricing 文檔）：
- 峯時：週一至週五 09:00–12:00、14:00–18:00（對應官方 UTC 01:00–04:00 與 06:00–10:00）。
- 谷時：其餘時段、週末，以及 中國法定節假日（官方規則只排除中國法定假日，不參考其它國家假日）。
- 週末即使調休上班，插件仍按 谷時 處理，因官方規則僅按「週一至週五 + 中國法定節假日」判斷。
節假日數據優先 jiejiariapi，失敗回退 GitHub holiday-cn；未來年份暫無官方日曆時回退內置表。授時按設備時區選擇區域 NTP（阿里雲、騰訊、NIST、Cloudflare、pool.ntp.org），失敗回退 timeapi.io。
安裝與啓用¶
前提：已具備 DSH Web 界面，且已登錄 DeepSeek 賬戶。
上架 dshmarket 後可從市場直接安裝。上架前可手動安裝，命令以 README 爲準：
# npm 發佈後
dsh plugin --profile web add dsh-balance-simple
# 或直接從 GitHub 安裝
dsh plugin --profile web add git+https://github.com/lamp23333/dsh-balance-simple
安裝完成後刷新 DSH Web 頁面即可看到側邊欄狀態牌。
典型用法¶
安裝並刷新頁面後，無需單獨配置文件：卡片自動出現在側邊欄賬戶頭像上方。
- 日常盯盤：側邊欄展開時查看餘額、當月 token、費用、緩存命中率與請求數。
- 窄欄模式：摺疊側邊欄後仍看 44px 餘額塊、峯 / 谷標識與切換倒計時。
- 即時更新：需要立刻對齊平臺數據時，在展開卡片上使用手動刷新；平時依賴 30 秒輪詢與窗口聚焦刷新。
外部網絡請求除 DeepSeek 平臺外，僅用於節假日 API 與 NTP / 時間 API，用途在 README「數據與隱私」一節有完整列舉。
適用場景與注意¶
適合：長期在 DSH Web 中使用 DeepSeek 賬戶、需要一眼看到餘額與峯谷切換時間的開發者或運維式使用者。
注意：
- 插件以當前 DSH 進程權限運行；安裝前建議閱讀 源碼倉庫 與 MIT 許可證，確認行爲符合你的環境策略。
- 僅 DeepSeek 賬戶數據；勿期望展示其它 LLM 供應商餘額。
- 峯谷與節假日邏輯與官方文檔對齊，但遠程 API 或 NTP 失敗時會走回退路徑，極端情況下切換時刻展示可能短暫依賴內置表或備用時間源。
項目無需構建步驟，源碼即發佈產物；維護者修改後至少執行 node --check index.js、node --check client.js 與 npm pack --dry-run 做基本檢查。主要文件爲 Host 端 index.js、Web 客戶端 client.js 與 DSH bundle 入口 cordis.patch.yml。
結尾¶
dsh-balance-simple 把 DeepSeek 餘額、月度用量和峯谷倒計時收進 DSH Web 側邊欄，摺疊後仍保留關鍵狀態，適合不想反覆打開設置頁的使用方式。
