前言¶

用 DeepSeek API 跑長任務或批量調用時，計價窗口是否處於高峯期，直接影響單次請求成本。官方價目表按 UTC 寫出高峯區間，中文頁又換算成北京時間；週末、法定節假日全天按半價計，工作日里的法定假日也要從高峯裏排除。靠記憶或反覆查文檔，既慢也容易在邊界時刻估錯。

DeepSeek Harness（DSH）支持用客戶端插件往會話標題欄掛載小組件。下面介紹維護者 nacivageer 發佈的 dsh-price-period：一枚零依賴、不聯網的標題欄標籤，按官方口徑判斷當前是高峯還是半價，並在臨近切換時顯示倒計時。

這是什麼¶

dsh-price-period 是 DSH 的純 Client 插件（分類：客戶端）。它向 conversation.session.header.utilities 註冊一個組件，在有會話標題欄的場景裏展示當前 API 計價檔位（高峯 / 半價），不顯示具體單價，也不估算花費。

當前版本爲 0.1.0-alpha.1，MIT 許可。倉庫無運行時依賴，交付物就是 client.js，裝完無需構建步驟，運行時也不發起網絡請求。

核心功能¶

插件做的事與不做的，README 裏用表格寫得很清楚，摘要點如下。

會做：

1. 按北京時間對照 DeepSeek 官方價目表 的 off-peak 說明，判斷此刻是高峯還是半價。
2. 距下次檔位切換嚴格小於 30 分鐘時顯示倒計時（例如 08:30:00 整點不算，08:30:01 起才顯示）。
3. 法定節假日與週末全天按半價；週末跨期時，「下一次切換」會跳到下週一 09:00，週五 18:00 之後到週一早上中間沒有切換點。
4. 每秒用瀏覽器本機時鐘重算，無 Host 請求、無緩存。
5. 節假日數據來自倉庫內 data/cn-holidays.json（現行表含國務院 2026 年放假安排）；未收錄年份會在標籤上顯示 ⚠，tooltip 說明只按週末判斷，避免靜默猜日期。

不做：

• 不提醒「該現在跑任務」、不做定時任務。
• 不替代官方價目表變更通知；只表達高峯 / 半價兩檔。

判定口徑（北京時間）：

• 高峯期：週一至週五 09:00–12:00、14:00–18:00，排除中國法定節假日。
• 半價期：其餘所有時間，含週末與法定假日全天。

官方英文頁寫的是 UTC 的 01:00–04:00 與 06:00–10:00；插件固定按 Asia/Shanghai 換算，用戶機器系統時區不改變結論。全球共用一套價目表，海外用戶同樣在 UTC 那兩個窗口付高峯價；插件不需要地區設置。

安裝與啓用¶

前提： DeepSeek Harness 0.2.2-rc.1 或更新（package.json 中 engines.dsh 同爲 >=0.2.2-rc.1）。

桌面版與 CLI 通用下面這條命令；profile 名按你的環境改，桌面版默認多爲 desktop：

dsh plugin --profile desktop add github:nacivageer/dsh-price-period

若 dsh 不在 PATH（桌面版常見），可用安裝目錄下的 resources\runtime\cli\bin\dsh.cmd，或用 npx @deepseek-ai/dsh 代替命令開頭的 dsh。

本包沒有構建步驟：不需要 prepare，也不需要 allowBuilds。安裝後重啓 DSH 生效（manifest 不熱更新）。

插件以當前 DSH 進程權限在客戶端運行；安裝前建議瀏覽 GitHub 源碼與 MIT 許可證，確認符合你的環境策略。社區目錄 skillhub.cn 上的條目 與倉庫互爲引用，該站點爲社區插件目錄，與 DeepSeek / 幻方無官方從屬關係。

典型用法¶

安裝並重啓後，打開已有會話即可在標題欄看到時段標籤。空白新會話頁沒有 session 作用域的標題欄，此時標籤不會出現——這是 README 裏寫明的限制。

日常無需配置項：標籤每秒刷新。臨近切換時出現倒計時 UI（倉庫 docs/ 下有標題欄與倒計時截圖可參考）。

若你從源碼改節假日表或時鐘邏輯，可先跑測試再打包安裝：

npm test
npm pack
dsh plugin --profile desktop add ./dsh-price-period-0.1.0-alpha.1.tgz

維護者提醒：不要用 dsh plugin add . 做目錄 link 分發；tarball 或 git 形態才與 npm 行爲一致。維護新年節假日時，更新 data/cn-holidays.json 後執行 npm run sync:holidays，再 npm test 提交——這與普通用戶的「裝上即用」路徑無關，僅供貢獻者參考。

適用場景與注意¶

適合誰：

• 經常在 DSH 裏調 DeepSeek API、希望在標題欄一眼看到當前是高峯還是半價的人。
• 希望在跨期前 30 分鐘內看到倒計時、以便自行安排調用節奏的人（插件不會替你做決策）。

務必注意：

1. 本機時鐘是唯一依據；系統時間錯誤，標籤結論跟着錯，插件不做校時。
2. 節假日表是靜態數據；coveredYears 外的年份會顯示 ⚠，工作日里的法定假日若未收錄可能被當成高峯——但會有可見警告，不是無聲算錯。
3. 官方價目表可能調整；插件只反映 README 所述兩檔邏輯，不展示單價。
4. 調休上班的週六在實現上不單獨處理：官方口徑週末一律半價，這些日本來就按半價顯示。

DSH 生態主張「一切皆插件」；本插件是客戶端側的一枚小芯片，把官方計價時段規則固化到 UI，減少查文檔成本。

結尾¶

dsh-price-period 把 DeepSeek API 高峯 / 半價判定和臨近切換倒計時放進會話標題欄：零依賴、不聯網、無構建，安裝命令即 README 原文一條。若要查看說明、提 issue 或覈對節假日 JSON，見 GitHub 倉庫。

• 目錄頁：https://www.skillhub.cn/plugins/nacivageer/dsh-price-period
• GitHub：https://github.com/nacivageer/dsh-price-period