前言¶

在 DeepSeek Harness（DSH）裏處理智能體任務時，Session、delegated subagents、Agent Teams、Agent communication 和 Workflow 往往分散在不同狀態裏。如果只看單條消息或單個 Session，容易漏掉任務依賴、成員協作和 Workflow 運行進度。

dsh-task-dag 是一個 DSH Web 插件，維護者是 LeemanCheung。它把當前 DSH 已有的 Client projections 重建成三個可交互拓撲視圖：Overview、Agent Teams 和 Workflow。下面介紹它的定位、安裝方式、典型用法和使用邊界。

這是什麼¶

dsh-task-dag 的定位是：Live Agent Teams task, communication, subagent, and Workflow topology for DeepSeek Harness。

它解決的是當前 DSH Web 頁面裏的可視化問題：把當前 Session、ordinary delegated subagents、Team members and tasks、Agent communication 和 Workflow runs 放到同一張圖裏查看。插件不引入平行的 orchestration database，也不發送 polling requests；它依賴的是 DSH 已經擁有的 Client projections。

核心功能¶

Overview¶

Overview 視圖顯示以下內容：

• 當前 Session
• ordinary delegated subagents
• Team members and tasks
• Agent communication
• Workflow runs

這個視圖適合作爲入口，用來先確認當前 Session 周圍有哪些子代理、團隊任務和 Workflow 運行。

Agent Teams¶

Agent Teams 視圖顯示：

• Team Lead 和 teammates
• task assignment
• shared-task blockedBy DAG
• optional communication overlay

這裏有一個邊界：dsh-task-dag 可視化 Agent Teams records，但它不安裝、也不創建 Agent Teams runtime。Agent Teams 被描述爲 upstream experimental capability，並且 may not be mounted by every stock DSH Web profile。

另外，Host composition 必須先發出 supported Team events，Agent Teams 視圖裏才能出現數據。沒有這些事件時，這個視圖可能沒有可展示內容。

Workflow¶

Workflow 視圖顯示：

• durable Workflow run
• phase grouping
• started member Sessions

這裏的 phase edges 是 presentation grouping，不是 script dependency edges。換句話說，它們用於展示階段分組，不代表腳本執行依賴。

選擇一個 Workflow run node 後，可以打開 read-only definition inspector，查看 metadata、declared phases、完整 JavaScript body，並使用 copy control。定義預覽 deliberately 不投影 runtime args。

Agent communication¶

Agent communication channels 會聚合 message count 和 queued delivery state。

選擇一個 channel 後，可以查看 latest 100 message records，並看到 quiet/wakeup 和 delivery metadata。

導航與畫布¶

插件還支持下面這些交互：

• 可選擇 teammate、subagent 或 Workflow member node；當真實 Session 仍然可見於 Session list 時，可以直接打開該 Session。
• 畫布支持 fit 整張拓撲、pan original-size canvas，以及拖動節點；拖動節點時，connected edges 會同步更新。
• 當前 Session 內，per-view manual layout 在視圖切換和重新打開 panel 後保留；切換 Session、refresh 或 DSH restart 後，會恢復 automatic layout。
• 面板使用 DSH semantic theme tokens、accessible status labels、edge line styles、responsive communication details 和 reduced-motion behavior。

安裝與啓用¶

先按下面的命令安裝插件。該命令使用 DSH Web profile：

dsh plugin --profile web add github:LeemanCheung/dsh-task-dag

安裝完成後，重啓當前 DSH Web process 一次，然後刷新頁面。刷新後，Session header 中會出現 Task DAG action。

如果需要安裝固定版本 v1.4.0，使用下面命令：

dsh plugin --profile web add github:LeemanCheung/dsh-task-dag#v1.4.0

典型用法¶

下面步驟按當前 DSH Web Session 內的操作說明。

1、選擇 Task DAG，打開當前 Session 的 graph，並 refresh observed subagent catalogs。

2、在 Overview、Agent Teams 或 Workflow 之間切換拓撲。切換後，當前頁中其他視圖的 manual layout 不會被丟棄。

3、切換 message icon，用來顯示或隱藏 Agent communication。這一步不會改變 task layout。

4、選擇一個 communication edge，打開它的 directed message timeline。焦點位於 edge 上時，Enter 和 Space 都可以觸發。

5、選擇一個 Workflow run node，打開 read-only definition inspector，查看 metadata、declared phases、完整 JavaScript body 和 copy control。Enter 和 Space 受支持。

6、選擇一個 Agent node，如果它對應的 Session 在 Session list 中可用，就打開該 Session。Enter 和 Space 受支持。

7、拖動空畫布，用於 pan original-size canvas；拖動單個節點，用於調整該節點位置，同時 edges 保持同步。

8、如果要復現 Workflow 檢查：新建一個 top-level Session，從該 Session 調用 workflow tool，然後打開 Task DAG → Workflow。

適用場景與注意¶

這個插件適合在 DSH Web 中處理多個 subagents、Agent Teams 或 Workflow 的開發者使用。它更適合作爲查看工具，用來理解當前 Session 的拓撲、任務依賴、通信狀態和 Workflow 定義。

使用前注意以下幾點：

• 該插件通過 DSH 插件機制接入當前 Web 環境，並會隨當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• 對話框不會 trap focus，也不爲 panel、canvas 或 nodes 提供 keyboard dragging。
• Agent Teams 視圖的數據依賴 Host composition 發出 supported Team events。
• Workflow phase edges 只表示展示分組，不表示腳本依賴。
• Workflow definition preview 會顯示完整 JavaScript body，但不投影 runtime args。

結尾¶

dsh-task-dag 的價值，是把當前 DSH Web Session 裏的 subagent、Agent Teams、Agent communication 和 Workflow 放到同一張可交互圖上，減少在不同狀態視圖之間來回切換。

目錄頁是社區插件目錄，不是官方應用商店。

• 目錄頁：https://www.skillhub.cn/plugins/LeemanCheung/dsh-task-dag
• GitHub：https://github.com/LeemanCheung/dsh-task-dag