DeepSeek Harness 实时轨迹追踪插件介绍

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在开发或调试智能体工作流时，开发者往往需要明确模型推理的耗时分布，特别是首包等待（TTFT）与流式生成的时间占比。本文介绍一款名为 dsh-plugin-trajectory-tracker 的插件，它能在 DSH WebUI 中实时展示执行轨迹与耗时细节。

插件定位¶

该插件由 hirohana77 维护，是一个针对 DSH WebUI 的实时时序轨迹与执行过程追踪工具。

核心功能¶

插件提供以下七个主要能力：

两段式调用细化拆解：将模型调用过程拆解为“首包等待”与“流式生成”两个独立生命周期，便于分析性能瓶颈。
双响应式实时计时器：状态栏实时显示 (当前步耗时 / 总累计耗时)，数据以 150ms 频率毫秒级平滑递增。
悬浮式不占空间弹窗：基于 React Portal 挂载在 body 顶层，展开和收起完全脱离消息文档流，不挤压上方聊天消息空间。
置顶吸附操作重点提示卡：鼠标悬停在工具条目上时，在卡片正上方弹出核心指令或目标文件信息，不占用内部滚动容器宽度。
并发工具智能归组：精准识别单次调用并发派发的多个并行工具，避免误插多余的调用序号。
新步骤自动平滑跟滚：当轨迹列表超出容器高度时，自动滑向底部，确保当前最新动态时刻处于第一视线内。
沙箱级防白屏隔离：内置 ErrorBoundary 错误边界，不修改官方核心包源码，防止界面崩溃白屏。

安装与启用¶

安装过程需要进入 DSH Web Profile 目录进行操作。

安装依赖
在终端中执行以下命令：

    cd ~/.dsh/profiles/web && npm install dsh-plugin-trajectory-tracker

配置激活
编辑 ~/.dsh/profiles/web/package.json，在 dsh.bundle.plugins 数组中声明插件：

    {
      "dsh": {
        "bundle": {
          "plugins": [
            "dsh-plugin-trajectory-tracker"
          ]
        }
      }
    }

启动服务
执行 dsh web 命令启动服务，并在浏览器访问 http://127.0.0.1:3080 刷新页面即可生效。

典型用法¶

启动 DSH 并发起一次包含工具调用的对话。在生成过程中，观察状态栏的实时计时数据以及下方的轨迹列表。当鼠标悬停在具体的工具条目上时，顶部会自动吸附显示该步骤的详细操作信息。

适用场景与注意事项¶

该插件适合需要精细化分析智能体工作流耗时分布、排查工具调用卡顿或优化首包响应时间的开发者。

使用时需注意：
* 插件必须在 DSH Web Profile 目录下安装。
* 必须在 package.json 中显式声明插件配置。
* 插件基于社区目录开发，与 DeepSeek 官方无隶属关系，使用前建议确认源码与许可证。

总结¶

dsh-plugin-trajectory-tracker 为 DSH 生态提供了一套轻量级的调试视图方案，帮助开发者清晰透视大模型的思考准备与执行过程。

更多细节与源码可访问：GitHub