前言¶

在 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