前言¶
DeepSeek Harness (DSH) 是一個插件化的智能體運行框架。在 Windows 環境下開發 WSL 項目時，通常需要解決環境切換的問題。這個插件通過將 Harness 進程保持在 Windows，而將執行環境遷移到 WSL 2 發行版，實現了在同一個進程中同時處理 Windows 和 Linux 路徑的能力。
核心功能¶
這是一個由 Big-Dao 維護的 DeepSeek Harness 插件。它允許在 Windows 上運行的 Harness 會話進入 WSL 2 發行版，提供真實的 Linux 登錄 shell 環境，並默認使用 bubblewrap 進行沙箱隔離。
主要功能包括：
* WSL 2 會話運行：在 Windows 的 Harness 進程中運行一個會話，該會話位於 WSL 2 發行版內。
* 真實 Linux 環境：使用發行版的登錄 shell 執行命令，保留其 PATH、nvm、pyenv 等配置和 rc 文件。
* 沙箱隔離：默認使用 bubblewrap 對命令進行隔離。
* GUI 集成：文件夾選擇器可列出已安裝的發行版，終端在發行版中打開。
* 會話級支持：同一個 Harness 進程可以同時處理 Windows 文件夾和 WSL 文件夾。
安裝與啓用¶
安裝該插件需要 Windows 10 或 11，以及已安裝的 WSL 2 發行版。發行版內必須安裝 bubblewrap。
- 在 Windows 終端中執行安裝命令：
dsh plugin --profile wsl add dsh-plugin-wsl-env
- 在發行版中安裝
bubblewrap（以 Ubuntu 爲例）：
wsl.exe -d ubuntu -u root -- apt-get install -y bubblewrap
- 安裝後，使用
--profile wsl啓動 Harness。
典型用法¶
- 打開發行版目錄：在 Harness 的文件夾選擇器中打開一個 WSL 發行版路徑，例如
\\wsl.localhost\ubuntu\home\you\project。即使該發行版不是默認發行版，也會在此環境中運行。 - 命令執行：所有命令都在發行版的登錄 shell 中執行。路徑
/home/you/x與\\wsl.localhost\ubuntu\home\you\x指向同一文件。 - 新終端：打開新終端時，會自動在相同發行版和目錄下啓動一個 shell。
- 端口監聽：模型可以看到監聽端口，並返回開發服務器的 URL（WSL 2 會將 localhost 轉發到 Windows）。
適用場景與注意¶
- 環境要求：僅支持 Windows + WSL 2。
- 依賴檢查：發行版內不需要 Node.js。
- 沙箱配置：默認的會話沙箱需要發行版啓用
systemd（在/etc/wsl.conf中設置systemd=true並重啓 WSL）。如果禁用了 systemd，需要在配置中設置sessionSandbox: false。 - 安全與隔離：發行版內不運行輔助服務器、守護進程或監聽端口。受限命令使用
bubblewrap運行。
該插件通過將 Shell 語義與 Linux 工具鏈對齊，減少了模型在 Windows 和 Linux 之間的切換成本。
