前言¶

DeepSeek API 自 2026-08-17 起實行按北京時間峯谷定價：工作日部分時段爲高峯價，其餘時間爲空閒價（約爲高峯價一半）；法定節假日與調休口徑還會改變「算不算工作日」。若只在官方文檔裏查表，很難在寫 Harness 會話時一眼看到「當前是高峯還是空閒、還剩多久切換、賬戶還剩多少錢、當前工程大概花了多少」。社區插件 deepseek-time-price（維護者 TSRYWHY）在 Harness Web GUI 上增加可拖動的懸浮窗和輸入框下方入口，把時段、價格、餘額與本項目花費集中展示，並接入中國法定節假日數據以輔助時段判斷。

這是什麼¶

deepseek-time-price 是 DeepSeek Harness（DSH）的客戶端類插件：在 Harness 界面浮出可拖動、可吸附的小窗口，顯示 DeepSeek 時段價格與倒計時、24 小時時段進度條、賬戶餘額、「本項目」累計花費，以及可摺疊的模型價格、計費規則與法定節假日信息。插件以 bundle 形式通過 cordis.patch.yml 擴展 Host 只讀路由，客戶端注入對話與佈局相關 UI 槽位；許可證爲 MIT，倉庫見 GitHub，社區目錄頁見 SkillHub。

核心功能¶

時段與價格展示¶

窗口與啓動條會標明當前屬於高峯還是空閒：空閒時段綠色、高峯時段橙色。高峯定義爲北京時間週一至週五（不含中國法定節假日）09:00–12:00、14:00–18:00；其餘時間爲空閒，含週末、法定節假日全天、調休上班的週末。空閒價在代碼中按高峯價 ×0.5 計算。

插件內置 deepseek-flash 與 deepseek-v4-pro 的高峯單價（元 / 100 萬 tokens），寫死在 client.js 的 MODELS 常量；改價需修改該常量並更新 PRICING_UPDATED 後重新加載插件。官方定價說明見 DeepSeek 定價文檔。README 註明：舊版每日 00:30–08:30 錯峯優惠已於 2025-09-06 取消，本插件按現行峯谷規則實現。

24 小時進度與交互¶

24 小時條上綠色表示空閒段、橙色表示高峯段，並帶當前時間游標。窗口可拖動，靠近屏幕邊緣自動吸附；位置保存在瀏覽器 localStorage（鍵名 dsh-time-price.floating.v1）。雙擊標題恢復默認位置；方向鍵微調，Home 復位，Esc 收起。輸入框下方保留小入口，用於打開或收起懸浮窗。

餘額與本項目花費¶

Host 提供同源只讀接口（不向瀏覽器暴露憑據）：

GET /api/deepseek-time-price/finance?sessionId=<SessionId>

餘額通過 Host 的 ctx.deepseekAccount.getBalance(...) 讀取 Platform 充值與贈送錢包（CNY 優先）；未登錄或失敗時顯示「未登錄/讀取失敗」，結果緩存 60 秒，界面以藍色展示。

本項目花費：當前會話 Host 讀取完整日誌，對每條 assistant/message 按請求發生時刻判峯谷、按 source.model 選價，標記爲精確（exact: true）。同一 cwd 下的「本項目」聚合則通過會話列表與 tokenUsage 投影緩存估算，按當前時段 flash 價累計（exact: false）。計價公式爲：cost = cacheReadTokens × hit + (uncachedInputTokens + cacheWriteTokens) × miss + outputTokens × output。

法定節假日¶

Host 路由：

GET /api/deepseek-time-price/holiday?date=YYYY-MM-DD

上游按順序嘗試 timor.tech 年度接口、holiday-cn 的 jsDelivr / fastly 鏡像，以及單日兜底；全部失敗時按星期幾降級，並在窗口內提示數據源不可用。客戶端優先走同源路由；路由不可用時可直接 fetch timor.tech（帶 CORS）。2027 年安排未發佈時，「下一個法定節假日」可能顯示暫無數據；未發佈年份 Host 返回降級結果（degraded: true）。

顯示與國際化¶

三個可摺疊區塊：模型與價格（高亮當前時段對應行）、計費規則、法定節假日（狀態、區間、下一節日、來源與刷新）。文案隨 Harness 語言切換；樣式使用 --dsw-alias-* 主題 token。

安裝與啓用¶

本插件通過 Plugin Manager 的 install_bundle 安裝本目錄（含 cordis.patch.yml），而不是憑倉庫名拼接 CLI 的 dsh plugin add。package.json 中聲明的 DSH 配置如下：

"dsh": {
  "bundle": { "patch": "./cordis.patch.yml" },
  "client": {
    "platform": "web",
    "immediately": true,
    "inject": ["@deepseek-ai/dsh-client-ui-conversation", "@deepseek-ai/dsh-client-ui-layout"]
  }
}

安裝後注意：修改 client.js 或 index.js 後需刷新 Harness 頁面（Ctrl+F5） 以加載新客戶端模塊；桌面打包版無前端 dev watcher。Host 代碼更新後需重啓 Harness 或依賴 HMR 重新組合。

典型用法¶

1. 在 Harness Web 中完成 bundle 安裝並刷新頁面。
2. 在輸入框下方查看當前時段、迷你時段條、餘額與本項目花費；點擊打開完整懸浮窗。
3. 拖動窗口到習慣位置（會自動吸附邊緣）；需要細節時展開「模型與價格」「計費規則」「法定節假日」。
4. 若需覈對當前會話精確花費，查看花費卡片上的小字說明（精確 vs 估算的區別見 README）。

插件以當前 DSH 進程權限運行；餘額路由同源且無額外鑑權，僅適合 Harness 綁定迴環地址的本機使用，請勿把 Harness 暴露到非迴環網絡。安裝前請自行閱讀倉庫源碼與 MIT 許可證。

適用場景與注意¶

適合經常在 Harness 裏調用 DeepSeek API、需要對照峯谷時段控成本、或想快速看 Platform 餘額與同工作目錄項目累計 token 花費的開發者。

已知限制（來自 README）：

• 節假日依賴第三方免費 API，離線時按星期幾降級，時段判斷可能不準。
• 餘額需當前 profile 已登錄 DeepSeek Platform。
• 「本項目」爲已緩存會話的估算；當前會話按請求時刻計價，單次請求跨時段邊界可能有 ≤1 次請求誤差；價格表更新後歷史累計不會自動重算。
• 不寫遙測；窗口位置僅存本地。只請求公開節假日接口與 Platform 餘額接口，不向瀏覽器發送會話內容或憑據。

DSH 生態主張「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

deepseek-time-price 把 DeepSeek 峯谷定價、法定假日口徑、賬戶餘額與會話/項目花費收進一個可拖動的 Harness 懸浮窗，減少反覆查文檔和心算時段的成本。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。