前言¶
做 DSH 插件或智能體調用鏈時，token 消耗常被拆散在不同模型、不同日期、不同會話裏。想看當天、本週、本月的消耗，或者按會話導出覆盤，往往需要自己處理日誌。dsh-token-stats 是一個 DeepSeek Harness（DSH）插件，把持久化會話日誌裏的 token 用量彙總成統計頁和 API。
DSH 的理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。下面介紹 dsh-token-stats 的功能、安裝方式、API 用法和注意事項。
這是什麼¶
- 插件名稱：
dsh-token-stats - 定位：Token usage & cost statistics plugin for DeepSeek Harness (DSH)
- GitHub owner：
1841220388zzzcccxxx-star - 許可證：MIT，© 2026 quansheng；資料未直接說明
quansheng與 GitHub owner 的關係 - 加載方式：作爲外部 DSH profile dependency 安裝，並在 DSH 啓動時自動加載，無需手動激活
它解決的問題很集中：在 DSH 裏查看 token 用量、按模型 / 日期 / 會話拆分，並得到 USD / CNY 的費用估算。
核心功能¶
統計與費用估算¶
資料確認的能力包括：
- 按模型、日期、會話統計 token 用量
- 提供 USD / CNY 費用估算
- 支持按模型和會話篩選
原生設置頁¶
安裝後可在 DSH 的設置頁中找到入口：
Settings → Token Stats
資料說明該頁面支持深色 / 淺色主題，以及 zh / en 國際化。
趨勢圖¶
插件提供日 / 周 / 月趨勢的 SVG 折線圖，資料註明零依賴。
歷史回填¶
啓動時會掃描持久化會話日誌，使統計在 DSH 重啓後仍可保留。
導出¶
插件提供 CSV / JSON 導出能力，並支持按模型和會話篩選。
估算標記¶
當適配器未報告 usage 時，插件會使用 tokenMeter.estimateMessage 估算，並將記錄標記爲 estimated。
安裝與啓用¶
資料說明該插件作爲外部 DSH profile dependency 安裝。給出的安裝命令是：
cd ~/.dsh/profiles/web && pnpm install
執行完成後，按下面步驟啓用：
1、重啓 DSH web。
2、打開：
Settings → Token Stats
3、在頁面中查看統計結果，或通過 HTTP API 獲取數據。
典型用法¶
HTTP API¶
資料給出的接口路徑是：
/token-stats/api
資料列出的 op 包括：
summaryquerymodelssessionsexport
其中 export 支持：
format=csv|json
model=<optional>
sessionId=<optional>
這裏的 model 和 sessionId 是可選篩選條件。
開發檢查¶
資料給出的本地檢查命令包括：
node --check index.js
node --check client.js
node test-plugin.js
.\sync-deploy.ps1
說明如下：
node --check index.js：檢查 server halfnode --check client.js：檢查 browser halfnode test-plugin.js：運行獨立 mock 測試.\sync-deploy.ps1：重新同步源碼到 DSH profile，之後重啓 DSH web
適用場景與注意¶
適合這些場景：
- 需要在 DSH 內集中查看 token 用量
- 需要按模型、日期、會話拆分消耗
- 需要 USD / CNY 費用估算
- 需要導出 CSV / JSON 做後續覆盤
- 希望插件隨 DSH 啓動自動加載
安裝和使用時需要注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證
- 許可證資料寫爲 MIT © 2026 quansheng
- 分類、星標數、目錄頁 URL 未在本文已覈實資料中確認
- 性能數據爲資料中作者機器上的測量結果，不作爲通用性能承諾
- 無 usage 上報時會產生估算記錄，應關注
estimated標記
鏈接¶
GitHub 倉庫：
https://github.com/1841220388zzzcccxxx-star/dsh-token-stats
目錄頁 URL 未在本文資料中確認；如需從 DSH 社區目錄進入，請以社區目錄站點實際展示爲準。
