前言¶
DeepSeek Harness（DSH）支持插件化扩展。在调试智能体或复杂工作流时，仅依赖内置的文本或表格视图查看轨迹往往不够直观，难以快速定位工具调用逻辑或模型决策路径。TangRj-Git/trajectory-graph 插件在 DSH 默认的 Chat 和 Trajectory 视图旁增加了一个 Graph 标签页，将结构化的轨迹快照投影为可交互的从左至右执行图。
该插件完全在本地运行，不上传轨迹数据，不修改会话历史，旨在帮助开发者以图形化方式梳理执行流。
插件简介¶
- 插件名称: dsh-plugin-trajectory-graph
- 仓库地址: https://github.com/TangRj-Git/trajectory-graph
- 维护者: TangRj-Git
- 许可证: MIT
- 核心价值: 将 DSH 的结构化轨迹快照转换为可视化的执行拓扑图，支持节点级详情查看与交互。
核心功能¶
该插件提供以下功能来辅助轨迹分析：
- Turn 导航与选择: 支持独立选择每个回合的图表，默认选中最新回合。通过 Turn 导航器可隔离单个用户请求，避免历史记录干扰。
- 语义化节点展示: 展示语义化的节点类型，包括用户、上下文、模型、工具、工具组、子工具、Agent、Final、Retry 和 Error 节点。
- 工具调用可视化: 工具调用以垂直分支形式呈现，并在后续的模型或 Final 节点处收敛。
- 交互操作: 支持搜索、类型过滤、折叠/展开、缩放以及适应视图。
- 节点详情: 点击任意节点可查看结构化详情。工具节点特别展示 Payload、Result、Schema、Timing 等数据。
- 实时更新: 运行会话时图表实时更新，流式文本变化时保持布局稳定。
- 隐私安全: 纯本地可视化，不上传轨迹数据，不调用外部分析服务。
安装与启用¶
安装前请确保环境满足以下要求：
- Node.js 20 或更新版本
- pnpm 10 或更新版本
- DeepSeek Harness 0.1.0-rc.6 或 0.1.0-rc.7
- 从 GitHub Releases 下载
dsh-plugin-trajectory-graph-0.3.0.tgz文件，并保持在本地目录中。 - 执行以下命令将插件安装到默认的 Web 预设中（请替换为实际文件路径）：
npx --yes @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile web add "C:\path\to\dsh-plugin-trajectory-graph-0.3.0.tgz"
安装成功后，会话重启即可生效。
典型用法¶
- 启动默认 Web 预设：
npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web --port 3080
- 在浏览器中打开
http://127.0.0.1:3080，选择一个包含轨迹数据的会话。 - 在顶部标签页切换到
Chat / 对话 | Trajectory / 轨迹 | Graph / 图谱。 - 使用左侧的 Turn 导航器选择特定回合，或点击空白画布拖动以平移，滚动滚轮以缩放。
- 点击任意节点，在详情面板中查看 Payload、Result 或 Timing 等信息。
注意事项与局限¶
- 查看器定位: 这是一个执行查看器，而非可编辑的工作流设计器。它不会修改提示词或会话历史。
- Agent 推断限制: 当前版本不推断 Agent 分支。由于 Harness 不提供持久化身份，插件无法根据工具名或模型文本推断 Agent 路径。
- 性能考虑: 历史记录过大时图表可能过宽，建议使用回合导航、搜索或折叠功能进行查看。
- 数据依赖: 没有结构化轨迹快照的会话无法生成图节点。
- 隐私: 插件完全在本地运行，不会上传轨迹数据。
结语¶
TangRj-Git/trajectory-graph 插件通过提供可视化的执行拓扑图，解决了 DSH 用户在分析复杂工具调用和模型决策路径时的痛点。结合 Turn 导航器和节点详情查看，它能够显著提升调试效率。更多细节与源码请参考 GitHub 仓库。
