前言¶
DeepSeek Harness（DSH）採用插件化架構，旨在擴展客戶端能力。dsh-peak-alert 是一個面向 Web 客戶端的純前端插件，用於解決用戶在使用 DeepSeek 模型時無法直觀感知當前是否處於“峯谷定價”時段的問題。該插件通過自動識別時段並調整界面樣式，幫助用戶在開發或使用過程中避免在高峯時段產生不必要的成本。
時段規則¶
根據官方口徑，插件基於北京時間判斷時段：
- 高峯時段：週一至週五（不含中國法定節假日）的 09:00-12:00、14:00-18:00。
- 空閒時段：其餘所有時間，包括週末及中國法定節假日全天。
- 價格關係：空閒時段價格爲高峯時段的一半（高峯 ≈ 空閒 × 2）。
核心功能¶
-
三檔提示強度
在設置 → 通用設置中，用戶可選擇“峯谷定價提示強度”：- 關閉：不顯示時段 chip，輸入卡片無染色。
- 低：僅 DeepSeek 模型顯示時段 chip，輸入卡片無染色。
- 中：顯示時段 chip，且在高峯時段將輸入卡片背景染成淡紅色（帶紅色描邊）。
- 設置持久化保存在瀏覽器的
localStorage中，刷新或重啓後保留。
-
輸入卡片高峯染色
當處於中檔強度且當前模型爲 DeepSeek、且處於高峯時段時，輸入卡片（[data-composer-card]）背景會自動疊加一層淡紅色，切換時段時即時變色。 -
時段 chip 顯示
輸入框下方的狀態條會顯示彩色 chip，包含當前狀態、價格倍率與下次切換時間。- 高峯：紅色
⚠ 高峯時段 · 價格×2 - 空閒：綠色
空閒時段 · 價格×1 - 週末：綠色
空閒時段（週末）· 價格×1 - 法定節假日：綠色
空閒時段（春節）· 價格×1 - 下次切換：自動計算並顯示，會跳過週末與法定節假日。例如
週一 9/21 09:00 切高峯。懸停可查看完整說明與剩餘時間，每 10 秒刷新。
- 高峯：紅色
-
法定節假日識別
- 自動拉取 apisbo 法定節假日接口 數據。
- 僅取
type === "holiday"的條目，忽略type === "workday"（調休上班日）。 - 數據按年緩存至
localStorage，距年末 45 天時會提前拉取次年數據。 - 容錯機制：當接口不可用時，靜默退化爲僅按“週一至週五”判斷，chip 正常顯示但提示中會註明“法定節假日數據暫不可用”。
-
DeepSeek 模型自動識別
- 自動匹配輸入框右下角的模型名稱，包含 “DeepSeek” 字樣即判定爲 DeepSeek 模型。
- 非 DeepSeek 模型在中檔模式下僅顯示灰色中性 chip，輸入卡片不染色。
- 檢測時機爲頁面掛載、切換會話、切換模型及窗口聚焦。
安裝與啓用¶
安裝前請確保 pnpm 已在系統 PATH 中。
安裝插件：
dsh plugin --profile web add https://github.com/zbxzbx98/dsh-peak-alert
生效步驟：
安裝完成後必須重啓 dsh web 並刷新頁面，客戶端 bundle 按啓動時的哈希加載，重啓後才能識別新插件。此時在高峯時段使用 DeepSeek 模型，輸入卡片將呈現淡紅色背景。
更新與卸載¶
更新插件：
dsh plugin --profile web update dsh-peak-alert
若更新失敗（如之前固定了版本），可先移除再重新添加：
dsh plugin --profile web remove dsh-peak-alert
dsh plugin --profile web add https://github.com/zbxzbx98/dsh-peak-alert
固定版本安裝：
若需固定特定版本（如 v0.1.0），可使用：
dsh plugin --profile web add github:zbxzbx98/dsh-peak-alert#v0.1.0
卸載插件：
dsh plugin --profile web remove dsh-peak-alert
技術說明¶
- 純前端運行：所有時段計算均使用
Intl.DateTimeFormat在瀏覽器端完成，不依賴本機時區設置。 - 外部請求：唯一的外部請求是按年拉取節假日表（GET，僅發送年份，不攜帶 Cookie），請求配置爲
credentials: omit。 - 本地存儲：強度設置與節假日緩存均存儲於瀏覽器的
localStorage中。 - 許可證：MIT。
- 目錄頁與源碼：SkillHub 目錄 | GitHub 倉庫
