dsh-plugin-wsl-env — run a DSH session against a WSL distro, with the sandbox moved inside the distro

[Big-Dao]

English · 中文

English

A Windows-first DSH setup where the model's commands, files and terminal all live inside a WSL distro — with a kernel-enforced sandbox, backed by a six-distro compatibility matrix.

What it is: three seam providers (shell / fs / subprocess), so the model's existing tools run against a WSL distro instead of Windows. No new tools to learn — same UI, same permission flow, different execution world.

Install

The Windows desktop app ships no dsh executable — the installer writes only DeepSeek Harness.exe, and the CLI entry lives inside resources/app.asar. Pick the path that matches your distribution:

Desktop app — Plugins is a sidebar entry, not a Settings page:

1. Open Plugins in the sidebar → Add plugin → enter the exact package name dsh-plugin-wsl-env → enable it.
2. Start the app the way the installer's shortcut does: DeepSeek Harness.exe, no arguments. It opens the profile the Plugins page writes into — the desktop profile name is owned by the Electron app, and the npm CLI refuses to manage its plugins.

CLI distribution (dsh on PATH), in a Windows terminal:

dsh wsl --from-default-profile web --dump-config   # create a profile named wsl
dsh plugin --profile wsl add dsh-plugin-wsl-env    # install the plugin and its settings
dsh --profile wsl                                  # start

Then install bubblewrap in the distro before the first command (required):

wsl.exe -d <distro> -u root -- apt-get install -y bubblewrap

What makes it worth trying

• Same window, two worlds: Windows projects stay native; WSL projects get the real Linux toolchain — model-generated bash on GNU tools, not translated PowerShell
• The sandbox is the kernel's: bubblewrap profiles built on the host, executed in the distro; enforcement honestly reported as partial (the interop escape is documented and probed)
• Measured, not claimed: a six-distro compatibility matrix (Ubuntu/Debian/Fedora/openSUSE/Arch/Alpine — systemd and OpenRC, glibc and musl), the aarch64 agent executed under qemu in CI, the shell agent passing in five non-Ubuntu containers
• A 17-probe real-machine suite gates each release on Windows + WSL (the hosted CI leg skips without WSL)
• One command turns a rootfs tarball into a plugin-ready distro (bootstrap-import)
• One key chooses the interop stance (interopVisibility: visible | masked | disabled)

Try it & tell us what breaks

Five minutes from a clean machine: Quickstart. Feedback channels: bug / setup report / feature request — or reply right here.

• Repo: https://github.com/Big-Dao/dsh-plugin-wsl-env
• npm: https://www.npmjs.com/package/dsh-plugin-wsl-env
• Latest: v0.18.0 (2026-11-05)

Screenshots · 截图

中文

一套 Windows 优先的 DSH 环境配置：模型的命令、文件与终端全部落在 WSL 发行版内——内核强制执行的沙箱，附六发行版兼容性矩阵。

它是什么： 三个 seam provider（shell / fs / subprocess），让模型现有的工具直接作用于 WSL 发行版，而不是 Windows。无需学习新工具——同一界面、同一权限流程，只是换了执行世界。

安装

Windows 桌面应用不带 dsh 可执行文件——安装器只写 DeepSeek Harness.exe，CLI 入口在 resources/app.asar 内部。按你手上的发行版二选一：

桌面应用——Plugins 是侧边栏入口，不是设置页：

1. 在侧边栏打开 插件 → Add plugin → 填精确包名 dsh-plugin-wsl-env → 启用。
2. 用安装器快捷方式的同样方式启动：DeepSeek Harness.exe，不带参数。它打开的是 Plugins 页写入的那个 profile——desktop 这个 profile 名由 Electron 应用独占，npm CLI 拒绝管理它的插件。

CLI 发行版（dsh 在 PATH 上），在 Windows 终端中执行：

dsh wsl --from-default-profile web --dump-config   # 创建名为 wsl 的 profile
dsh plugin --profile wsl add dsh-plugin-wsl-env    # 安装插件及其设置
dsh --profile wsl                                  # 启动

然后在发行版内安装 bubblewrap（必需，第一条命令之前执行）：

wsl.exe -d <distro> -u root -- apt-get install -y bubblewrap

值得尝试的理由

