前言¶
DSH 的理念是「一切皆插件」：既有改變智能體行爲的插件，也有隻讀取已有運行數據並做展示的工具。qwert702/dsh-token-viewer 屬於後者。它爲 DeepSeek Harness Web GUI 提供 CC Switch 風格的 token 消耗統計，主要解決“當前會話用了多少計費輸入、緩存命中如何、整體成本和賬戶餘額是多少”這類問題。
它不增加 prompt content、tools，也不發起新的 provider requests；接口側主要是一組只讀統計表面，以及一個餘額代理讀取。
這是什麼¶
- 插件名：
qwert702/dsh-token-viewer - 維護者：
qwert702 - 許可證：
MIT - 定位：DeepSeek Harness Web GUI 的 CC Switch 風格 token 消耗統計（只讀）
它基於 harness 的 host usageLog 投影展示逐請求用量，並額外代理讀取 DeepSeek 賬戶餘額。對 Web GUI 用戶來說，它的價值是把 token 消耗、緩存命中率、成本趨勢和餘額集中到同一個界面裏。
核心功能¶
TokenDock¶
TokenDock 是位於 composer 上方的即時條。它顯示當前會話的：
- 計費輸入：未緩存 + 緩存讀取 + 緩存寫入
- 輸出
- 緩存命中率
- 近似上下文佔用
側邊欄卡片¶
側邊欄卡片顯示：
- DeepSeek 賬戶餘額
- 餘額刷新
- host proxy 失敗時的錯誤重試
- 跨所有會話的聚合消耗
- 可展開的按會話列表
用量統計面板¶
用量統計面板基於 host usageLog 投影做逐請求統計。每條記錄對應一次 reported assistant step，記錄提交時間、模型和四個 token 桶。
面板中的主要信息包括：
- 真實消耗 Hero
- 請求數
- 總成本
- 五卡分解
- 緩存命中率進度條
趨勢圖¶
趨勢圖按請求提交時間分桶：
- 當天按小時分桶
- 其他時間按天分桶
- 空桶補零
圖表中包含四個 token 序列，以及一條虛線成本線。
標籤頁¶
面板提供三個標籤頁：
- 請求日誌：新到舊排序；點擊行打開對應會話。
- 按項目統計。
- 按模型統計，並顯示平均成本。
時間範圍¶
時間範圍預設包括：
today / 7d / 14d / 30d / all
模型價格¶
插件按模型峯谷列表價展示：
- 模型：
V4-Flash/V4-Pro - 計價單位：每
1M tokens CNY - 緩存寫入：按
cache-miss費率 - 北京峯時：
09:00–12:00和14:00–18:00 - 峯時價格：兩倍谷時價
- 未知模型：回退到
V4-Flash谷時表
價格來源可能包括內置表：
MODEL_PRICING
當可訪問時，面板也會通過以下接口獲取 provider 官方價格：
GET /api/billing/pricing
餘額路由¶
餘額讀取通過以下接口完成：
GET /api/billing/balance
該接口代理 DeepSeek 的：
/user/balance
代理路徑經過 harness credentials service；API key 不離開服務器。
安裝與啓用¶
在 DSH 環境中執行安裝命令：
dsh plugin add qwert702/dsh-token-viewer
安裝完成後，先重啓 harness，再刷新網頁，然後在側邊欄打開：
Token 消耗 → 用量詳情
典型用法¶
下面是安裝後的基本查看路徑。
- 安裝插件：
dsh plugin add qwert702/dsh-token-viewer
-
重啓 harness，並刷新 Web GUI 頁面。
-
查看側邊欄卡片：
- 查看 DeepSeek 賬戶餘額。
- 手動刷新余額。
- 如果 host proxy 失敗，使用錯誤重試。
- 查看跨所有會話的聚合消耗。
- 展開查看按會話列表。 -
打開側邊欄中的：
Token 消耗 → 用量詳情
-
在用量統計面板中查看：
- 真實消耗 Hero。
- 請求數。
- 總成本。
- 五卡分解。
- 緩存命中率進度條。
- 趨勢圖。 -
切換時間範圍：
today / 7d / 14d / 30d / all
- 切換標籤頁：
- 請求日誌：查看逐請求記錄，並打開對應會話。
- 按項目統計。
- 按模型統計，並查看平均成本。
適用場景與注意¶
適合以下場景：
- 想在一個 Web GUI 中查看 DeepSeek 會話的 token 消耗。
- 想查看緩存命中率、真實消耗和總成本。
- 想按請求、項目、模型查看統計。
- 想查看 DeepSeek 賬戶餘額，並避免在瀏覽器側直接暴露 API key。
注意事項：
- 該插件定位爲只讀統計表面，不增加 prompt content、tools 或 provider requests。
- 餘額接口通過 harness credentials service 代理，
API key不離開服務器。 - 插件會運行在當前 DSH 進程上下文中；安裝前應檢查源碼、許可證和依賴來源。
- 許可證爲
MIT。 - 價格展示依賴內置價格表或 provider 官方價格接口；未知模型會回退到
V4-Flash谷時表。
結尾¶
qwert702/dsh-token-viewer 把 DeepSeek Harness Web GUI 的 token 消耗、緩存命中、成本趨勢和餘額查看集中到一處，適合作爲日常開發中的只讀用量面板使用。
GitHub 倉庫：
https://github.com/qwert702/dsh-token-viewer
目錄頁地址未在已覈實資料中提供，建議使用插件名檢索：
qwert702/dsh-token-viewer
