前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。對於需要在 Linux 環境下進行開發的用戶，直接在 Windows 本地運行命令往往受限。dsh-wsl-workspace 插件解決了這一問題，它允許用戶通過 Web GUI 添加一個 WSL 工作區，並將整個智能體會話（包括 bash 命令和文件操作）直接運行在本地 WSL 分發版中。
dsh-wsl-workspace 是什麼¶
dsh-wsl-workspace 是 DeepSeek Harness 的一個客戶端插件，由 dsh-wsl-workspace-maintainers 維護。它通過 Web GUI 提供了在本地 WSL 環境中創建和管理工作區的能力。該插件不需要在 WSL 內部安裝任何額外的工具鏈，即可讓智能體通過 Linux 路徑訪問文件系統，並執行 bash 命令。
核心功能¶
該插件提供以下核心能力：
- 工作區管理：在 DeepSeek Harness Web GUI 中直接添加和管理 WSL 工作區。
- 本地執行：在指定的 WSL 分發版中運行 bash 命令和文件讀寫操作。
- 文件互通：通過
/mnt/<drive>路徑訪問 Windows 文件系統，實現 WSL 與 Windows 之間的文件互通。 - 本地搜索：在 WSL 分發版內部運行文件搜索（
grep/glob），使用 GNU grep 進行遞歸搜索。 - 零依賴：無需在 WSL 內部安裝任何工具鏈或依賴。
安裝與啓用¶
安裝該插件需要使用 DSH 的插件安裝命令，安裝後需要重啓 Web 服務。
- 執行以下命令安裝插件：
dsh plugin --profile web add dsh-wsl-workspace
-
重啓
dsh web進程。 -
重啓後，在側邊欄底部的“設置”旁邊會出現一個 W 按鈕，點擊即可打開“添加 WSL 工作區”對話框。
典型用法¶
使用該插件建立工作區的步驟如下：
- 打開“添加 WSL 工作區”對話框（點擊側邊欄的 W 按鈕）。
- 從列表中選擇一個已安裝的 WSL 發行版。
- 瀏覽目錄樹或手動輸入絕對 Linux 路徑（例如
/home/user/project）。 - 點擊 Check 按鈕驗證路徑是否存在，確認無誤後再創建。
- 在“用戶名”字段中，留空以使用分發版的默認用戶運行命令；或者輸入特定用戶名以運行會話。用戶名僅影響 bash 工具的運行身份，文件工具不受此字段影響。
行爲說明與注意事項¶
在配置和使用過程中，需要注意以下幾點行爲細節：
- 權限與隔離：Windows 的 ACL 沙箱無法包裹
wsl.exe，因此 WSL 本身是隔離邊界。DSH 的文件策略不直接應用於 bash 工具。 - 文件工具：文件讀取、寫入和編輯操作通過 Windows 側的 WSL 9P 共享進行，不受用戶名配置影響。
- 文件搜索：文件搜索功能運行在 WSL 分發版內部，使用 GNU grep，結果格式與主機端保持一致。
- 路徑映射：智能體看到的路徑均爲 Linux 路徑，Windows 文件通過
/mnt/c等掛載點訪問。
生態與鏈接¶
該插件是 DeepSeek Harness 生態系統的一部分。社區目錄提供了插件的詳細信息，用戶可以在 GitHub 上查看源碼。
- 目錄頁: dsh-wsl-workspace
- GitHub 倉庫: dsh-wsl-workspace-maintainers/dsh-wsl-workspace