• 同窗两世界：Windows 项目保持原生；WSL 项目得到真实的 Linux 工具链——模型生成的是跑在 GNU 工具上的 bash，而不是翻译过的 PowerShell
• 沙箱由内核执行：bubblewrap profile 在宿主侧构建、在发行版内执行；enforcement 如实报告为 partial（interop 逃逸面有文档、有探针）
• 实测而非声称：六发行版兼容性矩阵（Ubuntu/Debian/Fedora/openSUSE/Arch/Alpine——systemd 与 OpenRC、glibc 与 musl），aarch64 agent 在 CI 中经 qemu 实际执行，shell agent 在五个非 Ubuntu 容器中通过
• 17 项真机探针在每次发布前把关 Windows + WSL（托管 CI 在无 WSL 的 runner 上跳过）
• 一条命令把 rootfs tarball 变成插件就绪的发行版（bootstrap-import）
• 一个键选择 interop 立场（interopVisibility: visible | masked | disabled）

试用并把问题告诉我们

从清洁机器到跑通约五分钟：快速上手（中文版内含）。反馈渠道：bug / 环境报告 / 功能建议——或直接在本帖回复。欢迎中文反馈。

• 仓库：https://github.com/Big-Dao/dsh-plugin-wsl-env
• npm：https://www.npmjs.com/package/dsh-plugin-wsl-env
• 最新版：v0.18.0（2026-11-05）

[JasonEX]

v0.2.2-rc1版本下无法正常使用

[Big-Dao]

v0.2.2-rc1修改了多处接口，本插件已经跟进适配

[JasonEX]

感谢，但是0.19.0安装后启用仍旧有报错，重启后不报错，但是wsl模式的workspace write提示：

Allow this operation with danger-full-access permissions: The workspace file tools are blocked by the WSL session-sandbox preflight, which asks to run exactly this command to let the user manager outlive the login session.

这个应该不正常吧，还请排查一下，谢谢

[Big-Dao]

这是沙箱检查到工具调用中有超出权限的命令，提出的提权申请。估计是你的wsl环境当前用户开启“linger”（逗留）功能。直接允许这次提权，一般会修复。或者手动在wsl的linux发行版中运行“sudo loginctl enable-linger $USER”

[JasonEX]

我的请求只是在项目目录中创建一个text文件，内容为hello, world!，这个也会超出权限吗？ Sent from Outlook for Android<https://aka.ms/AAb9ysg>

…

