在 DeepSeek Harness (DSH) Web 的開發中，上下文窗口管理是核心痛點。DSH 內置的上下文顯示通常給出整段佔比，缺乏對單條消息佔用情況的精細定位。dsh-ballast 是一個解決這一痛點的客戶端插件。它利用 host 的 token meter，按消息條目展示當前 surface 的 token 佔用和正文摘要，幫助開發者定位窗口由哪些條目佔用。
核心功能¶
該插件主要提供以下能力：
- 按條目歸因：按 token 佔用列出用戶消息、助手消息和工具結果。正文摺疊空白後截斷，工具結果顯示工具名。推理塊和圖像只計數不內聯原文。
- 價格與價差：顯示當前路由價格。如果 host 同時提供 heuristic 影子價，會標出價差（注：價差表示圖像可能經過視覺 token 重定價，不表示異常）。
- 聚合統計：顯示按消息類型聚合的 token 佔比。同時顯示當前 host 上各 live session 中最重的條目。
- 窗口壓力估算：顯示 provider usage、下一次請求的窗口壓力，以及 system/tools/messages 的估算構成。注意：估算構成與 provider usage 錨點口徑不同，面板不把兩者相加。
- 會話列表：列出當前 host 的會話。包括進程內活着的會話，以及已存儲但沒有 live agent 的會話。會話標題缺失時，會顯示工作區目錄名與 session ID。
安裝與啓用¶
安裝插件只需執行以下命令：
dsh plugin --profile web add dsh-ballast
安裝並重啓 DSH Web 後，從頁面左下的 dsh-mini-utility-dock launcher 打開 ballast。
使用說明¶
面板提供兩個主要視圖：
- 當前會話：按條目查看當前 surface 的佔用、類型、時間和摘要。已被 compaction
replace摺疊的舊append條目不顯示。 - 跨會話 Top：按需爲當前 host 的每個 live session 計量一次，並按最重條目排序。該視圖同時列出已存儲但沒有 live agent 的會話，按佔盤大小排序，並給出各自投影緩存裏的上下文壓力。
插件通過同源只讀接口 /dsh-ballast/api 獲取數據，支持 sessions、measure、top 和 cold 等端點。
適用場景與注意事項¶
- 只讀模式：該插件爲只讀插件，不估算費用、不修改會話、不觸發 compaction，也不會寫狀態或刪除消息。
- 環境依賴：需要 DSH 0.1.5-rc.3 及更高版本。未掛載 Connection 的宿主會回退到本地守衛模式，按 TCP 對端、Fetch Metadata、Origin 和 loopback Host 判定。
- 數據來源：日誌條數、字節數與 revision 來自持久化快照；token 數字來自投影緩存；標題來自一次批量日誌讀取。
適用於需要在 Web 端實時監控上下文佔用、分析消息條目權重以及排查窗口溢出問題的開發者。
