在 DeepSeek Harness (DSH) 的開發流程中，理解 AI 是如何一步步執行並生成結果的，是調試提示詞和優化模型行爲的關鍵。DSH 內置的“軌跡”標籤雖然記錄了事件，但以純文本列表爲主，難以直觀地把握整體時間流向，也難以快速定位某次請求的具體上下文。dsh-trajectory-traceview 插件將這一數據源渲染爲可視化的橫向時間軸，讓每一步操作、每次發給大模型的原始載荷都清晰可見。
功能特性¶
插件在 DSH Web GUI 的“軌跡”標籤旁新增了一個“軌跡視圖”標籤。它渲染了一個橫向時間軸，頂部附帶 minimap 總覽，底部包含步驟詳情和原始請求面板。
- 時間軸與總覽：時間軸按真實時鍾時間排列，頂部 minimap 使用顏色區分站點類型（用戶=藍、步驟=綠、工具=橙、壓縮=紫、錯誤=紅、重試=黃、命令=青）。點擊 minimap 上的色塊即可跳轉到對應站點。
- KPI 統計：頂部顯示輪次、步驟數、工具調用次數、錯誤數、總工具耗時、請求與生成 token 數，以及當前模型名稱。
- 搜索與回放：按
/聚焦搜索框，輸入工具名、參數、正文或錯誤名進行過濾，命中項會有金色描邊。支持鍵盤快捷鍵（◀/▶）和播放按鈕進行逐站瀏覽或自動回放（支持 1x/2x/4x 速度）。 - 步驟詳情：點擊任意站點，底部面板展示思考內容、工具參數、結果、子調用鏈、耗時和 token 用量。
- 原始請求分析：按
r切換到底部“原始請求”標籤，查看當次發給大模型的完整上下文，包括系統提示、工具目錄和重建的消息列表。面板還顯示提示詞變更（新增/移除的工具）和 token 用量明細。 - 導出：使用頭部工具欄中的 Markdown 圖標，將整個軌跡導出爲 Markdown 文件。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add github:AFAP/dsh-trajectory-traceview
安裝後，重啓 dsh web 即可生效。
典型用法¶
- 打開任意包含 AI 執行軌跡的會話。
- 點擊新增的“軌跡視圖”標籤。
- 瀏覽時間軸，點擊站點查看思考與工具調用詳情。
- 使用
/搜索特定工具名或錯誤信息。 - 按
r查看當次請求的詳細上下文，用於提示詞學習。 - 使用頭部 📋 按鈕導出整個軌跡爲 Markdown。
注意事項¶
本插件爲只讀工具，僅讀取 DSH Web 會話中已生成的 TrajectorySnapshot 快照進行渲染。它不會修改任何文件、訪問網絡或寫入本地存儲。所有數據處理均在瀏覽器本地完成，無持久化存儲。
更多信息請參閱項目倉庫：https://github.com/AFAP/dsh-trajectory-traceview
