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 环境
安装步骤
- 01
任选一种安装方式:执行 `dsh plugin --profile web add dsh-wsl-workspace`,或添加 GitHub 仓库 URL,或添加本地克隆路径(README 列出三种)
$ dsh plugin --profile web add dsh-wsl-workspace
- 02
安装插件后重启 `dsh web`
$ dsh web
- 03
在工作区点击 W 按钮或选择 Add WSL workspace,选发行版,填写绝对 Linux 路径(可用 Check 校验),可选填 Linux 用户名,再点 Create & open
验证接入成功
- 重启 `dsh web` 后,工作区标题栏在添加工作区控件右侧会出现 W 按钮
03DSH 适配与能力边界
通过 `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 中。
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;删条目或重建工作区可恢复发行版默认用户。
07相关的 DSH 工作流
ds-harness-remote
作者 liguobao
基于 DeepSeek Harness 插件机制构建的远程访问方案,通过低延迟、端到端加密的 P2P 网络,支持使用 PC、移动端 和 Web 随时访问本地设备上的DSH 、CodeX、Cursor、Claude Code等工作区。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自动化插件,将 CursorTouch/Windows-MCP 接入内置 MCP 客户端桥接。提供默认关闭的 Computer Use 开关和应用内依赖安装器。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。
08数据与来源
Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/wri…
Nothing needs to be installed inside WSL.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
