DeepSeek Harness 插件：DeepSeek API 定價窗口指示器

前言¶

在使用 DeepSeek API 時，定價窗口的切換（高峯期 vs 非高峯期）容易在開發中被忽略。DeepSeek Harness（DSH）支持插件擴展，該插件直接在 Web GUI 界面上展示當前會話的定價狀態，幫助開發者根據實時費率做出決策。

插件簡介¶

dsh-deepseek-offpeak-indicator 是由 cumthugo 維護的一個插件。它通過一個簡單的視覺元素反映當前時間是否處於 DeepSeek 的定價窗口，僅佔用極少量空間。

核心功能¶

插件在對話輸入行中渲染一個圓點，僅當會話的模型提供商爲 DeepSeek 時顯示：

1. 視覺反饋：
   - 在模型名稱左側顯示一個 5px 的圓點。
   - 黃色：高峯時段（標準費率）。
   - 綠色：非高峯時段（半價）。
2. 時間規則：
   - 基於 北京時間（Asia/Shanghai）判定。
   - 高峯：週一至週五 09:00-12:00，14:00-18:00（排除法定節假日）。
   - 非高峯：週末全天及法定節假日全天。
3. 節假日處理：
   - 支持本地緩存、網絡請求或內置表格。
   - 完全離線模式下使用內置的 2026 年假期表（33 天）。

安裝與啓用¶

安裝後頁面無需刷新即可生效。

命令行安裝¶

使用 DSH 的插件管理器執行以下命令：

plugin_manager  action=install_bundle  target=github:cumthugo/dsh-deepseek-offpeak-indicator

界面安裝¶

1. 在 DSH 側邊欄打開 Plugins 頁面。
2. 點擊 Add plugin。
3. 粘貼倉庫地址：

   https://github.com/cumthugo/dsh-deepseek-offpeak-indicator

簡寫 github:cumthugo/dsh-deepseek-offpeak-indicator 同樣有效。
4. 狀態顯示爲 application: applied 即可。

注意事項¶

• 運行環境：需要有效的 DSH 配置文件（桌面應用或 dsh web）。
• 提供商判定：插件以“提供商”而非“模型名稱”爲準。第三方網關（如兼容 OpenAI 的代理）不會顯示指示器。
• 更新限制：重複安裝同一源碼不會生效，必須先卸載再重新安裝。
• 離線模式：完全離線時僅依賴內置假期表。

定製化¶

插件邏輯集中在 client.js 文件頂部，可修改以下變量：
- PEAK_WINDOWS：高峯時間窗口配置。
- PEAK_COLOR / OFFPEAK_COLOR：顏色定義。
- DOT_SIZE：圓點大小（默認 5）。
- isDeepSeekProvider()：定義哪些提供商算作 DeepSeek。

參考資料¶

• 倉庫地址：https://github.com/cumthugo/dsh-deepseek-offpeak-indicator
• 許可證：MIT