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
