返回目录

dsh-wsl-workspace

精选清单收录维护状态: 活跃

dsh-wsl-workspace-maintainers/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

124

星标

22

Fork

JavaScript

语言

MIT

许可证

2026-08-14

创建于

2026-11-07

最近推送

MIT 原生 DSH 插件,面向 Windows+WSL:GUI 注册 WSL 工作区、发行版内有状态 bash、9P 文件工具含沙箱围栏、发行版内 grep/glob,以及可选 `wsl_terminal` 应答交互提示。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-20

许可证

MIT

01它能帮你完成什么?

  • 在本地 WSL 发行版里用 DeepSeek Harness 代理读写 Linux 项目文件

    在所选发行版内执行 bash,并对 Linux 路径做 `read`/`write`/`edit`,无需在 WSL 内再装 `dsh`

    在 Windows 上用 WSL 开发、希望 DSH 的 shell 与文件工具按 Linux 路径运行的用户

  • 在 WSL 工作区会话里按需访问 Windows 侧文件

    bash 仍在发行版内运行,Windows 路径通过 /mnt/c 等盘符挂载路径暴露给模型

    代码在 WSL、但仍要引用 Windows 资源或配置的开发人员

  • 从 DSH Web 界面注册带路径校验的 WSL 工作区

    点击「Create & open」后开启新会话,模型看到 Linux 路径,模式选择器自动落到对应 WSL 变体

    习惯在 GUI 添加工作区、不仅限于 Windows 原生目录的 DSH Web 用户

02如何接入 DeepSeek Harness?

前置条件

  • Windows 主机上至少有一个本地 WSL 发行版(README 经 `wsl.exe` 与 /mnt 盘符挂载 路由工具)
  • 可运行 `dsh plugin --profile web add` 并能重启 `dsh web` 的 DSH Web 环境

安装步骤

  1. 01

    任选一种安装方式:执行 `dsh plugin --profile web add dsh-wsl-workspace`,或添加 GitHub 仓库 URL,或添加本地克隆路径(README 列出三种)

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

  2. 02

    安装插件后重启 `dsh web`

    $ dsh web

  3. 03

    在工作区点击 W 按钮或选择 Add WSL workspace,选发行版,填写绝对 Linux 路径(可用 Check 校验),可选填 Linux 用户名,再点 Create & open

验证接入成功

  • 重启 `dsh web` 后,工作区标题栏在添加工作区控件右侧会出现 W 按钮

03DSH 适配与能力边界

DSH 适配原生运行时

通过 `dsh plugin --profile web add` 安装 Cordis 插件;在 Web GUI 工作区区出现 W 按钮,创建的工作区会把 bash 与文件工具路由进所选本地 WSL 发行版。

  • Web GUI 中的 WSL 工作区向导

    所选 WSL 发行版、绝对 Linux 工作区路径、可选 Linux 用户名→绑定 WSL 的工作区会话,模型上下文内为 Linux 路径

    将各工作区的用户名写入 DSH home 下的 wsl-workspaces.json
  • 发行版内的有状态 bash

    面向所配置 Linux 用户的 shell 命令(留空则用发行版默认用户,常为 `root`)→来自 WSL 内长期 bash 的标准输出/错误与退出码

    拉起并保持 `wsl.exe` bash 进程;`cd`、环境变量与后台任务在多次调用间保留以 Linux 侧权限运行,不受 Windows ACL 沙箱包裹
  • 经 WSL 9P 共享的文件读写

    供 `read`、`write`、`edit` 使用的 Linux 路径→WSL 侧看到的文件内容与编辑结果;侧边栏地址保持 Linux 形式

    走 Windows 侧 WSL 9P 共享,工作区用户名字段不改变文件工具身份`write`/`edit` 仍按主机的 `ctx.sandboxPolicy` 与 `writableRoots` 围栏
  • 发行版内的 grep 与 glob

    Linux 目录树下的搜索模式与路径→由 WSL 内 GNU grep/find 产生、形态接近 ripgrep 的 grep 输出与按修改时间排序的 glob 列表

    在发行版内搜索而非 9P 共享;grep 不读取 `.gitignore`
  • 交互式终端入口(`wsl_terminal`)

    面向需要 TTY 的程序(sudo 密码、ssh 指纹、编辑器等)的 open/send/read/signal/close 操作→由代理键入的 PTY 终端 I/O;按键内容会进入会话记录

    复用主机 PTY 注册表并指向本插件 relay;任何键入内容(含密码)都会写入对话记录

