前言¶
在 DeepSeek Harness (DSH) Web 中調試智能體時,直接查看模型請求和響應的過程往往需要修改代碼或依賴外部工具。dsh-llm-call-inspector 插件提供了一個本地、會話範圍的檢查器,它會在 Chat 和 Trajectory 視圖旁邊新增一個“LLM Calls”視圖,允許開發者在不改變模型接收內容或調用者接收內容的前提下,檢查每個與會話關聯的規範化 llm/stream 調用。
插件介紹¶
這是一個由社區開發者 striveh 維護的開源插件,旨在解決 DSH Web 中缺乏原生 LLM 調用觀測能力的問題。它通過攔截並展示規範化後的調用數據,幫助開發者快速定位問題。
核心功能¶
插件主要提供以下能力:
-
LLM Calls 視圖
在 DSH Web 界面中新增一個視圖,與 Chat 和 Trajectory 並列。該視圖以最新優先的順序展示當前會話的所有調用列表。 -
調用詳情展示
列表項包含以下詳細信息:Provider(提供商)、Model(模型)、Purpose(用途)、Status(狀態)、Start Time(開始時間)、Duration(持續時間)、Chunk Count(塊數)以及 Body-capture State(正文捕獲狀態)。 -
過濾與搜索
支持對調用列表進行搜索,並可以通過 Status(狀態)和 Purpose(用途)進行過濾,以便快速定位特定調用。 -
主從詳情佈局
點擊列表中的某次調用,進入詳情頁。詳情頁採用 Master/Detail 佈局,提供三個選項卡:Request(請求)、Response(響應)和 API Comparison(API 比較)。- Request / Response:展示捕獲的請求和響應數據,支持展開 JSON 和複製內容。
- API Comparison:提供語義投影功能,展示請求與標準 API 形狀的對比(支持 OpenAI、Anthropic、Google、Bedrock、Mistral 等協議)。
-
上下文保留
當你在不同視圖之間切換(例如從 LLM Calls 切換到 Chat 再切回)時,插件會保留當前的檢查上下文,包括選中的調用、搜索關鍵詞、過濾器、詳情頁選項卡以及滾動位置。 -
數據捕獲
插件默認捕獲請求和響應正文。捕獲的請求字段包括:provider、model、reasoningEffort、messages、system、tools、temperature、maxTokens、stop、sessionId和purpose。捕獲的響應爲有序的 DSHStreamChunk值。
注意事項¶
- 版本兼容性:該插件目前僅支持 DeepSeek Harness 版本
0.1.2-alpha.2。如果你使用的是舊版本(如 0.1.0-rc.8 等),請使用插件版本v0.2.0。 - 隱私與數據安全:插件默認捕獲請求和響應正文,這可能包含提示詞、源代碼、工具參數、敏感數據或個人信息。在使用涉及敏感信息的會話前,請務必查閱隱私文檔並評估風險。
- 作用範圍:插件僅監控 DSH 規範化邊界內的數據,並非提供商的線纜代理。它不捕獲原生的 HTTP 請求或響應包。
- 存儲機制:插件使用瀏覽器內存緩存,不使用
localStorage、sessionStorage或IndexedDB。當插件生命週期結束時,客戶端緩存會被清除。 - API Comparison 限制:API Comparison 是語義投影而非數據包捕獲,它不會讀取 HTTP 頭、API 密鑰,也不會發送額外的請求。
獲取與安裝¶
當前未提供具體的安裝命令。你可以通過以下鏈接獲取插件:
* 插件目錄: https://www.skillhub.cn/plugins/striveh/dsh-llm-call-inspector
* 源碼倉庫: https://github.com/striveh/dsh-llm-call-inspector
總結¶
dsh-llm-call-inspector 是一個專注於會話級 LLM 調用觀測的工具,通過語義投影和上下文保留功能,爲 DSH Web 用戶提供了直觀的調試手段。在遵守其隱私和數據捕獲範圍的前提下,它能夠有效輔助開發者進行智能體開發與調試。