前言¶
DeepSeek Harness (DSH) 是一個基於插件架構的調試工具。在調試智能體或排查大模型調用問題時，開發者往往需要查看 Harness 內部 llm/stream 層的原始數據，包括流式響應的具體塊、推理過程、工具調用參數以及會話壓縮邏輯。外部抓包工具（如 mitmproxy）通常無法捕獲這些內部狀態，且需要額外的證書配置。dsh-sseye 插件直接嵌入 Harness，在無需代理或證書的情況下，提供對全鏈路調用的深度觀測能力。
插件介紹¶
jhuanxx44/dsh-sseye 是一個 DeepSeek Harness 插件，定位爲“DeepSeek Harness 內部的 LLM 調試控制台”。它通過攔截 Harness 原生的 llm/stream 水位線，捕獲每一次 LLM 調用的完整內容（包括消息、系統提示、工具定義、流式響應塊、使用量及線路協議），並以類似瀏覽器 DevTools 的風格展示在 Harness 界面中。該插件由 jhuanxx44 維護，採用 MIT 許可證。
核心功能¶
全量捕獲與協議還原¶
插件捕獲每次調用的完整 GenerateOptions（系統提示、消息、工具、採樣參數）以及流式響應的每一個塊。這些數據在捕獲過程中保持原始身份、順序、背壓和取消狀態。它解析出真實的線路協議（如 openai-completions、anthropic-messages 等），並支持將工具結果還原爲獨立的 role:"tool" 消息，將推理內容還原爲 reasoning_content。
DevTools 風格查看器¶
查看器以摺疊手風琴的形式嵌入在 Harness 右側面板。界面按“回合”分組，顯示調用次數、Token 數量和總耗時。每一行步驟展示狀態點、序號、內容預覽及 TTFT/耗時/用量指標。點擊行可展開內聯詳情，包含提供者/模型信息、緩存命中率條、系統提示、消息、工具名稱及響應塊（文本/推理/工具調用參數）。
對比與導出¶
支持相鄰調用的上下文差異對比，高亮新增消息。提供實時流式視圖，在調用運行時動態合併數據。支持按會話或“全部”過濾，並提供 JSON 導出功能（單條調用或打包導出）。
捕獲策略與隱私¶
支持運行時調整捕獲策略，可按來源（智能體/壓縮/會話標題等）和字段（系統/消息/工具等）開關，未捕獲的字段如實標記。提供正則脫敏列表，在數據進入緩衝區前對 API 密鑰等敏感信息進行隱藏。默認情況下，數據僅存在於內存環形緩衝區，進程退出即銷燬，不涉及持久化存儲。
安裝與啓用¶
- 在終端執行安裝命令：
dsh plugin --profile web add dsh-sseye
- 安裝完成後，重啓 DeepSeek Harness。在會話頭部會出現 SSEye 按鈕。
- 如需卸載：
dsh plugin --profile web remove dsh-sseye
典型用法¶
切換語言¶
默認界面爲英文。要切換到中文，需編輯配置文件 ~/.dsh/profiles/<profile>/cordis.patch.yml，在 sseye 插件行下添加配置：
- id: sseye
config:
locale: zh-CN
修改後重啓 Harness。
過濾與導出¶
在查看器頂部使用按鈕按會話或“全部”篩選。點擊導出按鈕保存當前的捕獲記錄。
脫敏敏感數據¶
在脫敏列表中添加正則規則（如 sk-.*），插件會在數據進入內存緩衝區前將其替換爲 ***，防止敏感信息泄露。
注意事項¶
- 零持久化：默認情況下，捕獲數據僅保存在內存環形緩衝區中，進程關閉後數據丟失。導出需在進程運行期間手動觸發。
- 權限隔離：插件通過 Harness 進程運行，API 密鑰存儲在適配器層，
llm/stream層無法直接接觸密鑰。 - 無額外配置：無需代理或證書配置即可直接使用。
總結¶
dsh-sseye 解決了在 Harness 內部觀測 LLM 調用的痛點，提供了無需額外網絡抓包工具的深度調試能力。通過內存緩衝和實時流式展示，開發者可以清晰地定位模型調用、協議細節和智能體邏輯。
