前言¶
在使用 DeepSeek API 進行開發時,高峯時段(每天 9:00-12:00、14:00-18:00,北京時間)通常伴隨着更高的價格和更慢的延遲。對於頻繁調用 API 的開發者而言,手動切換模式或查看餘額不僅繁瑣,還容易導致不必要的費用支出。本插件旨在通過可視化界面和通知機制,解決這一痛點。
這是什麼¶
這是一個由 lsakira 維護的客戶端插件。它爲 DeepSeek Harness(dsh)提供實時時段指示、高峯前提醒以及 API 餘額卡片功能,幫助開發者掌握當前運行狀態。
核心功能¶
-
模式指示燈
在界面左下角常駐顯示當前時段:
- 梁文峯(高峯):每天 9:00-12:00、14:00-18:00。
- 梁文谷(非高峯):其餘時間。 -
高峯前提醒
在高峯開始前(默認提前 10 分鐘,可配置)彈出右下角通知條。提醒的標題和內容均可自定義。插件僅負責提醒,不干預模型的回覆行爲。 -
餘額卡片
在指示燈上方顯示 DeepSeek API 餘額(每 5 分鐘刷新一次)。當餘額低於配置閾值(默認 2 元)時,卡片會變紅。
安裝與啓用¶
前提:已安裝並運行 DeepSeek Harness(dsh)。下文 $DSH_HOME 指你的 dsh 數據目錄(默認爲 ~/.dsh 或 C:\Users\<用戶名>\.dsh)。
- 將插件目錄放入
$DSH_HOME/tools/dsh-peak-reminder/。 - 編輯
$DSH_HOME/profiles/web/package.json,在dsh.profile.bundles中加入:
"@local/dsh-peak-reminder"
- 在
$DSH_HOME/profiles/web/下執行:
dsh plugin --profile web add ./../../tools/dsh-peak-reminder
- 重啓 dsh,刷新瀏覽器頁面。
典型用法¶
- 配置 API Key:在
$DSH_HOME/.credentials.yaml中配置DEEPSEEK_API_KEY。 - 自定義設置:編輯
dsh/client.js頂部的“⚙️ 用戶設置區”。ADVANCE_MIN:提前幾分鐘提醒(默認 10)。REMIND_TITLE:提醒標題(默認“梁文峯要來了”)。BALANCE_RED_BELOW:餘額低於多少元變紅(默認 2)。
- 改完保存並重啓 dsh(或刷新頁面)使設置生效。
適用場景與注意¶
- 適用場景:適合需要精細控制 API 調用成本和時間,希望自動獲取狀態信息的開發者。
- 注意事項:
- 插件只負責顯示和提醒,絕不強制,不干預模型回覆行爲。
- API Key 僅在服務端讀取,不出現在瀏覽器端代碼中。
- 餘額數據不保證實時準確,使用風險自負。
- 未顯示指示燈需刷新頁面(F5)或重啓 dsh。
結語¶
該插件通過界面常駐指示和通知提醒,降低了手動監控的頻率,適合集成到日常的 DSH 工作流中。更多信息請查看:Catalog URL 或 GitHub。