在本地 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?
安装步骤
- 01
从 npm 包安装:`dsh plugin --profile web add dsh-wsl-workspace`
$ dsh plugin --profile web add dsh-wsl-workspace
- 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
- 03
从本地目录安装(开发 / 自托管):`dsh plugin --profile web add <本地路径>`
$ dsh plugin --profile web add <本地路径>
- 04
添加插件后重启 `dsh web`
$ dsh web
验证接入成功
- 重启 `dsh web` 后,侧边栏底部「设置」旁会出现一个 W 按钮。
- 在「Add WSL workspace」对话框中,使用 Check 按钮在创建工作区前验证路径是否存在。
03DSH 适配与能力边界
通过官方 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` 链接进工作区的项目无法被发现——请在工作区注册时选择包含真实项目目录的层级。
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`。
07相关的 DSH 工作流
open-design
作者 nexu-io
DeepSeek Harness 的开源 AI 设计插件,本地优先桌面应用,让编码智能体变身设计引擎,生成原型、落地页、幻灯片、图片与视频,支持多种格式导出。
picgo
作者 molunerfinn
PicGo:面向高效创作者的图片上传神器,支持 Obsidian、Typora、VS Code 等编辑器,以及 S3、GitHub、Cloudflare R2、Imgur、阿里云 OSS 等 60+ 图床,粘贴即上传。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
openbiliclaw
作者 whiteguo233
本地私有、开源的自进化跨平台 AI 内容发现 Agent:先理解你,再主动从 B站、小红书、抖音、YouTube、X、知乎、Reddit、微博等平台与开放 Web 寻找内容。(支持 deepseek harness 插件) | Local-first open-source cross-platform AI content discovery agent: understands you, then proactively finds content across Bilibili, Xiaohongshu, Douyin, YouTube, X, Zhihu, Reddit, Weibo and the open web.(support deepseek harness plugin)
08数据与来源
Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/wri…
dsh plugin --profile web add dsh-wsl-workspace
`dsh.compatibility.dshReleases` declares per-release compatibility with the official DSH versions
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-03。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
