前言¶
在 DeepSeek Harness（DSH）裏跑多工作區、多會話時，官方 Web GUI 側重操作與對話，並不會把歷史會話裏的 provider usage 聚合成可瀏覽的報表。若你想看清一段時間內的 Token 構成、估算花費、哪條會話最耗 Token，以及 DSH 宿主自身的 CPU 與內存佔用，通常只能自己掃 ~/.dsh/sessions 下的 JSONL，或寫腳本對賬。
下面介紹社區插件 dsh-session-dashboard（維護者 starriv，GitHub 倉庫 starriv/dsh-session-dashboard）。它在 Host 側讀本機會話日誌，在 Web GUI 左側欄提供「會話統計」面板，把用量、費用估算、趨勢、排行和運行狀態放在同一頁，並複用 DSH 主題與鑑權。目錄分類爲 admin-security；截至社區目錄信息，倉庫約 3 stars、1 fork。插件以 MIT 許可發佈，當前 npm 包版本爲 1.4.1（以倉庫 package.json 爲準）。
這是什麼¶
DSH Session Dashboard 是 DeepSeek Harness Web GUI 的會話統計插件。數據源是本機 DSH 會話目錄（默認 ~/.dsh/sessions）中的 session.vN.jsonl 或 .zstd 日誌；不依賴遠程賬單 API。界面從 sidebar.panellist 的 session-stats 入口進入，與 main 面板 key 對應。
環境要求（README 原文）：
- DeepSeek Harness 0.2.1-rc.5 或兼容版本。
- Node.js >= 22.15（CI 覆蓋 Node 22 與 24）。
- 安裝包內需包含預構建的
client.js，供插件管理器加載。
核心功能¶
按 README 功能表，各區域職責如下。
| 區域 | 內容 |
|---|---|
| 全局範圍 | 全部時間（默認）、今日、近 7/14/30 天；「今日」按瀏覽器所在 IANA 時區自然日從 0 點到現在，並與上一日對比 |
| 概覽 | 總 Token、估算花費、平均每會話、緩存命中率；有上期數據時顯示環比變化 |
| 每日消耗 | 按 Token 類型堆疊柱狀圖，虛線表示上一週期，底部顯示日均值 |
| Token 構成 | 環形圖與圖例（精確值與佔比） |
| 會話排行 | 按 Token 或活躍時長排序；展示佔比條、花費、活躍時長與總時長（懸停可看首末活動時間） |
| 運行狀態 | CPU、RSS、事件循環 p99、運行時長、PID、Node 版本及近 5 分鐘 CPU 曲線 |
| 刷新 | 頁面可見時每 5 秒刷新；隱藏時暫停；失敗退避；支持手動刷新 |
Token 統計口徑：只計 provider usage 中的 inputTokens、outputTokens、cacheReadTokens、cacheWriteTokens；壓縮摘要中的獨立 provider 調用按 compactionId 去重計入。費用爲按模型與時間段的估算值（默認 CNY 價目快照，含峯谷窗口，默認時區 Asia/Shanghai），不等於平臺賬單；Search/Fetch 按次費、無 usage 的輔助調用等不在估算範圍內（README「估算範圍」一節有完整排除列表）。
界面使用 DSH 主題變量，支持淺色、深色與窄屏；切換統計範圍時保留佈局並用佔位塊加載，減少整頁閃爍。
安裝與啓用¶
從 npm 安裝（推薦）¶
在 DSH 插件管理器中執行（README 原文寫法）：
plugin_manager install_bundle -> dsh-session-dashboard
DSH 會從已配置的 npm registry 解析最新版本；有新版本時管理頁可顯示「可更新」並直接升級。安裝完成後左側欄出現「會話統計」；首次打開或更新插件後建議刷新一次 Web GUI。
開發與本地路徑安裝¶
修改 Host 側 index.js、host/ 後需重啓 DSH 宿主；Client 由插件管理器加載 client.js。本地路徑或 link: 安裝屬於開發方式，不會收到 registry 更新提示；需要自動更新時請使用上述 npm 安裝。
配置要點¶
cordis.patch.yml 中 row config 均可選。常用項示例：
| 鍵 | 默認值 | 說明 |
|---|---|---|
scope |
all |
Host 側默認統計範圍；打開面板仍以界面選擇器爲準 |
trendDays |
30 |
全部時間模式下趨勢圖天數（1–90） |
timeZone |
Asia/Shanghai |
峯谷計價與瀏覽器未上報時區時的日曆兜底 |
refreshMs |
1500 |
同一份快照的最小重掃間隔 |
idleGapMinutes |
10 |
活躍時長：相鄰事件間隔超過該值視爲離開會話 |
rankingLimit |
100 |
排行最大條數 |
allowUnauthenticated |
false |
無 connection 服務時是否允許無鑑權訪問 |
pricing / peakWindows 可覆蓋內置價表與峯時窗口。allowUnauthenticated 會關閉元數據路由鑑權，不應在可被網絡訪問的 Host 上啓用；默認在無 connection 時返回 503 auth-unavailable。
典型用法¶
- 確認本機存在 DSH 會話日誌目錄（默認
~/.dsh/sessions），且 DSH 版本與 Node 版本滿足要求。 - 按上文在插件管理器中安裝
dsh-session-dashboard。 - 在 Web GUI 左側欄打開「會話統計」，用頂部範圍選擇器切換「全部時間 / 今日 / 近 7 天」等。
- 查看概覽與「每日消耗」「Token 構成」判斷近期用量結構；在「會話排行」中按 Token 或活躍時長排序，懸停時長列覈對活動時間。
- 在「運行狀態」區觀察 Host CPU、RSS 與事件循環延遲，評估本機負載。
- 若需調整峯谷時區、掃描頻率或排行上限，在插件 row config 中修改對應鍵後按 DSH 插件重載流程生效；改
pricing後需重新加載插件以重建計價緩存（僅刷新瀏覽器不會重算 Host 側歷史計價緩存）。
數據 API（README 安全章節）：/dsh-session-stats/snapshot 與 /dsh-session-stats/ping 使用相同鑑權；存在 connection 服務時複用 Cookie/API 憑證，無 Cookie 的 curl 會得到 401。
適用場景與注意¶
適合：在本機長期使用 DSH、希望用 Web 界面復盤 Token 與估算成本、並順帶查看宿主健康狀態的開發者或團隊（數據不出本機會話目錄）。
注意：
- 插件以當前 DSH 進程權限讀取會話文件；安裝前宜閱讀倉庫源碼與 SECURITY.md，確認與部署邊界一致。
- 響應包含會話標題、
cwd、Token 與費用估算，應通過 DSH 既有訪問控制暴露 GUI，勿在公網裸奔 Host。 - 社區目錄 skillhub.cn 插件頁 爲獨立生態索引，與 DeepSeek / 幻方無官方從屬關係；安裝與升級以倉庫 README 與 registry 包爲準。
結尾¶
dsh-session-dashboard 把 DSH 會話日誌裏的 provider usage 聚合成可切換時間範圍的統計面板，並補充 Host 運行指標，適合作爲本地用量與成本粗算的日常入口。進一步的功能說明、數據口徑與安全模型見 GitHub README；插件目錄頁：https://www.skillhub.cn/plugins/starriv/dsh-session-dashboard，源碼：https://github.com/starriv/dsh-session-dashboard。
