前言¶
DSH 的插件生態允許在 Web 會話中疊加不同視圖。已有軌跡視圖通常用於查看原始 Trajectory,當事件較多時,按動作類型定位記錄或理解問題到方案的調用鏈,仍需要反覆展開和篩選。dsh-client-ui-trajectory-categories 是一個純客戶端 DSH Web 插件,它在保留原始軌跡列表的基礎上,將軌跡整理爲中文優先、零額外 token 的分類、合計和畫布視圖。
這是什麼¶
dsh-client-ui-trajectory-categories 由 QWQ-nn 維護,許可證爲 MIT。插件定位爲 DSH Web 的 client-side 插件,用於把 raw trajectory 轉成中文優先、零 token 的摘要視圖。
它會複用 @deepseek-ai/dsh-client-ui-trajectory 提供的 trajectory 視圖投影,同時依賴 @deepseek-ai/dsh-client-runtime 和 @deepseek-ai/dsh-client-ui-conversation。插件主體面向瀏覽器端,lib/index.js 是 host-side no-op。
核心功能¶
新增「分類」標籤頁¶
安裝後,會話頭部會出現「分類」(Categories) 標籤頁。原始 Trajectory 列表保持不變。
「合計」面板¶
「合計」(Summary) 面板位於左上角,按動作類型統計記錄:寫入/讀取/刪除/下載/命令/搜索/子代理/其他工具/消息/壓縮。
分類標籤始終爲中文,並支持中文與英文工具名/術語匹配。面板中按分類展示記錄;點擊分類 chip 可展開該分類記錄,再次點擊該 chip 或點擊 × 可清除/收起。點擊記錄可查看參數 (args)、結果 (result)、錯誤 (error)。
思維導圖畫布¶
畫布按「問題 → 方案 → 工具調用」重建軌跡。一次展示一個問題,其他問題通過「問題畫布」標籤切換。
在畫布中可以點擊問題節點展開/收起其子流程,點擊方案 pill 展開/收起工具調用鏈,點擊工具 chip 打開詳情面板。詳情面板可查看做了什麼、輸出/日誌、修改內容、參數、錯誤。
畫布支持拖拽平移、Ctrl + wheel 或縮放按鈕縮放、節點拖動與慣性連線。
零額外 token 消耗¶
該插件只做客戶端聚合,不發起模型請求,也不做 LLM 摘要,因此不產生額外 token 消耗。它複用 ui-trajectory 的 trajectory 視圖投影,不重新處理事件流。默認按懶加載和按需渲染,每類先加載 40 條記錄。
安裝與啓用¶
使用安裝命令:
dsh plugin --profile web add dsh-client-ui-trajectory-categories
安裝後重啓 dsh web 服務並刷新頁面,會話頭部會出現「分類」標籤。
如果希望手動控制 patch 層,可以按下面的方式安裝。
1、將包放入目標 profile 的 node_modules 目錄,例如(以實際 profile 路徑爲準):
~/.dsh/profiles/node_modules/dsh-client-ui-trajectory-categories
2、在目標 profile 的 cordis.patch.yml 中追加該插件配置:
- insert:
- id: ui-trajectory-categories
name: 'dsh-client-ui-trajectory-categories'
3、重啓 dsh web 並刷新頁面。
典型用法¶
先完成安裝並刷新頁面,然後在會話頭部點擊「分類」。
1、在「合計」面板中點擊分類 chip,展開該分類記錄;再次點擊該 chip 或點擊 × 可清除/收起。
2、點擊某條記錄,查看參數 (args)、結果 (result)、錯誤 (error)。
3、切換到「問題畫布」標籤,查看不同問題對應的畫布。
4、點擊問題節點,展開/收起其子流程。
5、點擊方案 pill,展開/收起工具調用鏈。
6、點擊工具 chip,打開詳情面板,查看做了什麼、輸出/日誌、修改內容、參數、錯誤。
7、拖拽畫布平移,使用 Ctrl + wheel 或縮放按鈕縮放,拖動節點並觀察慣性連線。
適用場景與注意¶
這個插件適合在 DSH Web 會話較長、需要快速查看動作統計、工具調用細節、問題與方案關係時使用。它不會改變原始 Trajectory 列表,也不依賴模型請求。
安裝前建議先檢查源碼與許可證。該插件以當前 dsh 進程權限運行,屬於 browser-only/client-side 插件,lib/index.js 爲 host-side no-op。許可證爲 MIT,維護者爲 QWQ-nn。依賴項包括:
@deepseek-ai/dsh-client-ui-trajectory@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-conversation
鏈接¶
GitHub 倉庫:
https://github.com/QWQ-nn/dsh-client-ui-trajectory-categories
目錄頁:已覈實資料未提供具體目錄頁 URL;不要把 DSH 社區目錄理解成官方應用商店。如需查看目錄頁,請在 DSH 社區目錄中按插件名 dsh-client-ui-trajectory-categories 檢索。