DeepSeek Harness (DSH) 的执行过程通常以日志或轨迹流的形式呈现。面对复杂的任务链路,快速定位关键步骤、错误点或执行耗时主导链变得困难。dsh-task-graph 插件将 DSH 单任务执行流程图谱化,让 Agent 的内部运行状态从“流水账”变成一张可交互的拓扑图。
插件简介¶
该插件由 KevinZhangNothing 维护,属于工作流类别。它以“Task”为第一层概念,进入任务后首先展示执行图谱,而非一长串日志。
核心功能¶
- Task First 与 Graph First:图谱由底层的 Trajectory 数据解析而来,聚焦于任务流转。
- Detail on Demand:画布只展示关键节点,具体执行细节(LLM 步骤、工具调用、输入输出)收进右侧详情面板。
- 关键节点视图:默认画布只显示 Turn(轮次)、代码改动、Plan/Skill/SubAgent/测试以及失败或重试事件。普通步骤隐藏,保持画面清爽。
- 多种布局:支持蛇形(默认)、DAG、时间线、力导向四种布局,适应不同的分析需求。
- 实时执行状态:通过 SSE 增量刷新,节点带有秒级计时和 LIVE 徽标,运行状态一目了然。
- 图谱 ↔ Trajectory 双向联动:点击图谱节点可跳转至轨迹详情,点击轨迹事件可反选图谱节点。
- 分析与定位:支持查看关键路径、错误定位、重试聚合以及任务摘要(耗时、Token、高频工具等)。
安装与启用¶
- 执行安装命令:
dsh plugin --profile web add github:KevinZhangNothing/dsh-task-graph
- 安装完成后重启引擎(或重新加载 Web UI)。
- 在「对话 / 轨迹」标签旁会出现第三个「图谱」Tab,点击进入。
典型用法¶
- 独立 Demo 测试:
npm run demo
打开浏览器访问 Demo 页面,查看内置数据或加载本地 `$DSH_HOME` 会话。
技术细节与注意¶
- 服务端需要 Node >= 22.15。
- 使用内置
zlib.zstdDecompressSync解码.zstd格式的会话文件。 - 插件零原生依赖。
该插件通过将抽象的执行过程具象化,帮助开发者更高效地进行调试与分析。更多详情与源码,可访问插件目录或 GitHub 仓库。