trajectory-clean：DeepSeek Harness 的清潔軌跡視圖插件

智能體開發者調試時，需要在海量消息中快速定位輸入、Token 消耗或工具調用細節。原始視圖往往缺乏結構化分組，難以一眼看清上下文。

trajectory-clean 是一個用於 DeepSeek Harness 的清潔軌跡視圖插件。它由 gaogx96 維護，旨在通過更整潔的界面和結構化的信息展示，解決軌跡查看時的信息過載問題。

核心功能¶

該插件通過標籤頁和分組的方式重構了會話視圖：

標籤頁集成：在會話頂部添加“軌跡”標籤頁，與原版“聊天”並列。
消息分組：按用戶消息分組，標題直接顯示輸入內容，便於快速定位。
類型標籤：每條消息顯示類型標籤（用戶/模型/工具/命令/錯誤等）。
Token 統計：顯示輸入、輸出和緩存命中（chip 標籤樣式）的 Token 消耗。
詳情展開：點擊展開查看文本、思考過程、工具參數與結果、Token 詳情、模型名稱和首 Token 延遲。
頂部概覽：提供總記錄數、輪次、輸入/輸出 Token、緩存、錯誤和工具調用的統計概覽。
主題適配：使用 --dsw-alias-* CSS 變量，適配所有主題（包括深海女僕皮膚等）。
極簡風格：界面無 emoji，無裝飾性 AI 元素，保持工具風格的乾淨。

安裝與啓用¶

支持三種安裝方式，根據你的項目結構選擇其一。

方式一：本地包安裝¶

將整個 trajectory-clean 目錄複製到你的項目目錄。
在 package.json 的 dsh.profile.bundles 數組中添加 "trajectory-clean"。

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "trajectory-clean"
      ]
    }
  }
}

重啓 dsh web 或刷新頁面。

方式二：NPM 安裝¶

發佈到 npm：

    npm publish

或其他用戶安裝：

    npm install trajectory-clean

在 web profile 的 package.json 中添加依賴和 bundle。

方式三：dshmarket 包¶

按照 dshmarket 規範打包。
發佈到 dshmarket 倉庫。
其他用戶通過 dshmarket 安裝。

典型用法¶

安裝後，在會話頂部點擊“軌跡”標籤頁：

快速定位：利用按用戶消息分組的標題，快速找到特定的輸入內容。
查看消耗：在概覽欄或消息行查看 Token 統計，包括緩存命中的情況。
深入調試：點擊任意消息展開，查看模型的思考過程、工具調用的具體參數與返回結果，以及首 Token 延遲等細節。

適用場景與注意¶

適用人羣：需要頻繁分析智能體運行軌跡、調試工具調用或監控 Token 消耗的開發者。
運行機制：插件運行時自動通過 useSession 讀取會話快照。
依賴項：依賴 @deepseek-ai/dsh-client-ui-conversation 和 @deepseek-ai/dsh-client-ui-trajectory。
許可協議：MIT 許可證。
安全提示：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。

總結¶

trajectory-clean 提供了一個結構化、低干擾的軌跡查看方案。它通過標籤頁、分組和清晰的信息層級，幫助開發者更高效地分析會話數據。