前言¶
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