________________________________ From: Big Dao ***@***.***> Sent: Saturday, 07 November 2026 00:06:01 To: deepseek-ai/deepseek-harness ***@***.***> Cc: Yuqian YANG ***@***.***>; Comment ***@***.***> Subject: Re: [deepseek-ai/deepseek-harness] dsh-plugin-wsl-env ― run a DSH session against a WSL distro, with the sandbox moved inside the distro (Discussion #11251) 这是沙箱检查到工具调用中有超出权限的命令，提出的提权申请。估计是你的wsl环境当前用户开启“linger”（逗留）功能。直接允许这次提权，一般会修复。或者手动在wsl的linux发行版中运行“sudo loginctl enable-linger $USER” ― Reply to this email directly, view it on GitHub<#11251?email_source=notifications&email_token=ABA7KBKTG3YEZCN7VAXWVP35XXZGTA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOJUGQ2DCNRTUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-19444163>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/ABA7KBNPIHCHGVSRD2ILPY35XXZGTAVCNFSNUABJKJSXA33TNF2G64TZHMYTGMZTGA3DKMBZGE5UI2LTMN2XG43JN5XDWMJRGE2DQMRTGGQXMAQ>. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS<https://github.com/notifications/mobile/ios/ABA7KBIJNS3SBXJVG5QHG4D5XXZGTA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOJUGQ2DCNRTUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android<https://github.com/notifications/mobile/android/ABA7KBJUHRFPTXTB3WRNS3T5XXZGTA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOJUGQ2DCNRTUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you commented.Message ID: ***@***.***>

[Big-Dao]

你好。插件在wsl内运行，windows对wsl具有回收功能以释放资源，为了避免被系统回收，需要其内的linux发行版打开systemd，并启动linger（逗留）。因此插件在运行时会检查环境是否就绪。

[Big-Dao]

@JasonEX Follow-up: the quickstart now documents this exact first-run moment — the sandbox permission prompt is expected (it names the command and target; allowing it once is safe), and enabling linger in the distro prevents repeat prompts:

https://github.com/Big-Dao/dsh-plugin-wsl-env/blob/main/docs/QUICKSTART.md (see "First-write note", shipping in the next release)

If allowing the prompt didn't unblock you on 0.2.2-rc1, or anything else in the flow surprises you, please reply here — first-run reports on the new 0.2.2 line are exactly what we need right now.

[Big-Dao]

v0.24.0 已发布（npm latest，Release v0.24.0）。本次主题：诊断从“报告”变成“可操作”——侧边栏出现 WSL 环境面板，doctor 的检查目录也按生效配置逐项 triage。

• 侧边栏 WSL 环境面板：按发行版运行 doctor 快速检查（bwrap / systemd / Linger 等前置项）；已检查行提供完整运行——存在插件可修复项时标为 修复，否则 完整检查——以 --fix-owned 清扫残留 session scope、清理损坏的 agent cache 并逐一复检。行内显示上次检查时间、来源（手动或页面加载时的后台复核）与结果结构，可展开查看本次执行的全部检查项；最后一次结果持久化在 $DSH_HOME/cache/dsh-plugin-wsl-env/status.json，页面重载或应用重启后仍在。
• 添加工作区时选择打开方式：选中发行版目录后询问 Remote WSL（默认）或 Windows 访问（9p 共享），记录在 auto-preset 的 windowsWorkspaces；文件夹选择器改为分类根——Windows 路径从驱动器开始，WSL 分支列出发行版。
• doctor 目录与修复：合并冗余检查（host.platform、distro.identity），新增 functional.native、agent.home-writable、host.disk、distro.unc 与 WSLInterop 探测；BusyBox 上不再误判 blocked（解码 FSB 失败并指向 findutils）；Windows 入口可跑 agent 链；--fix 修复 agent 缓存，新增 --fix-owned 收窄到插件自有状态。
• 移除：doctor 的 registry 更新检查与 composer 的“WSL 诊断”按钮；DSH_UPDATE_REGISTRIES 不再读取。

npm i dsh-plugin-wsl-env@latest 更新；升级后需重启 DeepSeek Harness（宿主无 HMR）。

验证快照：pnpm test 全链 exit 0，覆盖率 98.87/89.19/93.37（门槛 85/84/70）；Harness 关闭后 17 项真机探针（--include-fs）全通过；tag 触发的 Release 工作流全绿（Gates、native agent、发布、registry 校验、GitHub Release）；CI matrix（Node 22/24 Linux+Windows、native spike x86_64、musl x86_64+aarch64、五个容器发行版）全绿；npm 发布带 provenance 签名，registry fileCount 167 与本地 pack 一致。

[Big-Dao]

插件更新通告 / Plugin update（2026-11-14）

dsh-plugin-wsl-env 文档全面改版，已合入仓库 main。npm 最新发布版仍为 0.26.0——本次只改文档，插件功能无变化：

• README 重写为「无插件 / 有插件」对照叙事，配中英双语架构图。核心痛点：两种工作区模式都缺 POSIX 执行环境——Windows 工作区落在 CMD / PowerShell（模型的弱项，训练语料以 POSIX 为主）；WSL 工作区只能经 wsl.exe 逐条包装（每次调用是孤立空间，环境、cwd 与进程状态不跨调用保持，多步脚本在接缝处断掉）。
• 明确 DSH 的两种交付形态：npm CLI（Web UI / headless）与桌面应用（macOS / Windows）。本插件只服务其中一种组合：Windows 桌面应用 + WSL 2 项目。
• VALUE 文档新增与 Remote-SSH 的对照（Windows 宿主）：到达范围（仅本机发行版 vs 任意 SSH 主机）、前置配置（无需 sshd / 密钥 / 端口转发）、发行版内足迹（一个内容寻址缓存 vs ~/.vscode-server）、命令沙箱（bubblewrap + DSH 权限档位 vs 无）。
• README 现在只演示桌面路径：DSH Desktop 不含 dsh 可执行文件，安装、验证、升级、卸载均以 Plugins 页为准。

CLI 能整个装进发行版时不需要本插件，判断表见 README。

Docs overhaul landed on main — the README pair now leads with the two-mode POSIX pain (CMD/PowerShell weakness on Windows workspaces, stateless wsl.exe wrapping on WSL workspaces), ships bilingual before/after diagrams, and VALUE gains a Remote-SSH comparison for the Windows host. Latest npm release (0.26.0) is functionally unchanged.