DeepSeek Harness(DSH)是面向智能體開發的平臺。在開發與調試過程中,上下文預算的管理往往容易被忽略,直到成本或性能出現問題。dsh-context-dashboard 旨在解決這一問題,提供會話維度的消耗明細與全局彙總報告。
這是一個客戶端插件,用於統計 DSH 本地會話的上下文消耗情況。它由 uckkk 維護,採用 MIT 許可證。插件能夠解析 DSH 的會話日誌,並提供基於字符數與預估 token 的統計面板。
安裝¶
安裝插件需要使用 DSH 的插件管理命令。
dsh plugin --profile web add dsh-context-dashboard
上述命令適用於 web profile,也可替換爲其他 profile 名稱。
核心功能¶
插件主要提供兩類統計視圖:
-
單會話統計
針對每一個會話,提供以下數據:消息數、用戶與助手消息數、工具調用次數、輪次、字符數以及預估 token。支持按 token 數、消息數或時間進行排序。 -
全局報告
提供全量數據彙總:總消息數、總預估 token、消耗最高的會話列表,以及按項目(工作目錄)分組的彙總信息。
使用示例¶
在 DSH 交互環境中,可以直接調用以下命令獲取信息:
- 查看單會話詳情:輸入
session_stats。默認按預估 token 降序排列,用於快速定位消耗大戶。 - 獲取全局報告:輸入
context_report。
技術細節¶
- Token 估算:插件使用經驗公式
預估 token = 字符數 ÷ 1.5進行估算,該公式適用於中文爲主的場景,僅供參考。 - 日誌格式:支持解析 DSH 默認的 zstd 壓縮格式(
.l.zstd)與明文格式(.l)的會話日誌。 - 運行環境:純 Node 實現,無第三方運行時依賴。
注意事項¶
- 插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證(MIT)。
- 生態背景:DSH 理念是「一切皆插件」,社區目錄與 DeepSeek / 幻方無官方從屬關係。