前言¶
用 DeepSeek Harness（DSH）跑智能體時，API 按峯谷計價：工作日白天單價高，其餘時段減半。會話一多，很難憑感覺判斷「現在是不是峯時、今天燒了多少 tokens、錢主要花在緩存還是全價輸入」。去外部賬單頁查又和本地開發節奏脫節。
dsh-usage-peak 是社區維護者 hhse 發佈的客戶端插件，只讀本機 DSH 會話日誌與鯨魚記賬本，在側欄和設置頁展示峯谷狀態、今日花費與趨勢，不聯網、不上報。
這是什麼¶
插件全名對應倉庫 hhse/dsh-usage-peak，分類爲客戶端（Web UI）。當前 package 版本爲 1.0.1，MIT 許可。
它解決的是：在 Harness 裏就地看清用量與花費構成，並把 DeepSeek Flash / Pro 的峯谷價目表內嵌展示，方便對照日誌理解賬單。
核心功能¶
側欄常駐膠囊¶
安裝後，側欄圖標列表最上方會出現一行濃縮信息，例如：● 峯 ¥14.70 · 12.8M tok · 2:43 後轉谷。點擊可打開完整面板；側欄摺疊時收成小圓點。
設置頁「用量儀表盤」¶
與側欄同源數據，展開後包括：
- 峯谷狀態：當前時段、距離下次切換的倒計時、當前時段單價（緩存命中 / 全價輸入 / 輸出）。
- 今日概況：花費、請求數、tokens、緩存命中率、峯時花費佔比、餘額（可與鯨魚記賬本交叉校驗）。
- 今日 24 小時分佈：按小時柱狀圖，峯時與谷時着色不同，當前小時高亮。
- 花費構成：緩存命中、全價輸入、輸出三段佔比。
- 近 14 天趨勢：按天堆疊柱狀，便於對照峯時佔比。
- 按模型：Flash / Pro 各自的請求數、tokens、花費。
- 價目表：當前時段對應行高亮。
數據快照默認緩存 15 秒；面板上的「刷新」會帶 ?fresh=1 強制重算。
價格模型（插件內置）¶
單位：元 / 百萬 tokens，[谷時, 峯時]。
| 模型 | 緩存命中 | 全價輸入 | 輸出 |
|---|---|---|---|
| DeepSeek Flash | 0.02 / 0.04 | 1 / 2 | 4 / 8 |
| DeepSeek Pro | 0.15 / 0.30 | 4.5 / 9 | 13.5 / 27 |
峯時：週一至週五 09:00–12:00、14:00–18:00（北京時間）；其餘時間、週末與節假日爲谷時（單價減半）。
數據從哪來¶
插件在本地讀取：
~/.dsh/sessions/<項目 slug>/<會話 id>/session.v4.jsonl.zstd：從每條assistant/message的usage與模型字段統計，並按請求時刻判斷峯谷。~/.dsh/.dshw-usage.json：鯨魚記賬本的餘額與當日花費。
日誌可能是多幀 zstd；Node 自帶 zlib.zstdDecompressSync 只解第一幀，插件會按 magic 切幀、逐幀解壓再拼接，無需系統安裝 zstd 命令行。
安裝與啓用¶
DeepSeek Harness 採用「一切皆插件」的擴展方式；社區插件目錄在 SkillHub，與 DeepSeek / 幻方無官方從屬關係。安裝前建議瀏覽倉庫源碼與許可證——插件以當前 DSH 進程權限讀本地日誌。
官方 README 給出的安裝命令爲：
dsh plugin add github:hhse/dsh-usage-peak
（README 註明 npm 同名包發佈後也可按包名安裝；以你使用的安裝渠道文檔爲準。）
裝好後：
- 側欄最上方出現用量膠囊；
- 設置 → 用量儀表盤 打開完整面板。
兼容性與已知限制¶
- DSH：
package.json中聲明與 0.2.1-rc.3 兼容（dsh.compatibility.dshReleases）。 - Node.js：>= 22.15（依賴
zlib.zstdDecompressSync）。 - 實現爲純 JS，無構建步驟；
client.js通過window.__ModuleLoader__註冊，React 由宿主提供。
限制方面：
- 依賴 DSH 會話日誌內部格式（
session.v4.jsonl.zstd與assistant/message.data.usage）。DSH 若改格式，插件需跟進；讀不到數據時面板爲空態而非報錯。 - 歷史範圍限於本機會話日誌；鯨魚記賬本從 2026-11-02 起纔有記賬數據。
典型用法¶
日常開發無需額外配置：開着 DSH 寫代碼時看側欄即可判斷是否在峯時、今日 tokens 與切價倒計時。需要復盤「錢花在哪兒」時，打開設置裏的用量儀表盤，看 24 小時分佈與花費構成，或對照 14 天趨勢和按模型表格。
結尾¶
dsh-usage-peak 把峯谷計價和本地 session 用量綁在一起，適合長期在 DSH 裏調 API、關心緩存命中率與峯時佔比的開發者。詳情與截圖見 GitHub README；目錄頁：https://www.skillhub.cn/plugins/hhse/dsh-usage-peak，源碼：https://github.com/hhse/dsh-usage-peak。
