DeepSeek Harness 插件：dsh-subagent-panel

在 DeepSeek Harness (DSH) 的開發與調試中，當主會話調用子代理 (subagent) 時，其輸出往往淹沒在主對話流中，難以快速定位和切換。dsh-subagent-panel 插件將工具調用行轉換爲可交互卡片，解決了子代理可見性低的問題。

插件定位¶

這是一個 DSH Web 客戶端插件，由 BiKing567 維護。它將 subagent 和 subagent_fork 工具調用渲染爲點擊卡片，點擊後可在主會話視圖中打開子會話，無需重繪 shell 的會話視圖。

核心功能¶

1. 行內卡片渲染
   將主對話中的 subagent / subagent_fork 工具行渲染爲卡片。卡片顯示委託的任務、實時狀態徽章（running / idle）、子代理 ID、已用時間以及是否生成了嵌套子代理。點擊卡片即可導航到該子代理的會話。

2. 浮動觸發器
   在右下角顯示一個浮動藥丸按鈕，計數當前會話的子代理數量。有子代理運行時，按鈕顯示紅點。點擊藥丸可查看子代理列表，點擊列表行可跳轉。

3. 命令行列表
   提供主機命令 /subagents，用於列出當前會話的直接子代理及其狀態、模式和標籤。

安裝與啓用¶

安裝插件需要 DSH Web 客戶端。執行以下命令安裝：

dsh plugin --profile web add github:BiKing567/dsh-subagent-panel

本地開發時，可以使用 link: 協議指向源碼目錄，修改後刷新頁面即可生效：

dsh plugin --profile web add link:/path/to/dsh-subagent-panel
dsh web

配置與使用¶

在 DSH 的 cordis 行配置中啓用插件，並設置最大消息行數（默認 500）：

- id: dsh-subagent-panel
  name: 'dsh-subagent-panel'
  config:
    maxMessages: 500

使用 /subagents 命令查看所有子代理的狀態。通過右下角的浮動藥丸或行內卡片點擊，可以在主對話視圖中直接跳轉並查看子代理的詳細日誌。

注意事項¶

• 環境要求：插件基於 DSH Web 客戶端開發，目標版本爲 dsh 0.1.0-rc.6。
• 依賴關係：客戶端包（@deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-locale, @deepseek-ai/dsh-client-ui-tool）爲可選的 peer 依賴，由 harness 在運行時注入，無需單獨安裝。
• 渲染機制：插件不記錄自己的對話，完全依賴 shell 的渲染邏輯來展示子會話，這通常比插件自繪的 transcript 更準確。