返回目录

dsh-wsl-workspace

编辑精选维护状态: 活跃

6mikao9/dsh-wsl-workspace

WSL workspace support for DeepSeek Harness——无缝的 WSL 工作区使用体验,无需在 WSL 之中再安装一个dsh,安装该插件后在 GUI 里直接添加 WSL 工作区即可。WSL workspace support for DeepSeek Harness — Enjoy a seamless WSL workspace experience without needing to install dsh inside WSL. Once this plugin is installed, you can directly add a WSL workspace right from the GUI.

前往 GitHub
$ dsh plugin --profile web add dsh-wsl-workspace

43

星标

5

Fork

TypeScript

语言

MIT

许可证

2026-08-14

创建于

2026-09-02

最近推送

在本地 WSL 发行版中运行 DeepSeek Harness agent 会话的原生 DSH 插件——bash 与文件走 Linux 路径,Windows 经 /mnt/<drive> 可达,WSL 内无需安装。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-09-03

许可证

MIT

01它能帮你完成什么?

  • 在本地 WSL 发行版中运行完整的 DeepSeek Harness agent 会话

    agent 会话的 bash 命令与文件读写都在 WSL 内的 Linux 路径上执行,同时 Windows 文件仍可通过 /mnt/<drive> 访问

    在 Windows 上使用 DeepSeek Harness(dsh)的用户,希望为 agent 的 bash 与文件操作提供 Linux 沙箱,且无需在 WSL 内安装 dsh

  • 通过 Web GUI 直接从 DeepSeek Harness 添加 WSL 工作区

    一个已配置的 WSL 工作区,模型以 Linux 路径打开;模式选择器为双语(如 WSL · Standard mode(标准模式)),并可按发行版指定可选用户名

    运行 DeepSeek Harness Web、希望从侧边栏直接打开 WSL 项目而无需任何 CLI 配置的开发者

02如何接入 DeepSeek Harness?

安装步骤

  1. 01

    从 npm 包安装:`dsh plugin --profile web add dsh-wsl-workspace`

    $ dsh plugin --profile web add dsh-wsl-workspace

  2. 02

    从 GitHub 仓库安装(已附带预构建 lib/,无需本地构建):`dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace`

    $ dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace

  3. 03

    从本地目录安装(开发 / 自托管):`dsh plugin --profile web add <本地路径>`

    $ dsh plugin --profile web add <本地路径>

  4. 04

    添加插件后重启 `dsh web`

    $ dsh web

验证接入成功

  • 重启 `dsh web` 后,侧边栏底部「设置」旁会出现一个 W 按钮。
  • 在「Add WSL workspace」对话框中,使用 Check 按钮在创建工作区前验证路径是否存在。

03DSH 适配与能力边界

DSH 适配原生运行时

通过官方 dsh CLI(`dsh plugin --profile web add`)安装的原生 DSH 插件;为 DeepSeek Harness Web GUI 增加 WSL 工作区类型,并在本地 WSL 发行版中运行 agent 会话。

  • 通过 GUI 添加 WSL 工作区

    DeepSeek Harness Web 侧边栏;所选 WSL 发行版与绝对 Linux 路径(或浏览的目录)一个新的 WSL 工作区,模型可直接打开;对话框遵循 DeepSeek Harness 的界面语言

  • bash 与文件在 WSL 的 Linux 路径上运行

    WSL 工作区中的 agent 会话bash 命令在 WSL 发行版内执行;`read`/`write`/`edit` 操作 WSL 文件,因此模型看到的每个路径都是 Linux 路径

  • 按工作区发现技能目录

    已注册的 WSL 工作区根目录从最近的 `.git` 祖先开始发现技能,扫描 `.dsh/skills` 与 `.agents/skills`,上限为 4 层 / 64 个目录 / 4096 个目录,按扫描根缓存

04适合谁?何时不该用?

适合

  • 在 Windows 上使用 DeepSeek Harness(dsh)的用户,希望为 agent 的 bash 与文件操作提供 Linux 沙箱,且无需在 WSL 内安装 dsh
  • 运行 DeepSeek Harness Web、希望从侧边栏直接打开 WSL 项目而无需任何 CLI 配置的开发者

不适合

  • Windows 的 ACL 沙箱无法包裹 `wsl.exe`——其子进程运行在 Linux 内核侧——因此 WSL 自身就是隔离边界,DSH 文件策略不对 bash 生效。应将 WSL 视为 bash 命令的信任边界。
  • 在 `workspace-write` 下,读取可在任意位置进行,但写入仅限于会话工作区;将文件策略切换为 `danger-full-access` 才允许工作区外写入。用户名字段不影响文件工具。

05兼容性、维护与安全提示

  • Windows 的 ACL 沙箱无法包裹 `wsl.exe`——其子进程运行在 Linux 内核侧——因此 WSL 自身就是隔离边界,DSH 文件策略不对 bash 生效。应将 WSL 视为 bash 命令的信任边界。
  • 在 `workspace-write` 下,读取可在任意位置进行,但写入仅限于会话工作区;将文件策略切换为 `danger-full-access` 才允许工作区外写入。用户名字段不影响文件工具。
  • Windows 侧的 `\\wsl.localhost` 共享无法解析 Linux 符号链接,因此通过 `ln -s` 链接进工作区的项目无法被发现——请在工作区注册时选择包含真实项目目录的层级。
2026-08-142026-09-02作者未说明

MIT · 维护者声明为原生 DSH 插件集成(topics:dsh、dsh-plugin、dsh-plugins);最新版本 0.4.2(2026-09-02)

06常见问题

如何为 DeepSeek Harness 安装 dsh-wsl-workspace?

运行 `dsh plugin --profile web add dsh-wsl-workspace`(npm),或 `dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace`(GitHub,附带预构建 lib/),或指向本地目录。然后重启 `dsh web`——「设置」旁会出现 W 按钮。

该插件需要在 WSL 内安装 dsh 吗?

不需要。README 说明 WSL 内无需安装任何东西;会话在本地 WSL 发行版上运行 bash 与文件工具,而 dsh 仍运行在 Windows 侧。

agent 能否从 WSL 会话访问 Windows 文件?

可以。bash 在 WSL 发行版内运行,但 Windows 文件仍可通过 `/mnt/<drive>`(如 `/mnt/c/Users/...`)访问,因此会话可同时触及 WSL 与 Windows。

WSL 工作区如何影响 DSH 文件策略?

Windows 的 ACL 沙箱无法包裹 `wsl.exe`,因此 WSL 自身即隔离边界,DSH 文件策略不对 bash 生效。文件工具(`read`/`write`/`edit`)走 Windows 侧 WSL 共享,受 DSH 文件策略约束;在 `workspace-write` 下写入仅限于会话工作区,除非切换到 `danger-full-access`。

08数据与来源

  • 作者声明github.com55648f0c27c1…

    Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/wri…

  • 作者声明github.com55648f0c27c1…

    dsh plugin --profile web add dsh-wsl-workspace

  • 作者声明github.com55648f0c27c1…

    `dsh.compatibility.dshReleases` declares per-release compatibility with the official DSH versions

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-03。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。