前言¶
用 DeepSeek Harness（DSH）跑任務時，Token 會分散在多次會話和不同模型、網關路徑裏。若只看賬單或單條日誌，很難回答「累計用了多少」「哪天最忙」「連續用了幾天」「緩存命中如何」這類問題。社區插件 dsh-profile-stats（維護者 Lovenndme）在 DSH Web UI 側欄提供一頁個人用量畫像，指標全部從本機會話日誌聚合，不依賴外部統計服務。
這是什麼¶
dsh-profile-stats 是 DSH 的客戶端插件：在側邊欄展示累計 Token、當日用量、活動熱力圖、按模型拆分、按計費路徑（provider）拆分等視圖。數據來源是本機 session logs，README 明確說明 metrics 來自「this machine’s own session logs」。當前 package 版本爲 2.4.12，許可證 MIT（© 2026 Lovenndme）。插件目錄頁：https://www.skillhub.cn/plugins/Lovenndme/dsh-profile-stats；源碼與說明：https://github.com/Lovenndme/dsh-profile-stats。
核心功能¶
以下能力均來自項目 README 的 What you get 列表，可與倉庫截圖 docs/overview.png 對照。
- 概覽指標：累計 Token，附帶近 14 日 sparkline；當日 Token；最長任務耗時；活躍天數 streak（連續活躍）。
- 12 個月 Token 活動：日格熱力、按周彙總，或累計曲線（running total）三種呈現。
- 按模型族：近 12 天 / 周 / 月的 Token 堆疊分佈（stacked）。
- Token mix（Cache Lens）：緩存命中率；cache / 未緩存輸入 / 輸出的構成，並可 zoom 到未緩存部分。
- 按 provider：今日或全時段 Token，用於對照網關側 billing。
指標定義、數據流、本機外發內容、更新機制與排錯見倉庫 docs/INTERNALS.md。
安裝與啓用¶
DSH 版本要求：>= 0.2.1-rc.5 且 < 0.3.0。README 寫明無需其他插件、無額外依賴。
方式一：市場安裝
在 DSH 中打開 Plugins → Discover，搜索 dsh-profile-stats 安裝。
方式二：直接安裝 bundle
在 DSH 可用的插件管理入口執行（命令原文來自 README）：
plugin_manager(action: "install_bundle", target: "dsh-profile-stats")
package.json 中說明：宿主側依賴 ctx.sessionQuery（含 listSessions / readSession 及 inheritedEventCount）與 ctx.webServer.register；客戶端通過 slots.inject/register 與 locale 服務注入。若宿主缺少這些 API，插件會加載失敗，而不是展示錯誤數字——安裝前宜確認當前 DSH 版本在兼容範圍內（文檔記載 0.2.1-rc.5 爲 verified）。
典型用法¶
安裝並加載成功後，在 DSH Web UI 側邊欄打開個人 profile 頁即可。無需額外配置項出現在已抓取資料中；日常用法是：
- 照常使用 DSH 產生會話與 Token 記錄。
- 在 profile 頁查看累計與當日 Token、 streak 與最長任務時間。
- 切換 12 個月活動視圖的日格 / 周彙總 / 累計模式，觀察使用節奏。
- 在按模型、Cache Lens、按 provider 區塊覈對模型選擇與網關計費路徑。
具體 UI 交互以當前版本 Web 界面爲準；行爲細節以 INTERNALS 文檔爲準。
適用場景與注意¶
適合：需要在同一界面彙總本地 DSH 用量、對照 provider 計費、觀察緩存與模型分佈的開發者或個人用戶。
注意：
- 插件與 DSH 進程同權限運行，只讀聚合本機會話日誌；安裝前應閱讀源碼與 MIT 許可證，確認可接受數據處理方式（外發範圍見 INTERNALS）。
- 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝來源以 Discover 市場或上述
install_bundle爲準，資料中未提供git clone或dsh plugin add github:...類命令，勿自行拼接。 - 星標與版本以倉庫當時狀態爲準；本文撰寫日 2026-11-05，插件版本引用 package.json 2.4.12。
結尾¶
dsh-profile-stats 把 DSH 側欄變成一張本地會話驅動的用量儀表盤：Token 趨勢、活動熱力、模型與緩存構成、provider 拆分，均從本機日誌摺疊而來。需要細節時查 GitHub README 與 INTERNALS，安裝走 Discover 或官方 install_bundle 命令即可。
