在 DeepSeek Harness (DSH) 的 Web profile 中，開發者通常需要監控 token 消耗和模型使用情況。現有的界面可能缺乏針對峯谷分時計費的直觀展示，以及跨會話的詳細歷史分析。dsh-usage-dashboard 插件在輸入框下方增加了一個峯谷計費塢，展開後提供完整的用量分析儀表盤。
功能說明¶
該插件由 woosh2010 維護，用於解決 DSH Web profile 中用量統計不直觀、缺少峯谷計費塢以及跨會話歷史管理的問題。
峯谷分時計費¶
支持北京時間峯時（工作日 9:00–12:00 / 14:00–18:00）與谷時（半價）。自 2026-08-23 起生效，週末（週六、週日）全天按谷時計費，歷史賬單自動重算。塢上實時顯示當前時段、進度條、距下次調價倒計時（週末顯示“週末谷時”徽章）以及會話累計 / 本輪成本與賬戶餘額（60 秒自動刷新）。
歷史落盤¶
每一步的 token / 成本 / 模型 / 峯谷信息自動寫入 ~/.dsh/storages/usage-history.l，軟上限 4 萬條自動裁舊，支持跨會話與跨重啓。
全局篩選與儀表盤¶
面板頂部提供全局篩選，包括時間範圍（今天 / 7 天 / 30 天 / 90 天 / 全部）、會話範圍（全部會話 / 本會話）和模型篩選。所有圖表與統計卡實時聯動。
統計卡展示：成本（含峯/谷拆分）、Tokens（含輸入/輸出）、輪次（含峯/谷）、緩存命中率、谷時節省、單步均值。
分析圖表包括：成本趨勢折線、分時分佈柱狀圖、Token 結構環形圖、模型分佈條形圖、峯谷對比與谷時節省。
按日期查看¶
點擊成本趨勢圖上的任意一天，可下鑽查看當日統計卡、模型分佈、峯谷對比、Token 結構、最近記錄，以及額外的 24 小時分時分佈和當日會話排行。
最近記錄¶
默認顯示最近 20 輪的全部步驟，按輪分組，輪標題帶模型徽章、峯谷與成本，支持展開/收起。按日期視圖顯示當日全部輪次（最多 60 輪），跨會話時輪標題帶會話標籤。
交互關閉¶
面板通過 React portal 渲染，點擊面板外任意位置或按 Esc 關閉。
安裝與啓用¶
需要 DeepSeek Harness 0.1.1-rc.1 的 web profile，且系統需安裝 pnpm（dsh plugin 會把參數原樣轉發給 pnpm）。
執行以下命令一鍵安裝：
dsh plugin --profile web add https://github.com/woosh2010/dsh-usage-dashboard/releases/latest/download/deepseek-ai-dsh-client-ui-usage.tgz
安裝完成後重啓 dsh web 並刷新瀏覽器即可使用。
驗證與常見問題¶
部署後可運行驗證腳本：
node verify.mjs
注意事項：
1. 餘額顯示需要在模型設置頁配置過 DeepSeek API Key（未配置時餘額顯示“—”，其餘功能不受影響）。
2. 歷史存儲路徑爲 ~/.dsh/storages/usage-history.l。
3. 從舊版手動安裝（源碼複製進 web/packages/）升級可能導致 declares no dsh.bundle 錯誤，需清理舊版殘留。
