前言¶
在 DSH（DeepSeek Harness）裏跑智能體或對話時，模型調用分散在多次會話裏。想回答「今天用了多少 token、成本大概多少、緩存命中如何」，往往只能翻日誌或靠估。社區插件 Token 用量（倉庫 Mercer08572/dsh-plugin-token-usage）把本機會話日誌彙總進一塊看板：總量、趨勢、熱力圖和可篩選的請求日誌，數據落在本機 SQLite，不依賴額外配置項。SkillHub 上歸類爲 admin-security，維護者爲 Mercer08572。
這是什麼¶
Token 用量是 DSH 的 bundle 插件（npm 包名 dsh-client-ui-token-usage，當前資料中的版本爲 0.6.1，許可證 MIT）。Host 側訂閱會話事件、寫入 SQLite；客戶端在側邊欄底部增加「用量」入口，打開後爲完整統計頁。歷史會話在首次啓動時自動回填，無需手動開始記錄。
數據來源僅爲本機 DSH 會話日誌；除文檔說明的公開匯率與節假日補全外，不上報用量。
核心功能¶
下面按 README 中已列能力說明界面與統計口徑。
總量與範圍¶
四張卡片分別展示總成本、請求數、token 消耗、緩存命中率，並帶今日增量；失敗與取消次數在懸浮提示中。卡片統計範圍可切換 7 天 / 30 天 / 全部。
趨勢與熱力圖¶
每日趨勢圖爲未命中輸入、緩存讀取、輸出三段堆疊柱，疊加請求數折線，可切 7 / 30 / 90 天。熱力圖覆蓋近 53 周，按當天 token 量分 5 檔。
請求日誌與模型別名¶
日誌列包含時間、模型、輸入、輸出、緩存命中、命中率、速度、首字、成本等，支持按模型篩選與分頁。日誌中的模型寫法可通過「模型別名」映射到 pricing.json 裏已定價的模型；目標模型只能從價格表選擇。界面爲中文時使用 ¥，其他語言使用 $。
統計口徑（使用前宜知曉）¶
- 僅統計成功調用；失敗與取消單獨計數，不計入 token 與成本。
- 首字：請求發出到第一個 token 的耗時；速度：輸出 token ÷ 解碼時長。
- 成本在每次請求結束時按當時價格固化，標註爲僅供參考；調價隻影響新請求。無定價的模型成本留空，不以 0 代替「未計價」。
安裝與啓用¶
官方說明爲本地目錄安裝，不要手寫 profile 的 cordis.patch.yml。資料未給出 dsh plugin add github:... 一類命令，以下步驟摘自 README：
- 將插件倉庫放到本機任意目錄（通過你慣用的方式獲取源碼，例如下載發行包或自有鏡像；本文不展開獲取方式）。
- 打開 DSH，在插件管理器中選擇該目錄進行安裝。
- 重啓 DSH。
首次啓動會在後臺回填歷史會話，大約十幾秒；面板顯示「正在回填歷史會話…」並自動刷新，完成後數字齊全。
典型用法¶
安裝並重啓後：
- 在 DSH 側邊欄底部點擊 用量。
- 在標題欄下方切換四張卡片的 7 天 / 30 天 / 全部。
- 在趨勢區切換 7 / 30 / 90 天查看消耗結構。
- 在請求日誌區按模型篩選、翻頁覈對單次調用。
- 需要修正計價模型時，用右上角標籤打開 模型別名（價格仍只來自插件自帶的
pricing.json）。
本地數據路徑：
~/.dsh/token-usage/usage.db
清空：刪除 ~/.dsh/token-usage/ 目錄；遷移：拷貝上述 SQLite 文件即可。
適用場景與注意¶
適合：在本機 DSH 上長期開發或調試，需要按日、按模型查看 token 與參考成本，並關心緩存命中率與請求明細的開發者。
注意：
- 插件以當前 DSH 進程權限運行，安裝前請閱讀倉庫源碼與 MIT 許可證，自行評估是否符合安全與合規要求。
- 成本依賴
pricing.json與模型別名映射，無價格模型不會顯示成本數字。 - SkillHub 社區目錄與 DeepSeek / 幻方無官方從屬關係；星標等元數據以目錄頁爲準（資料中 GitHub 星標爲 0）。
倉庫提供離線自檢（無需啓動 DSH），便於貢獻者或自行校驗：
node tools/check.mjs # 語法 / manifest / 組件註冊 / 價格文件校驗
node tools/selftest.mjs # Host 全鏈路自測（臨時目錄）
node tools/replay.mjs # 會話日誌回放對賬
node tools/render-smoke.mjs # 客戶端組件冒煙渲染
結尾¶
Token 用量把「讀日誌、算 token、對照價格表」收進 DSH 側邊欄一塊麪板，強調本機存儲與不改配置即可用。進一步瞭解可看 SkillHub 目錄頁 與 GitHub 倉庫。
