在 DeepSeek Harness 的 Web 界面開發中，上下文窗口的實時狀態、消息壓縮後的保留內容以及工具調用軌跡往往難以直觀觀測。已有做法通常需要通過日誌或外部工具排查。下面介紹 dsh-context-snapshot-bar，這是一個用於觀測 DeepSeek Harness Web 運行時上下文快照和上下文軌跡的 DSH UI 插件。
插件定位¶
該插件由 luoshuai990529 維護，開源協議爲 MIT。它通過在輸入框上方提供入口，將原本隱藏的 Session 事件以可視化形式展示在右側欄，幫助開發者釐清模型當前的上下文構成。
核心功能¶
該插件主要提供三種觀測能力：
- 運行時快照節點：每次運行時快照會在消息軌跡中獨立成節點（通常爲琥珀色），即使輪次收起也可見。每條記錄擁有獨立的摘要，歷史記錄不會借用最新快照的摘要。
- 上下文快照：展示最新記錄的規則、來源和時間，並區分消息當前是在「仍在上下文」、「已清除」還是「已被替換」的狀態。
- 對話軌跡：按輪次查看用戶消息、助手工具調用與結果，並對照最近一次壓縮摘要及其替換的消息。
安裝與啓用¶
- 安裝插件
直接從 npm 安裝，無需下載源碼或手動構建。安裝 npm 已發佈的0.2.0版本：
dsh plugin --profile web add dsh-context-snapshot-bar@0.2.0
- 確認配置
執行以下命令檢查輸出中是否包含dsh-context-snapshot-bar配置層：
dsh --profile web --dump-config
- 重啓服務
重啓對應 Web 服務以應用配置：
dsh --profile web
若該服務正在運行，需先停止舊進程再啓動。
- 使用插件
進入會話後，點擊輸入框上方的快照入口，右側欄會打開。通過標籤切換兩種視圖。
適用場景與注意事項¶
- 版本依賴：插件依賴 DSH 版本
0.1.5-rc.2（Host + Web），Node.js 版本需滿足^22.19.0 || >=24.0.0。其他版本尚未完成兼容驗證。 - 權限與行爲：插件讀取已提交的 Session 事件，不寫入會話日誌，不修改 DSH 的 AgentLoop 或壓縮策略。它以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 實時範圍與性能：實時範圍指提交事件後更新，不是逐 Token 流式顯示；最新快照也可能已離開當前模型上下文。配置模型路由後會產生額外請求，發送卡片持有的段落文本。
- 版本說明：npm 已發佈
0.2.0，源碼當前版本爲0.3.1（包含運行時快照節點功能）。 - 長會話：超出上限時標註省略數量。
總結¶
該工具通過直觀的快照和軌跡展示，解決了 DeepSeek Harness Web 開發中上下文狀態不可見的痛點。如需查看源碼或提交問題，可訪問項目主頁。
