前言¶
在 DeepSeek Harness（DSH）裏跑長對話或流式輸出時，開發者往往要同時關心幾件事：當前輸出有多快、這一輪和今天各用了多少 Token、緩存有沒有幫上忙、大致要花多少錢。若只靠分散的日誌或另裝計費插件，要麼信息不全，要麼依賴鏈變長。下面介紹的 dsh-token-gauge（社區目錄名 liumiaozhi/dsh-token-gauge）是面向 DSH Web 的客戶端插件，用老式車機風格的儀表把 Token 速度、會話與今日用量、參考金額和緩存命中率收進側邊欄，且自帶 Host 半邊從本地會話日誌聚合數據，不依賴任何計費插件。
這是什麼¶
dsh-token-gauge（顯示名：費用儀表盤 / Token Gauge）由維護者 liumiaozhi 發佈，分類爲客戶端，在 SkillHub 插件目錄 與 GitHub 倉庫 均可找到。當前 npm 包版本爲 1.1.1，許可證 MIT。
插件解決的核心問題是：在 DSH Web 側邊欄用可讀性高的儀表 UI 展示 Token 用量與參考計費，數據來自 DSH 的 sessionPersistence 與會話中的 usage 字段，而不是僞造演示樣本。
核心功能¶
兩種佈局¶
- 單表：左側 Token 速度表，右側當前會話 / 今日 Token 與金額，底部緩存命中率進度條。
- 雙表：上方左側 Token 速度、右側緩存命中率；下方並列當前會話與今日的 Token 量、金額。
四種皮膚¶
古典（老式車機琥珀色）、馬卡龍、極簡、星空。結構與皮膚可自由組合，共 8 種呈現。
指標與刷新¶
- Token 速度：讀取當前會話流式輸出增量，指針在 0–500 token/秒 間平滑擺動。
- Token 顯示口徑：統一以 k（千 token） 顯示，保留兩位小數並帶千分位，例如
15,098.77k。 - 緩存命中率錶盤：量程 70–100%，刻度 70 / 85 / 100；低於 70% 時指針停在 70%，中央數字仍顯示真實值。
- 會話與今日數據：約每 1.5 秒刷新；金額按 DeepSeek Flash / Pro 列表價與峯谷時段估算，爲參考值，不是官方賬單。
設置與主題¶
卡片右上角滑桿圖標打開設置；結構、皮膚選擇後立即生效並寫入 localStorage，刷新後保留。顏色來自 DSH 主題令牌，深淺色均可讀；不引入圖表庫、不請求外部 CDN。
Host 與 API¶
插件自帶 Host 半邊，註冊 /api/token-gauge/usage-stats，從 sessionPersistence 讀取本地會話日誌並聚合用量。以 slot 優先級覆蓋原計費卡片位置，但不需要安裝計費插件本身。
安裝與啓用¶
面向 DSH Web（platform: web），engines.dsh 聲明爲 >=0.2.0-rc.1 <0.3.0-0；不兼容的運行時會在安裝階段被 DSH 攔截並提示。
官方按包名安裝：
dsh plugin --profile web add dsh-token-gauge
若 npm 上的包仍爲舊版，可先從源碼用 link 方式安裝（README 說明發布 1.1.0 後可直接按名稱安裝）：
git clone https://github.com/liumiaozhi/dsh-token-gauge.git
dsh plugin --profile web add "link:<本倉庫絕對路徑>"
安裝後重啓或硬刷新 DSH Web，側邊欄底部會出現「費用儀表盤」。
典型用法¶
- 點擊卡片右上角滑桿圖標打開設置。
- 在「結構」中選擇 單表 或 雙表。
- 在四種皮膚中選擇 古典 / 馬卡龍 / 極簡 / 星空。
- 開始對話後，Token 速度表隨流式輸出更新；會話與今日數據按上述間隔刷新。
開發時可在克隆倉庫後執行：
dsh plugin --profile web add "link:$PWD"
修改 client.js 後，DSH Client HMR 會在文件變化後重新加載；無熱更新時刷新頁面即可。本插件爲手寫 Client bundle，無額外構建步驟。
數據口徑（摘要）¶
| 指標 | 來源 / 口徑 |
|---|---|
| Token 速度 | 當前會話 assistant/live-chunk 文本 / reasoning / tool-call 增量估算 |
| 當前會話 Token | 當前會話所有輪次 input + output |
| 今日 Token | 插件 byDay 中今天的 input + output |
| 當前會話 / 今日金額 | 成功模型調用按單價估算；Flash / Pro 用官方列表價，峯谷與週末規則見 README |
| 緩存命中率 | 今日 cacheHit / (cacheHit + cacheMiss) |
搜索調用按 0.02 元/次估算；其他模型在 README 中有回退規則。
適用場景與注意¶
適合誰：在 DSH Web 上日常對話、需要一眼看到 Token 速度與當日消耗、又不想單獨堆計費插件鏈的開發者。
兼容與限制（來自 README）：
- 需要
@deepseek-ai/dsh-client-ui-sidebar與@deepseek-ai/dsh-client-ui-session。 - Host 依賴 DSH 自帶的
sessionPersistence與webServer。 - Node 引擎要求
>=22.19.0。
安全與信任：DSH 生態是「一切皆插件」；SkillHub 目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。插件在當前 dsh 進程權限下運行，安裝前請自行查看 源碼與 MIT 許可證。
結尾¶
經過上面的步驟，你可以在側邊欄用 8 種佈局與皮膚組合，實時看 Token 速度與緩存命中，並對會話、今日用量有統一 k 口徑的參考。進一步細節見倉庫 README 與 RELEASING.md。
- 目錄頁：https://www.skillhub.cn/plugins/liumiaozhi/dsh-token-gauge
- GitHub：https://github.com/liumiaozhi/dsh-token-gauge
