前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在 Web UI 中,默認的工作區目錄選擇器從 Linux 主目錄開始,且麪包屑導航在此摺疊。在 WSL 環境下,Windows 驅動器通常掛載在 /mnt/c、/mnt/d 等路徑,默認選擇器很難通過點擊找到這些目錄,且無法通過麪包屑導航到根目錄。dsh-wsl-workspace-picker 插件通過插槽優先級覆蓋的方式,重寫了默認的瀏覽對話框,解決了這個問題。
是什麼¶
這是一個純 UI 插件,用於增強 DeepSeek Harness Web UI 的工作區目錄選擇體驗。它由 WilliamShi666 維護,採用 MIT 許可證。
核心功能¶
該插件提供了以下功能,旨在簡化在 WSL 環境下的文件系統導航:
- 快捷訪問芯片:提供 Home、
/、/mnt以及常見 Windows 掛載點(如/mnt/c、/mnt/d、/mnt/e、/mnt/f)的一鍵訪問。 - 始終可見的路徑輸入:可以直接輸入絕對路徑(例如
/mnt/d/projects)並按回車確認。 - 完整的麪包屑導航:麪包屑從根目錄
/開始,不再在 Home 目錄摺疊。 - 文件操作:支持創建新文件夾和切換顯示隱藏文件。
安裝與啓用¶
在安裝之前,請確保本地運行着 DeepSeek Harness 0.1.0-rc.6 及以上版本(web profile)。
執行以下命令安裝插件:
dsh plugin --profile web add dsh-wsl-workspace-picker
安裝完成後,重啓 dsh web 並刷新瀏覽器頁面。在側邊欄的 workspaces 區域點擊 + 按鈕,或在 conversation-hero 區域打開工作區選擇器,即可看到增強後的對話框。
卸載¶
如需移除該插件,執行以下命令:
dsh plugin --profile web remove dsh-wsl-workspace-picker
技術原理與限制¶
該插件註冊在 directoryFlow 插槽上(包括 sidebar.workspaces.directoryFlow 和 conversation.hero.workspace.directoryFlow),優先級爲 -10。DSH 的插槽系統採用“最低優先級優先”的原則,因此優先級 -10 會覆蓋默認的優先級 0 插件。卸載該插件後,默認對話框將自動恢復。
在實現上,該插件複用了主機現有的 browse 能力(即 ctx.workspaces.listDirectory 和 createDirectory),不包含任何主機端代碼或網絡連接請求。
插件要求環境中有 /mnt/<drive> 的掛載點(典型的 WSL 環境)。在其他環境下,快捷芯片可能僅顯示不存在的目錄,但不影響使用。