前言¶
用 DeepSeek Harness（DSH）跑智能體或長對話時，Token 消耗會分散在多輪請求和不同模型調用裏。若只靠翻本地日誌或事後統計，很難快速判斷「今天用了多少」「緩存是否起作用」「各模型各佔多少」。社區插件 dsh-token-usage（維護者 orange-v-soda）針對這類需求：在本機讀取會話相關數據，在 Web 側邊欄展示當日用量與緩存比例，並可展開面板查看近期趨勢與模型佔比。數據不上傳、不寫入會話，適配 DSH >= 0.2.1-rc.2。
這是什麼¶
dsh-token-usage 是 DSH 生態中的一款展示型插件，npm 包名爲 @orange-v-soda/dsh-token-usage，當前發佈版本 0.1.0，開源協議 MIT。它不承擔計費或與雲端對齊，只做「簡單、美觀」的本地 Token 用量與緩存命中展示，適合想輕量盯盤、又不願引入額外聯網服務的開發者。
核心功能¶
依據項目 README 與 package.json 說明，已覈實能力包括：
- 側邊欄摘要：展示「今日」Token 用量與緩存率（cache hit rate）。
- 展開面板：近期用量統計；README 效果圖說明包含近 30 日用量、6 周熱力圖，以及按模型的佔比 breakdown。
- 純本地：只讀本機會話日誌，不聯網、不上傳，不向會話數據寫入內容。
- 客戶端形態：
dsh.client配置爲platform: web，且immediately: true，安裝後可在 Web 界面側欄直接看到入口。
更細的數據來源、聚合算法、增量緩存策略與接口契約見倉庫內 docs/technical.md，適合交給 Agent 通讀後再做二次開發。
安裝與啓用¶
在 DSH 插件管理器的安裝目標裏填寫以下任意一種（須與官方 README 一致，勿自行拼接其他命令）：
@orange-v-soda/dsh-token-usage # npm
github:orange-v-soda/dsh-token-usage # GitHub
npm 包頁面：https://www.npmjs.com/package/@orange-v-soda/dsh-token-usage
倉庫：https://github.com/orange-v-soda/dsh-token-usage
安裝前請確認本機 DSH 版本滿足 >= 0.2.1-rc.2。插件與當前 dsh 進程同級運行，安裝前應瀏覽源碼與 MIT 許可證，確認符合你對本地日誌讀取範圍的預期。
典型用法與界面預期¶
README 將插件適配場景概括爲：
- 希望簡單、美觀的每日 Token 用量統計與緩存比例；
- 想看到近期的用量與各模型佔比。
安裝並啓用後，側邊欄會出現今日用量與緩存率；點擊可進入面板查看更長時間跨度的圖表（具體佈局以倉庫 docs/sidebar.png、docs/panel.png 爲準）。無需額外配置項出現在已抓取資料中；若後續版本增加配置，以倉庫文檔爲準。
適用場景與注意¶
適合誰：日常在 DSH Web 端調試智能體、需要快速對照「今天花了多少 Token、緩存是否有效、模型分佈如何」的開發者。
使用時注意：
- 統計口徑與 DSH 本地會話日誌一致，不等同於廠商控制台賬單。
- 插件不聯網，無法在多臺機器間彙總；每臺安裝 DSH 的環境各自展示本機數據。
- DSH 社區目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文安裝方式以 GitHub README 爲準。
結尾¶
dsh-token-usage 把 Token 用量和緩存率收進側邊欄與面板，本地可讀、界面簡潔，適合作爲 DSH 日常開發的盯盤輔助。目錄頁：https://www.skillhub.cn/plugins/orange-v-soda/dsh-token-usage；源碼與說明：https://github.com/orange-v-soda/dsh-token-usage。
