前言¶
用 DeepSeek Harness（DSH）跑智能體時，Token 會分散在各會話日誌裏。想看清「今天用了多少」「哪個模型佔大頭」「哪條會話最費 Token」，往往要手動翻日誌或自己寫腳本。下面介紹社區插件 dsh-usage-stats（維護者 aooyoo，分類：客戶端）：在 DSH 左側欄增加入口，把本機所有會話日誌裏的用量摺疊成每日、按模型、按會話三個視角，且不發任何外網請求。
這是什麼¶
dsh-usage-stats 是非官方社區插件，面向 DeepSeek Harness 的 Web 界面。它在「插件」「定時任務」之後增加側欄圖標，點開即主面板；數據只來自本機會話日誌中 assistant/message 事件裏 provider 上報的 usage，不做價格估算。
- 目錄頁：https://www.skillhub.cn/plugins/aooyoo/dsh-usage-stats
- 源碼與說明：https://github.com/aooyoo/dsh-usage-stats
- 許可證：MIT（
package.json版本 1.0.0）
核心功能¶
經 README 覈實，插件提供以下能力：
- 總覽卡片：總 Token、輸入、輸出、緩存命中、請求次數、會話數；時間範圍可切換近 7 / 30 / 90 天或全部。
- 每日用量柱狀圖：懸停查看當天 Token 與請求數。
- 按模型明細：請求數、輸入、輸出、緩存讀、合計。
- 按會話明細：會話標題、工作目錄、請求數、四個分量、合計、最近活動時間；運行中的會話帶標記。
- 界面跟隨宿主：中英文隨界面語言，明暗主題用宿主主題變量；零 npm 依賴、無構建步驟，純 ESM，頁面自帶 React。
統計口徑要點：四個分量爲輸入、輸出、緩存讀、緩存寫，合計爲四者之和；只統計上報了 usage 的請求（被取消且無 usage 的步驟不計）；一次請求歸屬到所在會話的本機時區那一天。
安裝與啓用¶
插件以 DSH Settings → Plugins 安裝 bundle 爲準；裝完後刷新頁面，側欄會出現新圖標，插件行 id 爲 usage-stats。
兩種入口（摘自 README）：
- 本地目錄（已驗證）：將倉庫放到本地，安裝時指向倉庫根目錄（倉庫根目錄即插件包本身）。
- 包名：若你的 DSH 版本支持按 npm spec 安裝，直接填
dsh-usage-stats。
兼容性：package.json 聲明 engines.dsh: >=0.2.1-rc.5，面向 DeepSeek Harness 0.2.1-rc.5 開發與驗證；不滿足的版本會被插件管理器攔下。
首次打開面板需讀取全部會話日誌；README 記載本機 214 個會話實測約 5–15 秒（顯示「正在讀取會話日誌…」），之後 30 秒內複用緩存爲毫秒級。
配置¶
行配置寫在 cordis.patch.yml（或你 profile 的補丁層）裏，例如：
- insert:
- id: usage-stats
name: dsh-usage-stats
config:
cacheMs: 30000
maxSessions: 400
allowPlainRoute: false
diagnostics: true
| 字段 | 默認 | 含義 |
|---|---|---|
cacheMs |
30000 |
整份快照的緩存時長；面板「刷新」會強制重算 |
maxSessions |
400 |
參與統計的會話上限，按最近活動取 |
allowPlainRoute |
false |
是否在認證路由不可用時額外註冊未認證路由 /usage-stats.json（見隱私說明） |
diagnostics |
true |
激活失敗時是否在系統臨時目錄寫診斷文件 |
典型用法¶
- 按上文安裝並刷新 DSH Web 界面。
- 點擊側欄用量統計圖標，等待首次日誌摺疊完成（會話多時可稍等）。
- 在總覽卡片切換 7 / 30 / 90 天或全部，查看每日柱狀圖與按模型、按會話表格。
- 需要強制重算時，使用面板上的「刷新」（會繞過
cacheMs緩存）。
面板數據默認經需登錄 cookie 的認證路由 /api/usage.stats 提供；未認證的 /usage-stats.json 僅在 allowPlainRoute: true 時註冊，一般不建議開啓。
隱私、性能與限制¶
隱私：只讀本機 DSH 會話日誌，無遙測、無上報、無外鏈。激活失敗且 diagnostics: true 時，可能在系統臨時目錄寫入 dsh-usage-stats-activation.json（含階段、錯誤、堆棧），用於排查；可設 diagnostics: false 關閉。
性能：單會話按最近更新時間增量複用；整份快照按 cacheMs 共享；讀取併發上限 4。
已知限制：無按工作區篩選、無費用估算、無導出；會話很多時首次打開偏慢；擴展點屬 DSH 內部接口，宿主升級後面板可能需重新確認插件是否激活成功。
適用場景與注意¶
適合需要在 DSH 瀏覽器 Web GUI 內快速審視 Token 消耗、對比模型與會話佔用的開發者。插件在本機 DSH 進程權限下讀日誌並提供本地 HTTP 數據；安裝前應自行查看源碼與 MIT 許可證，確認符合你的環境策略。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本插件亦未獲官方背書。
結尾¶
dsh-usage-stats 把分散在會話日誌裏的 Token 用量收成側欄裏的總覽、每日與明細視圖，本地計算、零外聯。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
