LeemanCheung/dsh-task-dag

dsh-task-dag

DeepSeek Harness Web 的实时编排拓扑。
查看委派 Session、Agent Teams 共享任务与通信，以及持久 Workflow 运行。

English · 中文

一览

dsh-task-dag 将 DSH 已有的 Client 投影组织为三个专项图视图。插件不维护另一套编排数据库，也不发送轮询请求；Session、Team 和 Workflow 状态均由 DSH 已拥有的投影重建。

其他能力：

• Agent 通信： 按“发送方 → 接收方”聚合方向、消息数和待投递状态；点击通信边可查看最近 100 条消息的 quiet/wakeup 与投递元数据。界面仅预览文本 block，其他 block 只统计类型。
• Agent 运行指标： 鼠标悬浮或键盘聚焦 teammate、子代理和 Workflow 成员节点时，显示最近一次请求的 Provider、模型、已持久记录的 DSH 有效思考深度具体级别及其来源，以及完整 Session 的累计输入、输出、缓存读写 Token 和轮次统计。DSH 明确标记由 Adapter 默认值物化的级别显示为“Adapter 默认”；其余已记录级别显示为“请求配置”，不臆断它来自 preset、插件、中间件、用户选择还是旧版 Adapter。请求省略级别时，实际字段仍显示“未记录”；公开模型默认只在单独的参考行展示，不能冒充该次历史调用的证明。GPT-5.6 Terra 的 OpenAI API 模型页参考是 medium；界面会明确标注它不是本次请求记录。
• 直接导航： 可点击的 teammate、子代理和 Workflow 成员节点会打开真实 Session，前提是该 Session 仍显示在 Session 列表中。
• Workflow 定义预览： 点击 Workflow run 节点，可查看与其匹配的 workflow 工具调用中的原始 JavaScript 编排代码、定义说明、适用场景与阶段声明；原生代码块支持复制完整脚本，运行时 args 则不会被投影。
• 画布控制： 可适应全图、平移原始尺寸画布，或拖动节点并实时更新连线。
• 分视图布局： 当前 Session 的三个视图分别保留手工位置；切换视图或关闭再打开面板不会丢失。切换 Session、刷新页面或重启 DSH 后恢复确定性的自动布局。
• 原生呈现： 使用 DSH 主题语义 Token、状态文字与线型、响应式通信详情和 reduced-motion 行为。
• 生命周期安全： Team 投影、词典、样式与 Slot UI 均由 Cordis 插件生命周期托管。

实际运行截图

截图来自正在运行的 DSH Web Session，标签已经匿名化；面板、控件、布局和图形呈现均为已链接插件的真实界面。

点击 Workflow run，即可在实时拓扑旁打开 v1.4.0 定义详情：

真实会话验证

除了模型与 jsdom 检查，v1.4.0 界面还在真实 DSH Web Session 中完成了以下验证：

Workflow 验证分别返回 alpha-ok、beta-ok 和 summary-ok；两项验证期间浏览器控制台均为 0 error。Session 标题栏徽标只统计关联拓扑节点，不包含当前根 Session；弹窗总数则包含根节点，因此徽标 6 对应打开后的 7 个 Workflow 节点。

如需复现 Workflow 验证，请新建一个顶层 Session，在该 Session 中调用 workflow 工具，再在同一 Session 打开“任务 DAG → Workflow”。如果 Workflow 在子代理中发起，需要先打开该子 Session；父图会正确地把它显示为委派工作，而不会接管其内部 Workflow run。

dsh-task-dag 只可视化 Agent Teams 记录，不负责安装或创建 Agent Teams 运行时。本版本发布时 Agent Teams 仍是上游实验能力，并非所有标准 DSH Web profile 都会挂载；Host composition 必须先产生受支持的 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。Provider、模型或思考强度没有被持久请求头记录时，界面继续明确显示缺失，不会补默认值。

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

首次安装后重启一次当前 DSH Web 进程并刷新页面，随后可在 Session 标题栏看到“任务 DAG”入口。

当前源码版本为 1.5.1，对应 tag 尚未发布。需要固定安装时，可使用以下已存在的提交：

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

使用任务图

对话框没有焦点陷阱，也不支持通过键盘拖动面板、画布或节点。

架构

插件组合六类持久投影与 Client 数据源：

