前言¶
DeepSeek Harness (DSH) 的插件生態旨在通過模塊化擴展提升終端交互體驗。在 dsh-TUI 中，用戶常需要實時監控賬戶餘額、區分峯谷計費時段以及追蹤 Token 消耗。dsh-peak-balance 插件解決了這些問題，它將峯谷時鐘、實時餘額、單輪成本以及一個 GitHub 風格的 Token 歷史網格集成在狀態欄與全屏視圖中，由 VviLliAm-qwq 維護。
核心功能¶
該插件在 dsh-TUI 中提供以下能力：
- 峯/谷計費時鐘：顯示當前生效的計費窗口（如工作日 09:00-12:00）及距離下一個計費時段的倒計時。週末全天爲非峯時。
- 提供商中立讀數：讀取當前對話實際使用的提供商餘額（如官方餘額、訂閱額度、中繼信用池）。如果提供商無讀數接口，則不顯示數值。對於自動路由的會話，它會嘗試讀取已保存的
/model路由信息。 - 單輪成本測量：顯示上一輪對話的消耗。如果提供商提供計數器（如命令代碼積分、OpenRouter 用量），則直接測量；否則從費率卡估算；若無費率則顯示未評級。
- 配額診斷：執行
/quota命令可查看讀取狀態、適配器響應、失敗原因及所有可探測的提供商路由。可使用/quota check <provider>單獨檢查。 - 峯時警告：當處於峯時窗口時，狀態欄可切換爲帶脈衝邊框和波形動畫的三行警告框，支持七種顏色。
- 歷史網格 (
/hist)：全屏展示 GitHub 風格的貢獻圖，每個方塊代表一天，顏色深淺代表使用量。支持鍵盤導航。 - 總計與模型統計：顯示所有歷史數據的總計（Token、預估成本、緩存命中率等）及按模型的細分統計。
- 自定義費率 (
/th price)：爲未列出的模型設置費率，否則顯示未評級標記。 - 語言跟隨：狀態行、歷史場景和命令回覆會隨 TUI 的
/lang設置即時切換語言。 - 設置子頁面：在
/settings的“Peak & Balance”卡片下提供“Token history”子頁面，包含十個選項。
安裝與啓用¶
使用 npm 安裝：
dsh plugin --profile dsh-tui add dsh-peak-balance
或直接從本地倉庫安裝：
dsh plugin --profile dsh-tui add file:/absolute/path/to/dsh-peak-balance
安裝命令會將插件行追加到 dsh.profile.bundles。安裝後，需在 dsh-TUI 中執行 /restart 以加載新插件，設置卡片隨即出現在 /settings 下。
典型用法¶
狀態欄顯示示例：
⚡ 峯時 09:00-12:00 · 距谷時 1h23m · 本輪 ¥0.0234 · 餘額 ¥42.10
進入歷史網格：
* 快捷鍵：/hist（或 /tokenhistory、alt+h、/th 後加空格）。
* 導航：←/→ 切換日期，↑/↓ 切換週數，m 切換指標，w 切換跨度，s 切換子代理，r 重新掃描，q 或 Esc 關閉。
* 自定義費率：/th price 後接模型名稱和價格。
檢查配額：
/quota check <provider>
注意事項¶
- 安裝方式：不推薦使用符號鏈接（
link:協議或目錄連接點）安裝。Node.js 會解析插件的真實路徑，且@deepseek-ai/*依賴必須保持可訪問。file:和 npm 安裝會在配置目錄中保留真實目錄副本，這是宿主預期的佈局。 - 更新文件：如果通過
file:安裝，直接運行add或update不會拾取本地源碼的修改。必須先移除插件，再重新添加。 - 重啓要求：安裝或移除後，必須重啓 TUI 才能生效。
結語¶
dsh-peak-balance 是一個專注於計費監控與使用統計的實用工具，通過將複雜的數據展示簡化爲 TUI 中的狀態欄與網格，幫助開發者更直觀地管理資源與成本。