04适合谁?何时不该用?

适合

  • 在 Windows 上用 WSL 开发、希望 DSH 的 shell 与文件工具按 Linux 路径运行的用户
  • 代码在 WSL、但仍要引用 Windows 资源或配置的开发人员
  • 习惯在 GUI 添加工作区、不仅限于 Windows 原生目录的 DSH Web 用户

不适合

  • 面向带本地 WSL 的 Windows 主机:bash 与搜索经 `wsl.exe` 在发行版内执行,Windows 文件以 /mnt 盘符挂载 形式出现。
  • bash 在 Linux 内核侧以所配置用户的发行版权限运行;Windows ACL 沙箱无法包裹 `wsl.exe`,DSH 文件策略不作用于 bash 命令。
  • 文件工具走 Windows 侧 WSL 9P 共享,`write`/`edit` 仍受主机 `writableRoots` 沙箱约束;符号链接解析后,指向工作区外的写入会在 `workspace-write` 下被拒绝。
  • 仅 `dsh.compatibility.dshReleases` 所列 DSH 版本经隔离实例验证;其他版本可能可用但未验证,主机若不暴露任一受支持 API 世代会在运行时显式失败。

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

  • 面向带本地 WSL 的 Windows 主机:bash 与搜索经 `wsl.exe` 在发行版内执行,Windows 文件以 /mnt 盘符挂载 形式出现。
  • bash 在 Linux 内核侧以所配置用户的发行版权限运行;Windows ACL 沙箱无法包裹 `wsl.exe`,DSH 文件策略不作用于 bash 命令。
  • 文件工具走 Windows 侧 WSL 9P 共享,`write`/`edit` 仍受主机 `writableRoots` 沙箱约束;符号链接解析后,指向工作区外的写入会在 `workspace-write` 下被拒绝。
  • 仅 `dsh.compatibility.dshReleases` 所列 DSH 版本经隔离实例验证;其他版本可能可用但未验证,主机若不暴露任一受支持 API 世代会在运行时显式失败。
  • 各工作区可选 Linux 用户名保存在 Windows 主机 DSH home 下的 wsl-workspaces.json 中。
2026-08-142026-11-07v0.7.13

MIT · 最近推送 2026-11-07 · 发行版 v0.7.13

06常见问题

需要在 WSL 里面再装 DSH 吗?

不需要。README 写明 WSL 内无需安装任何东西:在 Windows 侧装插件,在 GUI 选发行版即可,会话会把 bash 与文件工具路由进该发行版。

bash 权限和文件工具有什么不同?

bash 在 WSL 内以配置的 Linux 用户运行,可在发行版内任意读写;Windows ACL 沙箱无法包裹 `wsl.exe`,DSH 文件策略不约束 bash。文件 `read`/`write`/`edit` 经 Windows 侧 9P 共享,仍受 `writableRoots` 沙箱围栏。

支持哪些 DSH 版本?

README 列出在隔离实例验证过的版本(与 `package.json` 的 `dsh.compatibility.dshReleases` 一致)。表外版本可能可用但未验证;主机若不暴露任一受支持 API 世代会显式失败。

WSL 工作区里能访问 Windows 文件吗?

可以。bash 仍在发行版内,Windows 文件通过 /mnt/c 等盘符挂载路径访问。插件还会把部分 Linux 侧边栏地址翻译回 Windows UNC 以便预览。

可选用户名是干什么的?

决定 bash 以哪个 Linux 用户运行(等同为 `wsl.exe -u` 指定 Linux 用户)。不改变文件工具(始终走 9P)。用户名存在 DSH home 下的 wsl-workspaces.json;删条目或重建工作区可恢复发行版默认用户。

08数据与来源

  • 作者声明github.com11c424c42a17…

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

  • 作者声明github.com11c424c42a17…

    Nothing needs to be installed inside WSL.

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

🏆

最佳 DeepSeek Harness 插件

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

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

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