dsh-token-meter-panel：DeepSeek Harness Token 用量與花費面板插件

DSH（DeepSeek Harness）客戶端會記錄每次調用的 Token 用量，但內核中不包含計費邏輯。dsh-token-meter-panel 插件將用量轉化爲成本數據，在側欄增加一個獨立面板，展示今日消費、預算進度、成本構成以及緩存命中節省的費用。

插件定位¶

• 類型：社區插件（非 DeepSeek 官方）。
• 作者：olimc2016。
• 定位：DSH 生態中滿足“兼容 DSH 0.2.x、零外部依賴、峯谷計價、賬戶餘額”的 Token 統計面板插件。

核心功能¶

該插件主要提供以下數據維度：

1. 官方用量 30 天（免登錄）
   直接讀取 DSH 賬號會話，無需瀏覽器登錄或 API Key，即可查看按天趨勢、按模型、請求數的官方用量。

2. 財務數據

   • 今日消費：金額大字展示、預算進度條、與上次對比。
   • 賬戶餘額 / 累計消費：餘額支持 DeepSeek 賬號登錄或 API Key；累計消費需通過官方接口查詢，無需網頁登錄。

3. 可視化面板

   • 四宮格：緩存命中輸入、未命中輸入、輸出 Token 數量及調用次數。
   • 每日趨勢：近 7 天或 30 天的柱狀圖堆疊，支持懸浮查看明細。
   • 今日分時：24 小時 Token 分佈，標出峯值。
   • 成本構成：三類 Token 的花費佔比，以及“若無緩存今天的花費”。

4. 會話明細

   • 按會話明細：今日每個會話的 Token、調用次數及消費，子代理會話有特殊標記。
   • 本會話實時：當前對話的實時用量投影。

計費邏輯與價格¶

插件內置了 DeepSeek 官方定價（採集自官方定價頁），並支持峯谷分檔計價。

1. 分檔計價

   • 高峯時段：週一至週五 9:00–12:00、14:00–18:00。
   • 空閒時段：高峯價的一半。
   • 注：插件暫不識別法定節假日。

2. 緩存價格
   緩存命中輸入的價格約爲未命中輸入的 1/50。這是面板重點展示的省費數據。

3. 特殊計價規則

   • reasoningTokens 已包含在 outputTokens 內，不重複計費。
   • 未知模型不進行價格估算，僅累加 Token 數量。
   • 會話標題生成與聯網搜索調用不落 usage，無法計入花費。

安裝與啓用¶

安裝命令¶

使用官方安裝命令指定版本 v0.6.0：

dsh plugin --profile desktop add github:olimc2016/dsh-token-meter-panel#v0.6.0

雙包名機制¶

插件以兩個包名發佈，代碼完全相同，安裝任一即可：
- 主力包：dsh-token-meter-panel
- 短名孿生包：dsh-token-mb（推薦新用戶使用，因主力包在 npm 停止發佈新版本）

由於插槽和路由前綴獨立，同時安裝兩個包名不會衝突，會在側欄生成兩個“Token”面板。

啓用與配置¶

1. 安裝後必須重啓 DSH Desktop 才能生效。
2. 零配置：重啓後側欄最下方會出現“Token”儀表盤圖標。
   • 餘額：插件會自動讀取瀏覽器登錄態（Local Storage），無需手動配置 API Key。
   • 多幀 zstd 解碼：自帶解碼邏輯，無需安裝系統級的 zstd 或 zstdcat。
3. 設置：可在設置 → 插件 → dsh-token-meter-panel 中調整費率、刷新間隔、告警閾值及是否顯示餘額。

數據來源與注意事項¶

數據來源¶

• 全量日誌聚合：讀取本機會話日誌（session.v3.jsonl.zstd），按北京時分桶聚合。
• 官方投影：當前會話實時用量來自 DSH 的 useProjection('tokenUsage')。
• 官方用量：通過瀏覽器登錄態讀取官方 userToken 獲取 30 天用量。

注意事項¶

1. 本地估算：面板金額爲本機估算，非官方賬單，價格可能變動，請以官方頁面爲準。
2. 權限邊界：插件只讀會話日誌，不寫文件，不執行命令，不聯網（除餘額查詢外，可關閉）。
3. 數據盲區：
   • 會話標題生成與聯網搜索調用不記錄在 usage 中。
   • 活躍會話仍在追加寫入，因此“今日”數據爲下界。
4. 版本要求：僅兼容 DSH 0.2.x。