在 DeepSeek Harness（DSH）的使用流程中，精確掌握 API Token 的消耗構成（特別是緩存命中情況）對優化提示詞和成本控制很重要。現有界面通常只顯示總消耗，缺少對緩存輸入、未緩存輸入和輸出段落的拆分展示。該插件通過讀取 DSH 內部的會話投影，提供直觀的用量條。
這是一個輕量級的 UI 插件，用於在 DSH Web UI 中可視化 API Token 用量。由 hurry060215-tech 維護。它直接讀取 DSH 的 tokenUsage 投影，將用量顯示爲三個分段：緩存輸入、未緩存輸入和輸出，而不需要訪問 DeepSeek API 或用戶憑據。
核心功能¶
- 數據源直接讀取：直接讀取 DSH 已有的
tokenUsage會話投影，不請求 DeepSeek API。 - 隱私安全：不讀取 API Key，不查詢賬號餘額，不修改會話日誌。
- 可視化區分：使用顏色區分分段，綠色表示緩存讀取，黃色表示未緩存輸入，藍色表示輸出。
- 交互與可訪問性：支持鼠標懸停或輔助技術讀取三個分段的精確 token 數量。
- 響應式設計：桌面端和窄屏均可用；窄屏會隱藏文字標籤但保留顏色與數值。
- 無額外開銷：純 UI 插件，不新增模型工具、system prompt 或 token 開銷。
安裝與啓用¶
-
確保環境滿足要求：
- DeepSeek Harness
>=0.1.5-alpha.1 <0.1.6-0 - Web profile
- Node.js
^22.19.0或>=24 - pnpm 10
- DeepSeek Harness
-
執行安裝命令。插件尚未發佈到 npm，需直接安裝 GitHub Release 中的預構建包：
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 plugin --profile web add https://github.com/hurry060215-tech/dsh-api-usage-bar/releases/download/v0.2.0/dsh-api-usage-bar-0.2.0.tgz
- 啓動 Web 界面：
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 web
- 打開終端打印的完整啓動鏈接（或使用自動打開的瀏覽器），完成一次模型請求後，用量條會自動出現在輸入框下方。
注意：安裝包包含預構建的 lib/，用戶不需要克隆倉庫或運行構建。
端口衝突處理：如果 3080 端口已被佔用，可以使用以下命令指定端口：
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 web --port 3091
統計口徑¶
插件基於 DSH 的 token 投影進行歸一化展示，三個分段對應以下字段：
| 分段 | DSH token 投影字段 |
|---|---|
| 緩存輸入 | cacheReadTokens |
| 未緩存輸入 | uncachedInputTokens + cacheWriteTokens |
| 輸出 | outputTokens |
條形圖表達的是用量構成，而非賬戶餘額進度。
注意事項¶
- 卸載：若需移除插件，請使用
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 plugin --profile web remove dsh-api-usage-bar。 - npm 限制：由於插件未發佈到 npm，安裝時請勿嘗試使用
add dsh-api-usage-bar命令。 - 隱私說明：插件只讀取瀏覽器已收到的累計 token 投影，不發起網絡請求，不持有憑據，不寫會話事件。
