前言¶
在 DeepSeek Harness (DSH) 的插件化架構下，子代理的執行邏輯通常運行在獨立的進程或上下文中。當開發者需要排查子代理的執行狀態、工具調用細節或推理過程時，缺乏一個可視化的監控入口。DSH 插件 dsh-subagent-inspector 解決了這一觀測斷層問題，它通過在 Web profile 中提供只讀接口，將子代理的內部狀態實時映射到前端界面。
插件定位¶
這是一個由 chongyangdu2008-cyrus 維護的客戶端插件，核心價值在於提供只讀的實時子代理過程檢查器。它不干預子代理的調度或權限，僅通過讀取官方 Session 和 subagent 事件，將複雜的執行樹和日誌結構化展示。
核心功能¶
插件在 conversation.session.header.actions 添加了入口，與官方的 ui-subagent 導航並存。其主要能力包括：
- 子代理樹形視圖：展示多層可摺疊的子代理樹，列出執行狀態、模式、深度、耗時、token 使用量以及當前正在使用的工具。
- Turn -> Step 詳情：按層級展開 Turn 和 Step，展示任務提示、推理過程、回覆內容、Todo 列表以及工具調用的請求與結果。
- 實時更新機制：使用 SSE (Server-Sent Events) 實時推送數據，具備斷線重連去重和自動跟隨新事件的能力。
- 多語言支持：界面提供簡體中文與英文兩種選項。
- 安全邊界：插件僅讀取官方 Session、agent 與 subagent 事件，不註冊模型工具。
安裝與啓用¶
通過命令行安裝插件：
dsh plugin --profile web add github:chongyangdu2008-cyrus/dsh-subagent-inspector#v0.1.0
安裝完成後，需要重新啓動 Web profile：
dsh web
啓動後，在當前會話的標題欄打開右側抽屜，即可查看實時的子代理樹。
注意事項¶
- 兼容性：該插件僅支持 Harness Web，固定兼容 DeepSeek Harness
v0.1.1-rc.2。 - 安全風險：檢查器會顯示完整的 Session 日誌，可能包含源代碼、文件內容、命令輸出等敏感信息。請僅在可信網絡中使用，且插件不開放 CORS，接口與 Harness Web 同源。
- 日誌展示邏輯：對於 Fork 的子代理，插件僅展示自身日誌的後綴（
seq >= seedLength），不會複製第三方插件的實現。 - 源碼審查：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
