前言¶
在 DSH（DeepSeek Harness）環境中，直接使用官方 API 時，高峯時段往往會導致計費激增或請求阻塞。deepseek-peak-blocker 插件旨在對發往 api.deepseek.com 的請求進行智能管控。它通過混合架構（Host 進程攔截與計數，瀏覽器渲染 UI）在高峯時段（北京時間，UTC+8）對請求進行攔截、計數與提醒。該插件由 zisekongling 維護，遵循 MIT 許可證。
核心功能¶
本插件提供以下核心能力：
- 高峯時段攔截：在預設的高峯窗口內，新請求會被阻攔。瀏覽器會彈出模態框，展示時段屬性與剩餘時間，並提供“繼續執行”、“取消請求”和“放行本次會話”的操作。
- 頂部主動提醒：當時段從低谷切換至高峯，且當前有活躍請求時，頂部會滑入橫幅提醒，10 秒後自動淡出。
- 右下角狀態面板：面板實時刷新，顯示時段指示燈、攔截狀態、剩餘時間及活躍請求數。支持拖動標題欄、收起爲膠囊、調整大小與透明度。
- 斜槓命令：
/bypass：獲得當前會話的一次性豁免令牌，令牌用後即失效（僅存內存）。/status：在聊天窗口回覆面板的實時狀態。
- 長任務判定與精確計數：攔截判定基於請求發起瞬間的快照；SDK 網絡重試視爲新請求獨立判定。計數邏輯在
llm/stream進出成對維護，無泄漏。
安裝與配置¶
本插件作爲 DSH bundle 插件，可通過官方命令安裝。安裝後需重啓 DSH 以加載 bundle。
安裝命令：
dsh plugin --profile web add "github:zisekongling/deepseek-peak-blocker#main"
更新或卸載：
# 更新
dsh plugin --profile web update deepseek-peak-blocker
# 卸載
dsh plugin --profile web remove deepseek-peak-blocker
配置參數（位於 settings.yaml 或設置界面）：
| 參數 | 類型 | 默認值 | 說明 |
|---|---|---|---|
peakHours |
string[] | ["09:00-12:00", "14:00-18:00"] |
北京時間高峯時段（UTC+8） |
bufferMinutes |
number | 0 |
高峯前後緩衝分鐘數，0 表示關閉 |
blockMessage |
string | 當前爲 DeepSeek API 高峯時段，是否繼續請求？ |
模態框正文 |
cancelMessage |
string | 請求已被用戶取消。 |
取消時的錯誤提示 |
peakNotification |
string | ⏰ 已進入 API 高峯時段，當前有對話正在進行，請注意響應速度可能受影響。 |
頂部橫幅文案 |
使用說明¶
- 查看狀態：輸入
/status可查看面板的四項實時狀態。 - 豁免請求：輸入
/bypass可獲取令牌，在高峯時段繞過模態框直接放行。 - 面板設置：按住狀態面板標題欄可拖動；點擊齒輪圖標打開獨立設置浮層，調整面板大小（60%-160%）與透明度（30%-100%）。
- 生效規則：插件僅在工作日（週一至週五）的 UTC+8 時段生效。週六、週日全天視爲低谷，完全放行。
注意事項¶
- 內存存儲：
/bypass令牌與狀態記錄僅存於進程內存，插件重啓後令牌會清空。 - 代理識別：若將
api.deepseek.com反代並註冊爲新 provider，插件無法識別並攔截。僅修改官方適配器的 baseURL 環境變量不會改變路由標識，仍會被攔截。 - 超時處理：模態框若 30 分鐘（
decisionTimeoutMs）無人應答，會自動取消該請求。 - 架構限制：所有 API 請求由 Host 進程發起，瀏覽器不直接調用
api.deepseek.com。
結語¶
deepseek-peak-blocker 爲 DSH 用戶提供了精細化的官方 API 高峯管控能力。通過攔截、計數與友好的 UI 交互，幫助開發者在工作日合理規劃 API 調用。
- 目錄頁：deepseek-peak-blocker
- GitHub 倉庫：zisekongling/deepseek-peak-blocker
