前言¶

在 DeepSeek Harness（DSH）裏跑多模型、多會話時，token 消耗分散在會話日誌裏，內置能力若只給單次請求或單會話視圖，很難回答「最近一個月各模型各佔多少」「哪天用得最猛」「連續用了幾天」這類問題。社區插件 dsh-usage-dashboard（維護者 bzhao0110，分類：客戶端）在 Harness 設置 → Token 統計 中提供 zcode 風格的用量面板：指標卡、活動熱力圖、按模型的每日趨勢與佔比，且不估算費用，只統計 token。

這是什麼¶

dsh-usage-dashboard 是 DSH 的 Token 用量統計客戶端插件。服務端註冊名爲 tokenStats 的會話投影，客戶端通過設置頁的 settings.section 槽位注入 UI，聚合全部會話的 projectionValues.tokenStats 後渲染面板。圖表零運行時依賴，全部手寫 SVG。

核心功能¶

下面介紹面板裏已文檔化的能力（均以 README 爲準）。

指標卡（5 張）¶

• 累計 Token
• 單日峯值
• 最長會話時長
• 當前連續使用天數
• 最長連續使用天數

Token 活動熱力圖¶

53 周、GitHub 風格佈局；可在「每日」與「累計」兩種視圖間切換。

每日 Token 趨勢¶

近 7 日或近 30 日，按模型分系列的折線圖。

模型用量環形圖¶

展示各模型佔比，並附帶明細列表。

統計原理與口徑¶

先做事件摺疊，再做按天、按模型累計：

• 服務端通過 ctx.sessionProjections.register 註冊 tokenStats 投影。
• 摺疊 request/header、step/start、assistant usage、step/end、compaction/summary 等事件，按 天 × 模型 累計 token。
• Harness 在會話首次被觸碰時會回放持久化日誌，因此歷史會話同樣會被統計。

口徑說明（與內置 tokenUsage 投影一致，README 稱已對 19 個真實會話逐一對賬驗證）：

• token 總量 = input + cacheRead + cacheWrite + output
• 同一 (turn, step) 的多次 usage 上報只計最新一次（流式 chunk 替換語義）
• 不估算費用

注意： 投影是按需摺疊的，只有被打開過的會話纔有數據。若要一次性回填全部歷史，見下文「歷史數據回填」。

安裝與啓用¶

插件以當前 DSH 進程權限運行；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。DSH 生態強調「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。

npm（推薦）¶

dsh plugin --profile web add dsh-usage-dashboard

桌面版可在 設置 → 插件 → Add plugin 中，將 npm 包名填爲 dsh-usage-dashboard。

從源碼 / 本地開發¶

web / tui profile：

dsh plugin --profile web add /path/to/dsh-usage-dashboard

desktop profile 暫無插件頁安裝入口，需手動修改 ~/.dsh/profiles/desktop/package.json：在 dependencies 增加 "dsh-usage-dashboard": "file:/path/to/dsh-usage-dashboard"，並在 dsh.profile.bundles 增加 "dsh-usage-dashboard"，然後安裝並重啓應用：

cd ~/.dsh/profiles/desktop && npx pnpm@11.9.0 install

完成後重啓 DeepSeek Harness 應用。

從 GitHub¶

dsh plugin add github:bzhao0110/dsh-usage-dashboard

README 說明：git 方式安裝的是源碼，可能需要在 profile 的 pnpm-workspace 裏授權構建腳本；優先推薦 npm 安裝。

典型用法¶

查看面板¶

安裝並重啓 Harness 後，打開 設置 → Token 統計，即可查看指標卡、熱力圖、趨勢與環形圖。

歷史數據回填¶

若需要全部歷史會話進入統計，在插件倉庫目錄執行：

node tools/backfill.mjs --dry   # 預覽
node tools/backfill.mjs         # 寫入 projcache（自動跳過活躍會話）

回填後重啓 Harness，設置面板會顯示全部歷史統計。

適用場景與注意¶

適合誰： 長期在 DSH 中使用多模型、多會話，需要總覽 token 用量、活動節奏與模型佔比的開發者。

兼容性（README）： peer 依賴接受 DSH 0.1.0-rc.6 起的 0.1 線與 0.2 線全部版本（含 rc）；0.3.0 及以後未經測試。當前 npm 包版本爲 0.1.0。

客戶端平臺： package.json 中 dsh.client.platform 爲 web，並注入 @deepseek-ai/dsh-client-ui-settings。

結尾¶

dsh-usage-dashboard 把分散在會話日誌裏的 token 事件收成 天 × 模型 的投影，再在設置頁用 SVG 面板呈現，適合需要用量總覽而非賬單估算的場景。更多信息見 SkillHub 目錄 與 GitHub：bzhao0110/dsh-usage-dashboard。