任务拓扑图 LeemanCheung/dsh-task-dag

dsh-task-dag

DeepSeek Harness Web 的实时编排拓扑。
查看委派的会话、Agent Teams 任务依赖与通信，以及持久化工作流运行。

English · 中文

dsh-task-dag visual overview

一览

dsh-task-dag 把 DSH 已有的 Client 投影变成三个专注的图视图。它不额外维护一套编排数据库，也不发轮询请求：会话、Team、工作流状态都从 DSH 已有的投影重建。

| 视图 | 展示内容 |
| Overview | 当前会话、普通委派的子代理、Team 成员与任务、智能体通信、工作流运行。 |
| Agent Teams | Team Lead 与队友、任务分配、真实的共享任务 blockedBy DAG，以及可选的通信叠加层。 |
| Workflow | 持久化工作流运行、阶段分组、已启动的成员会话。阶段边只是展示分组，不是脚本依赖边。 |

其他行为：

- 智能体通信： 有向通道汇总消息数量和排队投递状态。选中某个通道，可以查看最近 100 条消息记录，含 quiet/wakeup 与投递元数据；只有文本块会预览，其他块类型只计数。
- 智能体运行时指标： 悬停或用键盘聚焦队友、子代理或工作流成员，即可查看最近一次请求的服务商、模型、DSH 实际生效的推理强度 ID（仅在持久记录存在时显示）、其记录来源，以及整个会话累计的输入、输出、缓存、轮次和步骤总量。由 DSH 从适配器默认值推导出的强度会标注为 Adapter default；否则已记录的强度标注为 Request config，但不声明它来自预设、插件、中间件、用户选择还是旧版适配器。请求未记录强度时，实际字段保持 Not recorded；公开模型的精确默认值可能出现在单独的参考行，绝不作为该次历史调用的证据。GPT-5.6 Terra 的 OpenAI API 模型页参考值为 medium；界面明确说明这不是请求记录。
- 直接导航： 选中队友、子代理和工作流成员节点，只要对应会话仍在会话列表中可见，就会打开真实会话。
- 工作流定义预览： 选中工作流运行节点，即可查看匹配的 workflow 工具调用中的完整 JavaScript 编排主体、定义摘要、使用指引和声明的阶段元数据。原生代码块可复制完整脚本；运行时 args 有意不投影。
- 画布控制： 适配整个拓扑、平移原始尺寸画布，或在连接边实时更新时拖动节点。
- 按视图布局： 手动位置在切换视图和重新打开当前会话面板后仍保留。切换会话、刷新页面或重启 DSH 会恢复确定性的自动布局。
- 原生呈现： 面板使用 DSH 语义主题 token、无障碍状态标签、边线样式、响应式通信详情和减少动态效果行为。
- 生命周期安全： 团队投影、语言环境、样式和 Slot UI 全部由 Cordis 插件生命周期管理。

实时截图

截取自运行中的 DSH Web 会话，标签已匿名化。面板、控件、布局和图形呈现均为实际链接的插件 UI。

dsh-task-dag running in DSH Web

选中工作流运行节点，即可在实时拓扑旁打开 v1.4.0 定义检查器：

Workflow definition code preview in dsh-task-dag

已验证的实时场景

除模型和 jsdom 检查外，v1.4.0 UI 已在真实 DSH Web 会话中实际运行：

| 场景 | 真实运行时活动 | 观察到的图形行为 |
| Agent Teams | Team Lead 创建了两个活跃队友、四个持久任务（覆盖已完成、进行中、已阻塞三种状态）、一条真实的 blockedBy 依赖，以及三条定向通信通道。 | Agent Teams 视图渲染出成员、任务分配和依赖边；排队与已送达的通道状态保持区分；选中某条通道会打开它的静默/唤醒消息时间线。 |
| Workflow | 顶层会话调用 workflow 运行 workflow-root-visual-validation：parallel-checks 启动 alpha-worker 和 beta-worker，随后 summary 启动 summary-worker。 | Workflow 视图渲染出一次运行、两个阶段分组和三个成员会话，共 7 个节点、6 条结构边。它从 summary 运行中更新到完整结果，无需刷新；选中该运行可恢复并复制真实的 9 行编排脚本。 |

Workflow 测试夹具返回 alpha-ok、beta-ok 和 summary-ok；两次检查期间浏览器控制台均报告零错误。会话标题栏徽章统计相关拓扑节点数，不含当前会话，而对话框总数包含该根节点。因此徽章显示 6 对应打开的 Workflow 图中的 7 个节点。

