DeepSeek Harness (DSH) 的插件化架構雖然靈活,但開發者在擴展功能時容易遇到模塊衝突或內部運行時錯誤。排查這些問題通常需要深入代碼。dsh-conflict-checker 插件提供了直接在設置頁檢測衝突、管理插件狀態的能力,旨在簡化這一維護過程。
這是什麼¶
這是一個由 TussalZeus18028 維護的 DSH 客戶端插件。它主要解決兩個問題:一是檢測 DeepSeek Harness 的插件衝突與內部運行問題,二是在設置頁面提供插件管理(啓用、禁用、卸載)功能。
核心功能¶
1. 衝突檢測
插件會掃描多種潛在衝突源,包括:
* 重複的模塊加載
* 失敗或掛起的 fibers
* 重複的設置命名空間
* 重複的工具名稱
* 啓動圖問題
* 重複的 typert 包
2. 插件管理
在設置頁面,用戶可以對插件進行啓用/禁用切換。卸載操作包含兩步確認機制,防止誤刪。每個插件均可查看詳細信息。
3. 一鍵修復
對於檢測到的問題,界面會展示問題詳情和對應的解決方案,並提供修復按鈕(在適用的情況下)。
4. 界面風格
該插件在設置中渲染爲“插件衝突檢查”頁面,採用官方主題令牌,保持視覺一致性。
安裝與啓用¶
通過命令行安裝:
dsh plugin --profile web add dsh-conflict-checker
或者,直接將條目添加到配置文件 cordis.patch.yml:
- id: dsh-conflict-checker
disabled: false
典型用法¶
安裝完成後,打開 設置 頁面,進入 插件衝突檢查。
該頁面會展示:
* 健康概覽:插件數量、啓用/禁用狀態、問題統計。
* 問題列表:顯示檢測到的問題及其解決方案。
* 插件列表:包含搜索和過濾功能,支持通過開關控制啓用/禁用,以及卸載和查看詳情操作。
工作原理¶
該插件採用客戶端渲染與主機端接口結合的方式工作:
- 主機端:在共享 Web 服務器的
/plugins/dsh-conflict-checker/*路徑下注冊 JSON 端點,負責掃描插件、設置啓用狀態和移除插件。 - 客戶端:負責渲染設置頁面,並調用上述主機端提供的 JSON 接口。
在檢測邏輯上,插件枚舉讀取 Cordis Loader 的條目,並進一步檢查 Loader、設置命名空間、工具架構、Web 啓動圖以及 typert 註冊表。
注意事項¶
本插件以當前 DSH 進程的權限運行。安裝前請務必檢查源碼與許可證。DSH 理念是“一切皆插件”,社區目錄與 DeepSeek 或幻方無官方從屬關係。
總結¶
dsh-conflict-checker 通過提供可視化的衝突檢測和插件管理界面,降低了排查 DSH 插件問題的門檻。開發者可以在遇到運行問題時快速定位並嘗試修復。