DeepSeek Harness 的核心理念是“一切皆插件”。隨着插件、技能和工具的積累,環境會變得難以管理:依賴關係隱藏,AI 行爲是黑盒,喫灰插件堆積。該插件通過一張圖譜看懂全局,一條軌跡看懂每一輪。
核心功能¶
力導向圖譜
插件、技能和工具以節點形式呈現,配合絲滑的物理仿真佈局。依賴關係(depends)以連線表示,“全家桶包含關係”(contains)用凸包氣泡圈成一簇,直觀展示哪些插件是一家人。
清單視圖
提供插件、技能、工具三個頁籤。支持按名稱搜索和按圖層過濾,適合精確查找某個節點。
每輪思考過程
選中某個對話輪次後,該輪調用的工具會高亮(序號徽標 + 調用箭頭),思考(💭)與回覆(💬)以氣泡形式呈現。點擊氣泡可查看全文,點擊空白處收起。點擊工具節點,對應的思考氣泡也會一起高亮。
使用統計與健康診斷
每個節點顯示“用過幾次、最近什麼時候用的、最近在哪些輪次被調用”。節點外環會標記加載失敗(🔴)或被禁用(⚪)的狀態,方便快速定位壞掉的插件。
導出報告與持久化
支持一鍵導出 Markdown 報告(概覽、問題插件、喫灰清單、使用排行)。統計與歷史保存在本地 ~/.dsh/kg-knowledge-graph.json,重啓不丟失。
安裝與啓用¶
在終端執行以下命令安裝:
dsh plugin --profile web add dsh-knowledge-graph
安裝完成後,在 DSH Web 界面的右側欄打開“插件圖譜”頁籤。如果沒有側欄,界面右下角會出現一個懸浮按鈕。
使用方法¶
- 查看全局與依賴:默認進入圖譜視圖,滾輪縮放、拖拽平移。點擊頂部“全顯依賴”可切換依賴連線的顯示與隱藏。
- 回看思考軌跡:點擊底部“上一輪調用”或通過下拉框選擇一個具體的對話輪次。此時圖譜中會高亮顯示該輪調用的工具,並彈出思考與回覆氣泡。
- 過濾與搜索:使用頂部搜索框過濾節點,或切換圖層(插件/技能/工具)。
- 導出報告:點擊“導出報告”按鈕,將當前環境狀態以 Markdown 格式下載到本地。
權限與兼容性¶
平臺:Web(適配 web-ui 側欄,無側欄時自動退化爲懸浮面板)。
權限說明:該插件需要枚舉插件清單、監聽工具調用、讀取會話、寫入本地統計文件以及註冊本地 API。它不向任何外部服務發送數據,完全離線運行。
依賴:宿主側依賴 @deepseek-ai/cordis,客戶端依賴 react (^18.2.0)。