要复现 Workflow 检查，新建一个顶层会话，从该会话调用 workflow 工具，然后在同一会话中打开 Task DAG → Workflow。如果在子代理内调用 Workflow，请先打开那个子会话；父图会正确地把子会话显示为委派工作，而不是采用它内部的 Workflow 运行。

dsh-task-dag 可视化 Agent Teams 记录，但不安装或创建 Agent Teams 运行时。本次发布时，Agent Teams 是上游实验性能力，并非每个原版 DSH Web 配置档都会挂载。Host 组合必须先发出受支持的 Team 事件，Agent Teams 视图才能有数据。

安装

1.5.1 源码与 DSH 0.1.2-rc.1 接口兼容，使用该版本的 Session Controller、UI Renderer 和 uiConversation.events 注册表。已验证范围记录在 docs/compatibility-0.1.2-rc.1.md。缺失的服务商、模型或推理强度值会保持可见的缺失状态，而不会被默认值替换。

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

首次安装后重启当前 DSH Web 进程一次，然后刷新页面。Task DAG 操作会出现在会话标题栏中。

源码版本为 1.5.1；其发布标签尚未发布。如需固定安装，请使用以下现有提交：

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

使用图

| 操作 | 结果 |
| 选择 Task DAG | 打开当前会话的图，并刷新观测到的子代理目录。 |
| 选择 Overview、Agent Teams 或 Workflow | 切换拓扑，同时保留当前页面在其他视图下的手动布局。 |
| 切换消息图标 | 显示或隐藏智能体通信，不改变任务布局。 |
| 选择一条通信边 | 打开其有向消息时间线。聚焦到边后，Enter 和 Space 可用。 |
| 选择一个 Workflow 运行节点 | 打开其只读定义检查器，包含元数据、声明的阶段、完整 JavaScript 主体和复制控件。支持 Enter 和 Space。 |
| 选择一个 Agent 节点 | 当该会话在会话列表中可用时，打开对应会话。支持 Enter 和 Space。 |
| 拖动空白画布 / 拖动节点 | 平移原始尺寸画布，或重新排列单个节点，边保持同步。 |
| 切换适配模式 | 在整图概览与原始可滚动画布之间切换。 |
| 刷新 | 刷新子代理目录；Team 和 Workflow 节点仍由投影驱动。 |
| 按 Escape 或选择关闭 | 关闭面板，并将焦点恢复到触发元素。 |

对话框不捕获焦点，也不为面板、画布或节点提供键盘拖动。

架构

dsh-task-dag projection architecture

插件组合了六个持久投影和面向客户端的来源：

- Host 侧的 taskDagAgentMetrics 会话投影只折叠最新的 request/header 服务商、模型、具体生效的 reasoning-effort ID，以及 adapterDefaults.reasoningEffort 来源标记。DSH 的 tokenUsage 和 sessionStats 投影提供全日志累计值。
- SessionListState.byId 和 parentId 提供普通子代理的谱系。
- SessionListState.subagentsByParent 提供标签、模式、活动和目录健康状态。
- 持久 Agent Teams 事件提供成员、共享任务、排队消息和投递确认。
- workflow-run Conversation Nodes 提供 Workflow 运行、阶段分组、成员和结果。
- 匹配的 tool-call Conversation Nodes 提供已经可见的原始 workflow 输入。插件只解析其脚本和定义元数据，然后按事件顺序关联到最近的同名运行。

包自有的隐藏 Conversation Node Definition 将每个受支持的 Team v1 事件投影为一个小型快照节点。图模型折叠最新的任务/成员状态，匹配消息投递确认，聚合有向通信通道，构造显式的多父边，并应用确定性的非递归拓扑布局。UI 在 conversation.session.header.actions 中渲染结果。

没有模型提示词贡献、模型工具、Host RPC 端点、网络请求、轮询循环或第二持久层。

投影边界

