前言¶
DeepSeek Harness 的計費策略包含明顯的峯谷時段（Peak/Off-peak）。在 Web UI 中查看當前階段、倒計時和單次會話成本比較繁瑣。dsh-tidewatch 旨在解決這個問題，通過一個懸浮卡片提供直觀的監控視圖。
插件簡介¶
dsh-tidewatch 是一個由 proDreams 維護的 Web UI 插件。它掛載在 DSH 界面的輸入框右側，實時顯示當前計費階段、剩餘時間、會話成本以及詳細的 Token 統計。核心價值在於將官方 UTC 時區的計費規則映射到用戶本地時區，並支持多語言。
核心功能¶
- 階段概覽：通過顏色點（琥珀色爲 Peak，綠色爲 Off-peak）和倒計時展示當前計費階段。
- 潮汐線：展示當前階段已過的時間比例。
- 本地時區窗口表：將官方 UTC 計費窗口轉換爲用戶所在時區的日曆視圖，當前行高亮顯示。
- 週末規則：週六和週日（UTC 日曆日）全天均爲 Off-peak，表格自動合併爲全天行。
- 實時費率：展示當前階段的緩存命中/未命中輸入價格及輸出價格。
- 會話 Token 統計：顯示輸入、緩存讀寫、輸出和推理 Token 的本地化格式。
- 分模型成本：點擊“Session cost”行可展開查看每個模型的具體 Token 和費用。
- 貨幣切換：支持在 CNY 和 USD 之間一鍵切換，並自動保存偏好。
- 真實國際化：卡片文案跟隨 DSH 界面語言（支持 EN/CN/RU），提供原生體驗。
- Shell 集成：讀取
--dsw-*主題 Token，支持深色/淺色模式，並使用官方 Primitive 組件。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness 並啓用 dsh plugin，且環境滿足 Node.js >= 20。
dsh plugin --profile web add github:proDreams/dsh-tidewatch
安裝後需重啓 dsh web 服務，插件纔會生效。插件會掛載在 Composer 右側。
典型用法¶
- 查看狀態：卡片默認顯示當前階段名稱和倒計時，點擊徽章可展開/摺疊面板。
- 成本明細：在面板中點擊“Session cost”行，可查看按模型拆分的 Token 消耗與費用。
- 切換貨幣：在面板中點擊貨幣標籤可切換 USD 或 CNY。
注意事項¶
- 版本警告：npm 上存在的舊版本包
dsh-tidewatch(v1.0.6) 作者未更新，價格和規則已過時，切勿安裝。請務必使用 GitHub 倉庫提供的安裝命令。 - 計費邏輯：插件嚴格按照官方 UTC 計費窗口計算費率，不涉及網絡請求或 API Key。
- 權限要求：插件以 DSH 進程權限運行，無需額外的網絡訪問或 API 密鑰。
總結¶
dsh-tidewatch 爲 DSH 用戶提供了可視化的計費監控工具。通過將複雜的 UTC 計費規則轉化爲本地化的窗口表和實時卡片，它幫助開發者更精準地把握成本。
- 插件目錄：SkillHub Catalog
- 源碼地址：GitHub
