在 DeepSeek Harness Desktop 中添加工作空間時,應用通常會在 Web 界面渲染一個內置的目錄瀏覽器。這個插件攔截了該流程,直接調用 Windows 原生組件,讓用戶使用系統級的文件夾選擇器。
插件定位¶
這是一個 DeepSeek Harness Desktop 桌面端插件。由開發者 liell 維護,核心價值在於繞過應用內部的目錄選擇 UI,直接喚起原生 Windows 資源管理器進行文件夾選擇。
核心功能¶
- 原生窗口調用:從“添加工作空間”入口(包括對話 Hero 區域和側邊欄)直接打開原生 Windows 文件夾對話框。
- 無 UI 自身:作爲渲染無關的客戶端插件,自身不持有任何界面代碼,僅作爲邏輯接入點。
- 系統級體驗:利用 Electron 的
dialog.showOpenDialog,提供完整的資源管理器體驗(如快速訪問、路徑導航、新建文件夾)。 - 更新免疫:插件安裝在
$DSH_HOME目錄下,不會隨應用主程序更新而被覆蓋。 - 安裝冪等:安裝腳本可重複執行,不會報錯或重複添加配置。
- 無卷限制:支持訪問任何可讀寫的卷,包括 exFAT、FAT32 和網絡卷。
安裝與啓用¶
在倉庫根目錄下,通過 PowerShell 運行安裝腳本。腳本會將插件文件複製到用戶目錄下的 profiles 文件夾中,並自動修改 cordis.patch.yml 配置文件。
powershell -ExecutionPolicy Bypass -File .\install.ps1
安裝完成後,必須重啓 DeepSeek Harness Desktop 以加載新插件。插件安裝在 $DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker\,這意味着應用更新不會影響其存在。
典型用法¶
- 在 DSH Desktop 中點擊“添加工作空間”。
- 系統不再彈出 Web 界面的目錄選擇器,而是直接顯示 Windows 資源管理器對話框。
- 選擇目標文件夾後,確認即可創建工作區。
適用場景與注意事項¶
- 操作系統限制:該功能依賴 Windows 原生 Shell 特性,僅支持 Windows 系統。
- 運行環境:需要 DeepSeek Harness Desktop 桌面應用運行。
- 降級機制:如果在未加載桌面橋接(desktop bridge)的環境下運行,插件會回退到主機的
directory-picker接口。 - 權限與安全:由於插件以當前 DSH 進程的權限運行,請確保從可信源安裝並檢查源碼與許可證(MIT)。
總結¶
dsh-workspace-explorer-picker 爲 Windows 用戶提供了更貼近系統的文件管理體驗,且通過安裝在用戶配置目錄下,保證了在應用升級後的穩定性。