前言¶

在使用 DeepSeek Harness (DSH) 時，官方 API 在工作日高峯時段（如 9-12, 14-18）常出現計費上漲或資源緊張的情況。dsh-peak-block 插件的作用是在這些時段自動攔截髮往 deepseek-official 的請求，避免不必要的費用或排隊，轉而使用配置的第三方或本地端點。

是什麼¶

這是一個由 better-er 維護的 DSH 插件，用於在高峯時段攔截官方請求。它的核心價值是自動化的路由切換或阻止，保障資源使用。

核心功能¶

插件通過 host 單半身模式介入 agent/request 流程，主要完成以下工作：

1. 攔截官方請求：精確匹配 deepseek-official，不誤攔帶前綴的三方中轉。
2. Provider 切換：配置 targetProvider 後，將請求重定向至目標適配器。
3. 峯谷判斷：基於工作日和節假日名單自動判定高峯時段。

安裝與啓用¶

安裝插件後，DSH 會自動掛載，重啓 Web 界面即可生效。

從 GitHub 安裝：

dsh plugin --profile web add github:better-er/dsh-peak-block

從 npm 安裝：

dsh plugin --profile web add dsh-peak-block

配置¶

配置項通過 cordis 注入，核心是 targetProvider 和 peakWindow。

配置示例：

plugins:
  dsh-peak-block:
    enabled: true
    targetProvider: opencode-go
    peakWindow:
      days: [1, 2, 3, 4, 5]
      hourRanges: [[9, 12], [14, 18]]
      weekendOffPeak: true

邊界與限制¶

• 攔截範圍：僅攔截 agent/request 路徑，不攔截 compaction 等路徑。
• Provider 要求：targetProvider 必須是 DSH 已註冊適配器路由，否則切換後以 NO_ADAPTER 失敗。
• 時區判定：時區判定純 UTC+8 數學換算，與系統時區無關。
• 節假日名單：法定節假日名單內置 2026 年，取自國務院放假安排共 33 天，恆爲谷價且不受 peakWindow 覆蓋。