前言¶
DeepSeek 的官方定價策略根據時間段區分費率，週一至週五 9:00-12:00 和 14:00-18:00 爲高峯時段，其餘時間爲空閒時段。在 DeepSeek Harness (DSH) 的 Web 界面中，如果不使用輔助工具，開發者很難直觀地看到當前處於哪個時段以及會話的實時成本。dsh-peak-pricing 插件通過在 Composer 底部增加一行信息，直接顯示當前生效的定價時段、剩餘時長（秒級）以及會話累計成本，幫助開發者根據成本節奏調整工作計劃。
插件概覽¶
這是一個 DeepSeek Harness Web 插件，由 Oliver0804 維護，遵循 MIT 許可證。它解決了在 Web 界面中缺乏實時成本監控和定價時段提示的問題，同時兼容其他廠商模型的固定費率顯示。
核心功能¶
- 顯示定價時段與倒計時：實時判斷當前是高峯還是空閒時段，並顯示倒計時。
- 實時會話成本估算：基於每一步 token 的使用量，根據當時生效的費率累加成本。
- 懸停查看趨勢：鼠標懸停（或鍵盤聚焦）該行，可查看緩存命中率趨勢圖及詳細費率桶。
- 支持多廠商：除 DeepSeek 外，還支持 z-ai/glm-5.3-flash 等其他廠商的固定費率模型。
安裝與啓用¶
在安裝前，請確保已安裝 Node.js >= 20。插件通過 DSH 的插件系統加載。
- 安裝插件：
在終端中執行以下命令：
dsh plugin --profile web add dsh-peak-pricing
安裝完成後，重啓 `dsh web` 即可在界面中看到新增的行。
- 驗證安裝：
確認插件配置已生效：
dsh --profile web --dump-config | grep peak-pricing
- 移除插件：
若需卸載，執行：
dsh plugin --profile web remove dsh-peak-pricing
- 本地開發安裝：
如果需要調試或安裝特定版本，可先打包：
npm pack
dsh plugin --profile web add "file:$PWD/dsh-peak-pricing-<version>.tgz"
定價邏輯與數據¶
時段與費率¶
DeepSeek 的高峯時段爲週一至週五 9:00-12:00 和 14:00-18:00（北京時間），週末及節假日爲空閒時段。插件通過 UTC +8 時區計算，確保不同瀏覽器的顯示一致。
成本計算方式¶
成本計算採用增量累加而非簡單按結束費率重算：
1. 每次獲取新的 tokenUsage 投影時，與上一次的值做差分。
2. 差分部分的 token 數量，根據獲取時的實時費率進行計費。
3. 首次讀取會話時，因爲沒有上一次數據，會按當前費率一次性計費。
數據存儲¶
運行總成本存儲在 localStorage 中，以會話 ID 爲鍵，刷新頁面後數據不丟失。若模型不在定價表中，插件仍會顯示時段和倒計時，但不會顯示成本。
緩存命中處理¶
根據官方定價邏輯：
- cacheReadTokens 計入緩存命中輸入費率。
- uncachedInputTokens 和 cacheWriteTokens 計入緩存未命中輸入費率。
兼容性與限制¶
生態兼容¶
該插件與 dsh-live-stats 插件兼容。由於 dsh-live-stats 會將統計行合併爲一行，該插件會注入少量樣式，使價格行能夠獨立換行顯示，避免被擠壓。
本地源碼修改¶
價格表位於插件的 src/pricing.ts 文件中。如果需要更新 DeepSeek 官方的新定價，只需修改該常量並重新構建即可。該文件僅包含純邏輯，不依賴 React 或 DOM。
總結¶
dsh-peak-pricing 是一個專注於成本控制的實用工具，它通過插件形式集成到 DeepSeek Harness Web 界面中。它不僅能讓你在操作時一目瞭然地看到當前費率，還能通過趨勢圖輔助判斷緩存效果。對於需要頻繁調用 API 的開發者來說，這是監控成本節奏的有效手段。