• Host 侧 taskDagAgentMetrics Session 投影只折叠最近一个 request/header 的 Provider、模型、有效思考深度具体级别和 adapterDefaults.reasoningEffort 来源标记；DSH 的 tokenUsage 与 sessionStats 投影提供完整日志累计值。
• SessionListState.byId 与 parentId 提供普通子代理血缘。
• SessionListState.subagentsByParent 提供标签、模式、活动状态与目录健康信息。
• 持久 Agent Teams 事件提供成员、共享任务、排队消息与投递回执。
• workflow-run Conversation Node 提供 Workflow 运行、阶段分组、成员与结果。
• 与运行匹配的 tool-call Conversation Node 提供当前 Session 已可见的原始 workflow 输入；插件只解析脚本与定义元数据，再按名称和事件顺序关联最近的同名 run。

插件拥有的隐藏 Conversation Node Definition 会把每个支持的 Team v1 事件投影为小型快照节点。图模型折叠最新成员和任务状态、匹配消息投递回执、聚合定向通信、构建显式多入边，并应用确定性、非递归的拓扑布局；UI 最终渲染到 conversation.session.header.actions。

整个过程不存在模型 Prompt 注入、模型 Tool、Host RPC 端点、网络请求、轮询循环或第二套持久层。

投影边界

• Agent Teams 将任务板和消息日志写入 Team Lead Session。Teammate Session 无法跨 Session 读取 Lead 日志，因此 Team 视图会引导打开可见的父 Session，而不是新增跨 Session Host RPC。
• 运行指标来自已注册的完整日志投影：Token 为累计值；Provider、模型与思考深度来自 DSH 归一化后的最近一次请求头，不等于推理 Token 数或 Provider 原始 wire 参数。只有持久请求头明确记录来源标记时才显示“Adapter 默认”。src/reasoning-defaults.js 只提供带公开来源与核验日期的精确路由参考，绝不替换缺失的请求值或服务端回执。
• 只有 blockedBy 显示为真实 Team 任务依赖。通信可能双向成环，因此只作为覆盖层，永不参与 DAG 分层。
• 持久 Workflow 阶段是进度分组，不能恢复脚本内部完整的 parallel() 或 pipeline() 控制流，界面不会将其标记为执行依赖。
• 定义预览要求对应 workflow 工具调用头仍位于当前 Session 窗口。若压缩或截断移除了调用头，持久运行拓扑仍会显示，详情中则明确提示定义不可用；插件不会猜测或重建缺失代码。
• 普通血缘必须通过 origin: "subagent" 追溯到当前 Session；孤儿、缺失父节点的链路和血缘循环会忽略。异常依赖环会进入确定性的兜底层，而不会阻塞渲染。
• 同一个 Session 可以同时出现在 Team 与 Workflow 上下文中，因为两种节点表达不同的归属语义；它们都会导航到同一个 Session ID。

安全与权限

这是一个只读可视化插件。Host 侧仅将 request/header 中的 Provider、模型、思考深度及来源折叠为小型 Session 投影；Client 侧读取该投影与 DSH 已有的 Token/会话统计，并可增加一行明确分隔的静态公开默认参考。插件不读取工作区文件、不执行命令、不发起网络连接、不注册模型工具，也不持久化新的 Session 内容或凭据。消息摘要和 Workflow 代码只来自当前 Session 已可见的记录，并且仅在用户选中通信链路或 Workflow run 后按需显示；运行时 Workflow args、系统 Prompt 和工具 Schema 不进入指标投影。

安全报告方式与完整信任边界见 SECURITY.md。仓库已启用私密漏洞报告。

开发

运行时软件包声明 Node.js 20+。开发和锁定的 jsdom 测试栈应使用 Node.js 20.19+、22.13+ 或 24+；CI 当前使用 Node.js 22。

npm install
npm run check

检查流程会校验全部源码语法；测试请求配置、Adapter 默认、分隔展示的公开默认参考、未记录、旧版和矛盾思考深度证据，以及 Team 事件投影、任务和通信折叠、Workflow 定义提取与运行匹配、Workflow 分组、任意 DAG 布局、深层血缘与异常环降级；重建 Host 与浏览器产物；随后用 jsdom 覆盖三视图、鼠标与键盘 Agent 指标、滚动后焦点、窄屏、不可导航 Agent 节点、通信时间线、Workflow 代码详情、画布控件、分视图节点位置及 Session 导航。CI 会同时拒绝 Host 与浏览器 lib/ 生成漂移。

这些是纯模型与 jsdom 检查，而不是完整的 DSH Web E2E 环境。发布前还会在真实浏览器中验证当前 Web profile 的链接安装。

scripts/build.mjs 会把 src/index.js 与 src/reasoning-defaults.js 复制到 Host 的 lib/ 入口，并把同一默认值解析器连同 src/team-projection.js、src/workflow-definition.js、src/graph-model.js、src/client.js 和 src/style.css 嵌入已提交的 lib/client.js。不要直接修改生成文件。

排障

卸载

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

许可证

MIT © LeemanCheung