前言¶
DeepSeek Harness（DSH）是一個客戶端框架。在本地使用時，追蹤每次對話和上下文壓縮的具體費用需要手動計算或依賴第三方工具。dsh-cost-stats 插件直接利用 DSH 內部路由，在消息旁顯示費用膠囊，並在設置頁提供詳細的費用統計流水。
核心功能¶
- 消息旁的費用膠囊：在每條助手消息旁顯示費用膠囊（¥/$）。
- 分檔明細：點擊膠囊可查看分檔明細，包括模型、時段、緩存命中率、Token 數量與單價。
- 會話累計：顯示本次會話的累計費用。
- 設置頁「費用統計」：列出每次計費項（回覆 + 上下文壓縮），支持日期/月份篩選和分頁。
- 數據來源：與官方「用量」彈窗同源，使用供應商上報的 token 分檔。
- 官方價目表：使用官方公佈的 CNY/USD 價目表，包含舊模型名的計費歸屬。
- 時段感知：支持高峯/空閒時段感知。
- 模型篩選：支持按模型篩選計費項。
- 餘額查詢：支持查詢餘額功能。
- 隱私與安全：不讀任何憑據、不訪問外網（餘額查詢除外）、不改 DSH 內核。
- 多語言：支持中英雙語。
安裝與啓用¶
安裝：
dsh plugin --profile web add dsh-cost-stats@latest
啓用：
1. 重啓 dsh web。
2. 在瀏覽器中硬刷新頁面（Ctrl/Cmd + Shift + R）。
支持的 DSH 版本：
0.1.5-rc.2 / 0.1.7-rc.2 / 0.2.0-rc.2
注意事項¶
- 數據缺失處理：如果該回合無官方價目或拿不到路由歸屬，膠囊不顯示。如果官方數據缺失（重試失敗），使用宿主側日誌重算，並標註「按日誌重算」。
- 密鑰安全：Key 只在本機宿主側使用，不保存、不進文件、不進倉庫。唯一的外網請求是餘額查詢。
- 更新與重啓：更改代碼後，客戶端改動需硬刷新，宿主改動需重啓
dsh web。 - 包名識別：npm 上有同名老包
dsh-session-cost，需認準dsh-cost-stats。
