前言¶
在 DeepSeek Harness 裏開發或日常使用，常會碰到需要判斷當前計費時段的場景：API 的峯時與谷時價格不同，而官方定價頁按 UTC 描述，換算到北京時間還要自己算週末和法定節假日。靠記憶容易記錯，反覆開網頁查又打斷節奏。下面介紹的插件把這件事變成了輸入框下方的一個小徽章：它按北京時間持續倒數到下一次峯谷切換，跨週末或節假日時自動帶上天數。
這個插件是社區維護的第三方插件，倉庫爲 guanzi279-source/dsh-peak-valley-countdown，目錄頁在 skillhub.cn，與 DeepSeek / 幻方沒有官方從屬關係。
這是什麼¶
這是一枚註冊在 DSH 輸入框下方的倒計時徽章，由 guanzi279-source 維護，基於社區「一切皆插件」的理念實現。它只做一件事：顯示當前是峯時還是谷時，以及距離下一次切換還有多久。它不展示價目表，也不替代官方定價頁面，只是給一個一眼可見的本地時點提示。
核心功能¶
- 徽章註冊在
conversation.composer.dock插槽，與 activity、usage 並排顯示，不遮擋輸入框。 - 谷時顯示「距離梁文峯還有 …」，峯時顯示「距離梁文谷還有 …」；每秒刷新。
- 固定按北京時間（UTC+8）計算，不受瀏覽器所在時區影響。
- 跨週末、跨法定節假日時顯示天數，例如週五 18:00 後顯示
2天 14:00:00。 - 週末與法定節假日全天按谷時計算，內置 2026 年中國法定節假日表。
- 中英文詞條、跟隨明暗主題的配色；鼠標懸停顯示當前計費規則。
- 不聯網、不寫文件、不上報任何數據，只讀取系統時鐘。
計費時段依據 DeepSeek API 定價頁，官方以 UTC 描述，插件換算爲 UTC+8：峯時爲週一至週五 09:00–12:00、14:00–18:00，其餘所有時間（含週末與法定節假日全天）爲谷時。DeepSeek 可能調整價格與時段，實際以官方頁面爲準。
內置的 HOLIDAY_RANGES 覆蓋 2026 年安排，依據國辦發明電〔2025〕7號：元旦 01-01–01-03、春節 02-15–02-23、清明 04-04–04-06、勞動節 05-01–05-05、端午 06-19–06-21、中秋 09-25–09-27、國慶 10-01–10-07。2027 年安排公佈後，在 HOLIDAY_RANGES 裏補一段日期即可；未列出的日期按工作日與週末判斷。
安裝與啓用¶
官方提供從 npm 和從 GitHub 源碼兩種安裝方式，命令來自 README 原文。
從 npm 安裝（推薦）：
dsh plugin --profile web add dsh-peak-valley-countdown
從 GitHub 源碼安裝：
dsh plugin --profile web add github:guanzi279-source/dsh-peak-valley-countdown
安裝後刷新頁面，徽章即出現在輸入框下方。如果使用的 profile 不是 web，把 --profile web 換成實際 profile，例如 desktop。
典型用法¶
安裝完成後無需任何配置。徽章自動顯示當前時段和剩餘倒計時，鼠標懸停可查看峯谷規則；倒計時歸零時徽章切換到下一個時段。以當前環境爲例，週五 18:00 之後徽章會直接顯示 2天 14:00:00，提示下一次進入工作日峯時的時間點。
適用場景與注意¶
適合兩類人：一是按峯谷價差規劃任務的智能體開發者，想確認當前處於哪個計費時段；二是日常使用 DSH 想省去查價或換算時區的人。
需要注意幾點：
- 插件會在安裝時以當前 dsh 進程的權限加載並運行，安裝前應檢查源碼與許可證。該倉庫許可證爲 MIT。
- 在 DeepSeek Harness
0.2.1-rc.2的 Web profile 上測試通過，依賴 Web 端的conversation.composer.dock插槽與locale服務（DSH 0.2.x），其他版本未在資料中說明。 - 純 JavaScript 實現，無構建步驟、無運行時依賴，安裝時不執行構建腳本。
- 節假日表只內置了 2026 年，跨年份使用需自行維護。
結尾¶
這個插件的價值在於把「當前是峯時還是谷時、還有多久切換」固定在輸入框旁邊，減少手動換算和查頁的成本。它不聯網、不上報數據，適合對本地渲染有要求的人。
- 目錄頁：https://www.skillhub.cn/plugins/guanzi279-source/dsh-peak-valley-countdown
- GitHub：https://github.com/guanzi279-source/dsh-peak-valley-countdown
