前言¶
DeepSeek Harness (DSH) 依靠插件擴展功能。當開發環境部署在 WSL 發行版中時，直接在 Web 工作區側邊欄掛載 Linux 目錄，可以避免頻繁切換終端，實現統一的開發體驗。
插件介紹¶
wepar1212/dsh-wsl-workspace 是一個獨立的 DeepSeek Harness 樹外 bundle。它在 Web 工作區側邊欄提供了手動 WSL 開關、發行版選擇器和 Linux 目錄瀏覽器。安裝後，選中的 WSL 目錄會作爲標準 DSH 工作區掛載，Agent 的 bash 命令會自動通過 wsl.exe 在對應目錄執行。
核心功能¶
- 默認關閉：WSL 訪問功能默認關閉，只有用戶手動啓用後才生效。
- 自動發現：自動列出當前 Windows 用戶安裝的 WSL 發行版。
- 路徑支持：支持瀏覽目錄或輸入
/home/user/project等絕對 Linux 路徑。 - 路徑映射：使用 Host 返回的
\\wsl.localhost\<distribution>\...路徑創建標準 DSH 工作區。 - 組件集成：Host、Web Client、Typert Remote 和 bundle patch 全部包含在一個 npm 包中。
- 自動路由：WSL 工作區的 bash 命令直接使用 wsl.exe 執行，不依賴 DSH 的 Win32 PTY 檢測。
- 零依賴：無需在 WSL 內安裝 VS Code Server，只需發行版中有 bash。
- 非侵入式：不修改 DSH 的源碼文件。
安裝與啓用¶
進入 DSH 源碼根目錄，執行以下命令安裝插件：
pnpm dsh plugin --profile web add github:wepar1212/dsh-wsl-workspace
重啓 DSH 後，在側邊欄底部找到 WSL 按鈕，手動打開開關，選擇發行版和目錄即可。
使用說明¶
安裝並重啓 DSH 後，切換到 Web 工作區。在側邊欄底部點擊 WSL 按鈕：
1. 啓用 WSL 功能。
2. 選擇目標發行版（如 Ubuntu）。
3. 瀏覽目錄或輸入 Linux 路徑。
4. 進入該工作區後，Agent 的所有 bash 命令都會在選定的 Linux 目錄中運行。
注意事項¶
- 運行環境：僅支持運行在 Windows Host 上且可調用
wsl.exe的 DSH。 - 權限風險：啓用 WSL 工作區後，Agent 命令在 Linux 環境中運行，Windows 沙箱無法限制這些命令。請僅對可信項目啓用此功能。
- 操作限制：目前只支持選擇目錄，不支持在 WSL 中創建、重命名、移動或刪除文件。
- 狀態隔離：每次命令都是獨立調用 wsl.exe，不保留 shell 環境變量或交互狀態。
- 更新方式：源碼更新後需重新執行
pnpm build並重啓 DSH。
結語¶
該插件通過標準 DSH 工作區協議將 WSL 目錄集成到 Web 界面中，適合需要在 WSL 中進行 Rust、Node.js 或 Python 開發的場景。
