前言¶
DeepSeek Harness 的「预设」本质上是一份插件清单，决定了 Agent 有哪些工具、技能和子 Agent。通常这份清单只能通过查看 YAML 文件来了解，执行流程和组件构成较为抽象。agent-preset-graph-xww 插件将这份清单画成一张 ComfyUI 风格的节点图，展示 Agent 的组成与实时执行状态。
该插件由 laojingwei 维护，开源协议为 MIT。它运行在 Web 客户端，不修改 Host 状态，仅通过读取现有服务数据来呈现可视化视图。
核心功能¶
- 节点图展示：将 Agent 预设画成 ComfyUI 风格的节点图，左侧为任务入口，中间为各类能力块，右侧为执行循环。
- 实时高亮：实时高亮当前正在执行的节点，并显示工具名称、运行时长、轮次以及当前会话使用的预设。
- 能力块与部署级插件：展示预设声明的各类能力块（按包名归类），以及部署级插件（不属于预设但可用的插件）。
- 节点详情：点击节点可查看详情（ID、模块、状态、启用条件、统计信息）。
- 交互与导出：支持节点搜索、折叠/展开、自动跟随执行节点，以及导出节点图为 PNG 图片。
安装与启用¶
使用 DeepSeek Harness 的插件管理命令安装。安装后重启 DSH 服务生效。
dsh plugin --profile web add agent-preset-graph-xww
如果目标插件尚未发布到 npm，也可以通过 GitHub 仓库或本地路径安装：
# 从 GitHub 仓库安装
dsh plugin --profile web add github:laojingwei/agent-preset-graph-xww
# 本地工作副本安装
dsh plugin --profile web add link:D:/path/to/agent-preset-graph-xww
使用方法¶
安装完成后，在任意会话的对话页标签栏会出现第三个标签：对话 | 轨迹 | 节点图。
- 查看预设组成：在“节点图”标签页中查看 Agent 预设的完整结构。
- 查看详情：点击任意节点，下方会展开显示该节点的详细信息和本轮统计。
- 搜索与过滤：使用工具栏的搜索功能，按名称、模块或条目 ID 过滤节点，命中的节点会高亮显示。
- 定位与跟随：使用“定位”功能手动跳转到特定节点；默认开启的“自动”功能会跟随当前执行的节点移动画布。
- 导出图片：点击“导出”按钮，将当前节点图保存为 2 倍分辨率的 PNG 图片。
依赖与兼容性¶
- 平台：Web（DSH Web GUI）。
- DeepSeek Harness 版本：≥ 0.1.7-rc.2。
- 依赖服务：插件依赖
slots、locale、sessions、remote.pluginInventory四项服务，缺少任一服务时插件不会激活。 - 配置要求：无需额外配置。
注意事项¶
- 工具映射限制：工具到节点的映射仅覆盖 DSH 内置工具，第三方工具依赖模糊匹配，名称与包名无关时可能无法精确高亮。
- 预设组成来源：预设组成来自 Plugin Inventory 的扁平化结果，Loader 的 group 层级不会体现在图上。
- 高亮统计范围：高亮统计仅基于当前轮次，超出事件窗口的老调用不会计入。
- 权限范围：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
结尾¶
预设节点图通过可视化的方式，将 DeepSeek Harness 中抽象的预设配置转化为直观的节点结构，辅助开发者理解 Agent 的组成与执行流。对于需要监控 Agent 实时行为或梳理预设结构的开发者，该插件提供了实用的调试视图。
