前言¶
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 开发的场景。
