前言¶
DeepSeek Harness Companion 是一個運行在 DeepSeek Harness Web 中的輕量級插件。它將當前會話的活動狀態、上下文壓力和用量信息轉化爲一個“Living Data Orb”（活數據球），幫助開發者快速掃一眼就理解 Agent 的運行情況與資源佔用。
該插件的設計理念是“狀態優先，用量按需”。默認界面只傳達 Agent 正在做什麼（狀態）以及上下文是否需要關注（壓力），只有在懸停、鍵盤聚焦或點擊固定面板時，纔會顯示詳細的數字指標。這種設計避免了數據持續佔據注意力，同時保證了隱私安全。
核心功能¶
插件通過 shell.overlay 原生掛載到 DSH Web，具備以下核心能力：
- 活動狀態監控：識別 Sleeping、Idle、Working、Waiting、Done 等狀態，幫助判斷 Agent 是否在正常執行或等待用戶響應。
- 上下文壓力可視化：通過 Normal、Attention、Warning、Unknown 四個等級展示預計上下文佔用率，低於 70% 爲 Normal，85% 以上爲 Warning。
- 用量面板：展示 Context、Billed input、Output、Cache hit 和 Steps 等指標，數據直接來源於 DSH 提供的 projections。
- Living Data Orb：利用表情和輕量動效表達狀態，不依賴顏色作爲唯一提示。
- 隱私優先：不讀取或發送 prompt、消息、推理過程、工具參數或結果、文件內容、憑證或供應商賬戶信息。
- 交互與融合：支持拖拽移動位置、摺疊成邊緣標籤，並跟隨當前選中的 session 生命週期。
安裝與啓用¶
該插件通過官方插件目錄發佈，安裝後需重啓 Web 端。
dsh plugin --profile web add dsh-companion
dsh web
使用方式¶
安裝後，插件會以“寵物”形式出現在 Web 界面上，交互邏輯如下：
- 查看用量：懸停或使用鍵盤聚焦寵物，會彈出用量面板顯示 Context、Billed input、Output 等具體數值。
- 固定面板：點擊寵物，可固定或取消固定用量面板，方便持續監控。
- 移動位置：按住寵物拖動，可改變其在屏幕上的顯示位置（位置保存在瀏覽器本地）。
- 摺疊與恢復：點擊摺疊功能，寵物會縮成屏幕邊緣的
Show DSH Companion標籤，點擊該標籤可恢復原狀。
注意事項與限制¶
dsh-companion 目前處於 MVP 階段，存在以下限制：
- 版本與兼容性：當前版本（0.1.1）精確面向 DeepSeek Harness
0.1.0-rc.5。由於 Harness 仍處於開發者預覽階段，後續版本可能需要插件更新以適配。 - Session 限制：0.1.0 僅支持 DSH Web 界面和當前選中的 session，不支持多 session 併發或多寵物。
- 隱私邊界：插件僅讀取 DSH Web 客戶端已提供的 session 狀態和 projections。當缺少 projection 數據時，指標會保持 Unknown 或直接省略，絕不會將未知數據估算爲 0。
- 功能缺失：暫不支持流式 token 估算、價格或成本計算、歷史趨勢、成長系統、prompt/tool 內容分析或雲同步。
結語¶
DSH Companion 適合需要在日常開發中持續監控 Agent 狀態和上下文用量的 DSH 用戶。它通過極簡的視覺反饋解決了“狀態可見”與“用量監控”的平衡問題，同時嚴格遵守隱私原則，不觸碰對話內容或推理過程。項目代碼與文檔託管在 GitHub 上，可根據需要自行構建或查閱。
