dsh-plugin-wsl-env：让 DeepSeek Harness 会话跑进 WSL2 发行版

它是做什么的？

Big-Dao/dsh-plugin-wsl-env 是 DeepSeek Harness（DSH）的 WSL 环境插件，让 DSH 会话直接跑在 WSL2 发行版内部而不是 Windows 上。它解决的是 Windows 用户命令落在 cmd.exe、文件工具只能读写 Windows 路径、目录选择器看不见 Linux 目录的割裂问题。启用后，命令在你的发行版登录 shell 中执行，模型的文件工具读写真实的发行版文件，终端也开在发行版里，并由发行版内的 bubblewrap 做沙箱约束。项目由 Big-Dao 维护，采用 MIT 协议，仅支持 Windows + WSL2。

核心功能

• 命令在发行版内执行：以你的登录 shell 运行，PATH、nvm、cargo、pyenv 与 rc 文件全部生效，而不是硬编码的 bash。
• 文件工具落到真实 Linux 文件：read/write/edit/glob/grep 通过 \wsl.localhost\ 共享访问发行版文件，/mnt/c/… 也能触达 Windows 磁盘。
• 目录选择器同时列出 Windows 主目录与每个已安装发行版，会话可直接打开 /home/you/project 这类路径。
• 终端开在发行版内：右侧栏新建终端后，shell 以发行版用户身份在会话目录中启动，而非 UNC 目录下的 cmd.exe。
• bubblewrap 沙箱：命令被限制在发行版内部，缺少 bubblewrap 时命令会失败关闭（fail closed）。
• 会话自动绑定 wsl 预设：在发行版目录上创建会话时即绑定，第一次工具调用就是正确的。

怎么使用这个插件？

在 DSH 中启用后，从 GUI 打开 \wsl.localhost\ 下的文件夹（选择器会在根层级列出每个发行版），或点击 New terminal，会话工作区、shell 工作目录与终端都会跟随该目录。命令以 wsl.exe 形式在你的发行版中执行，模型还会通过 DSH_WSL_DISTRO、DSH_WSL_SHELL、DSH_WSL_HOME 获知自己的 shell 环境。想验证是否生效，可以让模型运行 uname -r 看是否返回 WSL2 内核，或运行 echo $WSL_DISTRO_NAME。权限行为与 Linux 主机一致，可在 read-only、workspace-write（默认）与 danger-full-access 之间切换，被拒绝的命令会返回升级提示，批准后仅该次调用不受限制。发行版内需按官方说明安装 bubblewrap 前置依赖；如需覆盖某一行配置，可在自己的 profile 层按 id 改写。

报错怎么排查？

命令全部失败关闭，通常是发行版内缺少 bubblewrap，按官方说明在发行版中补装该依赖即可。若在检出目录中改过 lib/ 后行为没变化，是因为运行中的进程缓存了 ES 模块，重启应用后新代码才会生效。