前言¶
DeepSeek 自 2026-08-17 起實施峯谷分時定價，谷期價格只有峯期的一半。同樣的任務放在峯期跑，成本就是谷期的兩倍。麻煩在於，寫代碼的時候你未必記得當前處於哪個檔位，DeepSeek Harness（下稱 DSH）的 web 界面也沒有現成的地方顯示檔位和本次會話花了多少錢。
DSH 的理念是「一切皆插件」，這類展示層的缺口正好交給插件來補。下面介紹的 dsh-tidewatch 就是這樣一枚徽章：懸浮在輸入框旁，顯示峯谷狀態、倒計時和會話花費。
這是什麼¶
dsh-tidewatch 由 KhalilYamber 維護，MIT License，當前版本 1.0.6，在 package.json 中歸類爲「費用 / Web UI / 觀測」。一句話定位：DeepSeek 峯谷時刻懸浮徽章——一張懸浮在輸入框旁的潮汐卡，顯示此刻是峯期還是谷期、距下一階段還有多久，以及本次會話的 API 花費（默認人民幣）。
兼容性聲明爲 dsh >=0.1.0-rc.5、node >=20，surfaces 爲 host、web：宿主側負責統計，web 客戶端負責展示。
核心功能¶
懸浮徽章¶
摺疊態一行讀完，狀態點峯期橙紅、谷期藍綠：
● 峯期 距谷期 03:33 · ¥0.12
點擊展開是完整面板：官方峯谷時段表（北京時間）、當前檔位價格、本次會話 Token 明細、匯率/幣種設置。再點擊「本次會話費用」行，可展開分模型花費明細，各模型的 token 與花費分別列出，合計等於分模型之和。
位置與主題：徽章懸浮在輸入框右側、與輸入框垂直居中；窄窗口放不下時自動移到輸入框上方，不遮擋輸入框與官方統計欄。配色跟隨 GUI 亮/暗主題（--dsw-* 變量）。
計費口徑¶
- 按每次調用實際發生時刻的檔位計價，跨峯谷切換不漂移；緩存命中/未命中分開計費
- 價格單位爲美元 / 1M tokens，
成本 = 輸入未命中 × cacheMiss + 輸出 × output + (緩存讀 + 緩存寫) × cacheHit - 峯谷時代之前（2026-08-16 16:00 UTC）的調用按當時的基礎價計費，保證歷史正確性
- 賬本以美元存儲，顯示時按固定匯率 6.82 換算人民幣（默認，與官方人民幣標價口徑一致），也可切換爲直接顯示美元；人民幣 2 位小數，美元 4 位小數
峯谷時段表（官方依據）¶
| 時段（UTC） | 北京時間 | 檔位 |
|---|---|---|
| 01:00 – 04:00 | 09:00 – 12:00 | 峯 |
| 04:00 – 06:00 | 12:00 – 14:00 | 谷 |
| 06:00 – 10:00 | 14:00 – 18:00 | 峯 |
| 10:00 – 次日 01:00 | 18:00 – 次日 09:00 | 谷 |
谷期價格爲峯期的一半。徽章按 UTC 窗口判定當前檔位（官方口徑），時段表展示按北京時間。另有周末規則（2026-08-23 起）：週六/週日（UTC 自然日）全天按谷期計價，無峯谷切換，下一個切換點是下週一首次進入峯時。
安裝與啓用¶
需求：Node.js ≥ 20，以及帶 dsh plugin 命令的 DeepSeek Harness 版本。先裝插件，再重啓 web 界面：
# npm 包安裝（README 標註「發佈後可用」）
dsh plugin --profile web add dsh-tidewatch
# 或本地目錄（開發調試）
dsh plugin --profile web add link:./dsh-tidewatch
第一行從 npm 源安裝；第二行把本地目錄以鏈接方式接入，適合改代碼調試。安裝後重啓 dsh web 生效。需要說明的是，npm 安裝命令在 README 中標註爲「發佈後可用」，該包當前是否已發佈未確認；拿不到包時，可先取得源碼目錄，再用 link: 方式從本地安裝。
典型用法¶
1、重啓 dsh web 後，徽章出現在輸入框右側，摺疊態直接讀當前檔位、倒計時與會話花費；
2、點擊徽章展開/收起詳情面板：時段表、當前檔位價格、Token 明細、幣種切換（¥ / $），切換即時生效並被記住；
3、點擊「本次會話費用」行展開分模型明細，覈對各模型的 token 與花費。
如果要改這份代碼，先做構建，再跑自檢：
# 語法檢查 + zod junction
DSH_CHECKOUT=<harness 源碼根目錄> bash scripts/build.sh
# 峯谷數學與計費自檢（19 項，含雙份常量一致性）
node test/verify.mjs
數據從哪來¶
模型調用 usage 塊（assistant/chunk、assistant/message 事件）
→ lib/index.js：costUsage 會話投影（zod schema 校驗）
→ token 桶 + 美元成本（按事件時刻峯谷檔位）
→ useProjection('costUsage')（瀏覽器端）
→ lib/client.js：懸浮徽章渲染（秒級倒計時 + 匯率換算）
宿主側的 lib/pricing.js 是純函數集合（峯谷窗口、isPeakHour / peakPhaseAt、價格表、costOf），前端只在 lib/client.js 裏做渲染。插件對外提供 projection:costUsage 會話投影，想把這份數據接進自己的面板可以直接複用；docs/PORTING.md 寫了移植到其他宿主的適配說明。
適用場景與注意¶
適合在 DSH web 界面使用 DeepSeek、在意峯谷價差與成本觀測的開發者。幾點注意：
1、價格表內置（V4-Flash / V4-Pro 官方 2026-08-17 價），官方調價後需手動同步 lib/pricing.js（計費）與 lib/client.js 的 DISPLAY_PRICES（展示）兩處常量；
2、時段判定固定按 UTC（官方口徑），時段表展示按北京時間（UTC+8）；
3、人民幣顯示是美元賬本 × 固定匯率 6.82 的換算結果，與官方人民幣標價口徑一致，但不是即時匯率；
4、插件以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證（MIT）。
小結¶
dsh-tidewatch 做的事不復雜：把官方峯谷時段、當前檔位、倒計時和會話花費放進輸入框旁的一張卡，省掉查時段表和心算的功夫。裝上、重啓、看徽章，三步可用。插件頁面與源碼：
- 社區目錄（獨立站點，與 DeepSeek / 幻方無官方從屬關係）：https://www.skillhub.cn/plugins/KhalilYamber/dsh-tidewatch
- GitHub：https://github.com/KhalilYamber/dsh-tidewatch
