DSH Trajectory Tracker ⏱️

让你更清楚地了解，究竟是什么占据了你的等待耗时。

English | 简体中文

专为 DeepSeek Harness (DSH) WebUI 量身打造的轻量级、零侵入执行轨迹与实时时序追踪插件。帮助你在任务生成期间，实时透视大模型的思考准备（首包等待）、流式推理生成以及本地工具调用的每一个关键步骤与耗时细节。

---

🚀 快速开始 (Quick Start)

1. 安装插件

在您的 DSH Web Profile 目录下执行安装：

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

2. 在配置中声明激活

确认 ~/.dsh/profiles/web/package.json 已声明插件：

{
  "dependencies": {
    "dsh-plugin-trajectory-tracker": "^1.0.1"
  },
  "dsh": {
    "bundle": {
      "plugins": [
        "dsh-plugin-trajectory-tracker"
      ]
    }
  }
}

3. 启动并体验

dsh web

浏览器访问 http://127.0.0.1:3080 刷新页面即可立即生效！

---

🌟 核心特性

• 两段式调用细化拆解：精准拆解每次模型调用的 首包等待（首包等待，TTFT / 思考准备就绪） 与 流式生成中（生成中，思维链推演与正文生成） 两个独立生命周期。
• 双响应式实时计时器：任务生成中状态栏实时呈现 (当前步耗时 / 总累计耗时)（如 第 2 次调用 · 生成中 (3.8s / 9.7s)），双数字以 150ms 频率毫秒级平滑递增。
• 悬浮式不占空间弹窗（Zero Space Occupation）：基于 React Portal 挂载在 body 顶层，展开和收起完全脱离消息文档流，绝不挤压、不推挤上方任何聊天消息空间。
• 置顶吸附操作重点提示卡：鼠标悬停在工具条目上 120ms 极速在卡片正上方弹出精致白底小方框，一眼看清调用的核心指令或目标文件，0 像素占用内部滚动容器，彻底杜绝横向滚动条。
• 并发工具智能归组：精准识别单次调用并发派发的多个并行工具（Parallel Tools），不误插多余的调用序号。
• 新步骤自动平滑跟滚：当过程条目超出容器高度时，列表自动自然滑向最底部，确保当前最新动态时刻处于第一视线内。
• 沙箱级防白屏隔离：内置 React ErrorBoundary 错误边界，完全不碰官方核心包一行源码，绝不引发界面崩溃白屏。

---

🖼️ 界面预览

1. 实时执行态与悬浮轨迹小窗

生成中的双响应式计时 (3.8s / 9.7s)、实时轨迹列表，以及鼠标悬停时顶部吸附展示的操作重点卡片：

2. 任务完成态全景轨迹回溯

回答完成后，点击右下角的 用时 13秒 胶囊，随时回溯查看包含两段式细化与每步精确耗时的完整轨迹：

---

📄 开源许可 (License)

MIT License © 2026 hirohana77