当前位置：首页 > news >正文

用于dsh的wsl插件，直接打开wsl工作区

news 2026/8/16 11:51:57

dsh-wsl-workspace

在 DeepSeek Harness Web GUI 中「添加 WSL 工作区」：让 agent 会话的 bash 命令与文件读写都运行在本机 WSL 发行版里，路径均为 Linux 形式，WSL 内无需安装任何工具链。会话可同时访问 WSL 与 Windows 两个系统——bash 命令在 WSL 发行版内执行，Windows 文件随时可通过/mnt/<drive>（如/mnt/c/Users/...）访问。

安装

三种方式任选其一，然后重启dsh web：

# 1) npm 包dsh plugin--profile web add dsh-wsl-workspace# 2) GitHub 仓库（仓库内已含预构建 lib/，无需本地构建）dsh plugin--profile web add https://github.com/6Mikao9/dsh-wsl-workspace# 3) 本地目录（开发/自用）dsh plugin--profile web add D:\path\to\dsh-wsl-workspace

重启dsh web后，侧栏底部 Settings 旁出现 W 按钮。

使用

点侧栏底部 Settings 旁的 W 按钮，打开「添加 WSL 工作区」对话框。先从下拉框选择一个发行版，再浏览目录树或直接输入 Linux 绝对路径（如/home/me/proj），可以点「检查」确认路径存在。对话框文案跟随 DSH 界面语言。用户名是可选项：留空则以该发行版的默认用户运行，填写该发行版里的某个 Linux 用户名则以该用户运行（等价于wsl.exe -u <用户名>）。用户名只影响 bash 命令的运行身份，文件工具通过 Windows 侧的 WSL 共享访问、不受其影响；每个工作区填写的用户名保存在<dshHome>/wsl-workspaces.json，删除对应条目（或重开对话框重建工作区）即可恢复默认用户。

点「创建并打开」后，新会话随即运行在 WSL：bash工具在所选发行版内执行命令，read/write/edit读写 WSL 文件，模型看到的所有路径都是 Linux 形式。模式选择器照常可用——标准、PTC、极简、创造都会自动落到对应的 WSL 变体（选择器里的 WSL 变体条目为中英双语，如WSL · Standard mode（标准模式））；会话内仍可通过/mnt/<drive>（如/mnt/c/Users/...）访问 Windows 文件。

行为与权限说明

bash 工具：以配置的用户名在 WSL 发行版内运行（留空 = 发行版默认用户，通常为 root），可对发行版内任意路径读写。Windows 的 ACL 沙箱无法包裹wsl.exe（子进程运行在 Linux 内核侧），WSL 自身即隔离边界，DSH 文件策略不作用于 bash。
文件工具（read/write/edit）：经 Windows 侧的 WSL 9P 共享访问，受 DSH 文件策略约束。workspace-write下读可到任意位置、写仅限会话工作区；改为danger-full-access后工作区外也可写入。用户名设置不影响文件工具。
wsl.exe在发行版尚未启动时向 stderr 打印的 localhost 端口转发提示（乱码但无害）可忽略。

许可与出处

MIT，详见 LICENSE 与 NOTICE，NOTICE 精确列明：

改编/继承源码：DeepSeek Harness（MIT）的dsh-bash-local（执行器机制）、dsh-fs-local（WslFileSystem子类化）、shipped agent presets（变体生成读取/变换）；
设计参考（未复制源码）：dsh-bash-terminal（MIT，wsl argv/WSLENV 思路）、dsh-side-panel（BSD-3-Clause，Host 路由模式）、vpshub（MIT，路线图参考）。

发布/再分发时请保留 LICENSE 与 NOTICE。