- Agent Teams 会把任务面板和消息日志写入 Team Lead Session。队友 Session 无法跨 Session 读取这份日志，所以它的 Team 视图会链接回可见的父 Session，而不是新增一个跨 Session 的 Host RPC。
- 运行时指标来自已注册的全日志投影。Token 值是累计值。Provider、model 和 reasoning effort 取自 DSH 归一化请求头中的最新值；它们不是 reasoning token 计数，也不是 Provider 的原始线上参数。只有当持久化请求头记录了该标记时，才会显示 Adapter default。src/reasoning-defaults.js 收录了带来源标注的公开引用，用于精确路由，但这些引用永远不会替代缺失的请求值或服务响应。
- blockedBy 是唯一被呈现为真实 Team 任务依赖的边。通信可以是双向的，也可以成环，所以它只是一层叠加视图，绝不参与 DAG 分层。
- 持久化的 Workflow 阶段是进度分组。它们不会揭示完整的内部 parallel() 或 pipeline() 控制流，也不会被标注为执行依赖。
- 定义预览要求匹配的 workflow 工具调用头仍留在当前 Session 窗口内。如果压缩或截断把它移除了，持久化的运行拓扑仍然可见，检查器会说明该定义不可用；插件绝不会猜测或重建缺失的代码。
- 普通血缘必须通过 origin: "subagent" 追溯到当前 Session。孤儿节点、缺失父节点的链条和血缘环都会被忽略。畸形的依赖环会获得一个确定性的兜底层，而不是阻塞渲染。
- 同一个 Session 可能同时出现在 Team 和 Workflow 上下文中，因为这些节点传达的所有权语义不同；所有出现位置都会导航到同一个 Session ID。

安全与权限

这是一个只读可视化插件。Host 侧只把 Provider、model、reasoning effort 及其来源从 request/header 折叠进一个很小的 Session 投影；Client 侧可以添加一条清晰分隔的引用，来自经过审计的静态 Provider 默认值表。插件不会读取工作区文件、执行命令、建立网络连接、注册模型工具，也不会持久化新的 Session 内容或凭据。消息预览和 Workflow 代码只来自当前 Session 中已经可见的记录，并在用户选择某个通信通道或 Workflow 运行后按需显示。运行时 Workflow 的 args、系统提示词和工具 schema 都被排除在指标投影之外。

报告策略和完整信任边界见 SECURITY.md。仓库已启用私密漏洞报告。

开发

运行时包声明要求 Node.js 20+。开发和固定版本的 jsdom 测试栈请使用 Node.js 20.19+、22.13+ 或 24+；CI 目前运行 Node.js 22。

npm install
npm run check
检查流水线会校验所有源码语法；测试会请求 config 配置、Adapter 默认值、分离的 public 默认引用、未记录、旧版以及相互矛盾的推理证据，Team 事件投影，任务与通信折叠，Workflow 定义提取与运行匹配，Workflow 分组，任意 DAG 布局，深层谱系，以及循环回退；重新构建 Host 与浏览器产物；然后跑 jsdom 交互覆盖，涵盖三个视图、指针与键盘 Agent 指标、滚动后聚焦、窄视口、不可导航的 Agent 节点、通信时间线、Workflow 代码检查器、画布控件、各视图节点位置，以及 Session 导航。CI 会拒绝已提交的 Host 与浏览器输出出现漂移。

这些是纯模型与 jsdom 检查，不是完整的 DSH Web E2E 环境。发布前，还会在真实浏览器中针对运行中的 Web 配置档额外验证链接的包。

scripts/build.mjs 会把 src/index.js 和 src/reasoning-defaults.js 复制到 Host 的 lib/ 条目，然后把同一个 reasoning-default 解析器，加上 src/team-projection.js、src/workflow-definition.js、src/graph-model.js、src/client.js 和 src/style.css，一起嵌入已提交的 lib/client.js。不要直接编辑生成的文件。

故障排查

| 现象 | 检查项 |
| Task DAG 缺失 | 确认当前是 Web 配置档，重启 dsh web，然后刷新页面。 |
| 队友 Session 中 Team 视图为空 | 打开 Team Lead/父 Session；共享的任务与消息日志在那里。 |
| Team Lead Session 中 Team 视图为空 | 确认 Host 配置档挂载了 Agent Teams 服务商，并且已发出受支持的 Team 事件；这个可视化插件不会创建 Teams。 |
| Workflow 视图为空 | 打开调用 workflow 的那个确切 Session。父 Session 不会投影子 Session 内部的 Workflow 运行。 |
| Workflow 定义不可用 | 持久化运行还在，但它匹配的工具调用头部在当前 Session 窗口之外。有未裁剪的源 Session 时请打开它；缺失的代码永远不会被重建。 |
| 节点无法打开 | 只有仍显示在 DSH Session 列表中的 Session 才可导航。 |
| 子状态或标签看起来过期 | 选择 Refresh 刷新已观测到的子代理目录。 |

移除

dsh plugin --profile web remove dsh-task-dag

许可证

MIT © LeemanCheung