前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。開發者通常會安裝多個第三方插件來擴展功能,例如模型路由、視覺處理等。這些插件各自注冊設置項,導致側邊欄設置列表逐漸膨脹且雜亂。dsh-settings-hub 插件旨在解決這一問題,通過統一的入口聚合所有第三方插件的設置項。
插件介紹¶
名稱:dsh-settings-hub
維護者:Amengclass
定位:統一管理 DeepSeek Harness 第三方插件設置項的插件
核心功能¶
該插件主要解決第三方插件設置項分散的問題,具體能力如下:
- 統一入口:所有第三方插件的設置項自動歸入「擴展設置項」分組,不再散落在側邊欄各處。
- 動態發現:新安裝的插件自動出現,無需手動配置或修改代碼。
- 分組歸屬:按父插件自動分組,每個插件的子設置項聚合在一起。
- 拖拽排序:支持拖拽調整分組和子項順序,順序持久化到 localStorage。
- 幽靈拖拽:拖拽時原位置保持不變,半透明幽靈跟隨鼠標,視覺反饋清晰。
- 零侵入:不修改 DSH 源碼,通過官方 shadow 機制接管
sidebar.settings插槽。 - 雙端兼容:同時支持
dsh web與 DSH 桌面應用(DSH 0.1.x / 0.2.x)。
安裝與啓用¶
Web 端安裝
先執行安裝命令:
dsh plugin --profile web add dsh-settings-hub
安裝完成後,啓動 Web 端即可:
dsh web
打開瀏覽器訪問 http://127.0.0.1:3080,點擊左下角「設置」即可看到效果。
前置條件注意事項
- pnpm 11 用戶:如果安裝遇到問題,需在
~/.dsh/profiles/web/pnpm-workspace.yaml中添加以下配置:
minimumReleaseAgeExclude:
- dsh-settings-hub
- 桌面端用戶:DSH 桌面應用使用獨立的 profile(
~/.dsh/profiles/desktop),需要在桌面端自帶的插件管理界面安裝本插件,而不是執行dsh plugin --profile web add。
典型用法¶
安裝後,用戶可以通過以下命令進行管理:
- 卸載:
dsh plugin --profile web remove dsh-settings-hub
- 查看插件目錄:確認插件是否安裝成功,可執行:
ls node_modules/dsh-settings-hub
適用場景與注意¶
適用場景
該插件適合需要管理大量第三方插件設置項的用戶。通過統一的「擴展設置項」入口,可以快速定位和調整各插件的配置。
注意事項
- 權限範圍:插件以當前 DSH 進程權限運行。在安裝前,建議檢查其源碼與許可證,確保符合使用規範。
- 兼容性限制:部分插件(如
dsh-vision-router)使用不同的設置註冊機制,暫不支持被dsh-settings-hub發現。 - 排序重置:拖拽排序的數據保存在瀏覽器 localStorage 中,清除瀏覽器數據後排序會重置爲默認。
結語¶
經過上面的步驟,你可以在 DeepSeek Harness 中擁有一個整潔、有序的設置管理入口。對於追求高效開發流程的 DSH 用戶而言,dsh-settings-hub 是提升插件管理體驗的有效工具。
插件詳情與源碼可參考:GitHub