dsh-wsl-workspace：为 DeepSeek Harness 提供无缝的 WSL 工作区支持
6mikao9/dsh-wsl-workspace
为 DeepSeek Harness 提供 WSL 工作区支持，无需在 WSL 内安装 dsh，即可在 GUI 中直接添加并运行 Linux 环境。
让 DeepSeek Harness 的 Web GUI 直接添加 WSL 工作区，无需在 WSL 内安装 dsh，即可在本地发行版中运行完整会话。
dsh plugin --profile web add github:6mikao9/dsh-wsl-workspace- 分类
- 开发与运维
- 平台
- DSH-Plugin
- 作者
- 6mikao9
- 分发方式
- 插件
dsh-wsl-workspace 核心特性
dsh-wsl-workspace 仓库信息
dsh-wsl-workspace 仓库简介
dsh-wsl-workspace 是 DeepSeek Harness（DSH）的 WSL 工作区插件（DSH plugin），由 6Mikao9 维护，采用 MIT 协议，最近更新于 2026-08。它解决了在 Windows 上使用 DSH 时无法直接在 WSL 发行版中运行会话的问题——无需在 WSL 内部安装 dsh，即可从 DSH 的 Web GUI 直接添加 WSL 工作区，让 bash 命令和文件读写都在本地 WSL 发行版中执行，并使用 Linux 路径。该插件同时打通了 WSL 与 Windows：bash 命令在 WSL 内运行，而 Windows 文件仍可通过 /mnt/<drive>（如 /mnt/c/Users/...）访问。核心能力包括：从 GUI 添加 WSL 工作区、选择发行版、验证路径、指定运行用户，以及让四种模式（Standard、PTC、Minimal、Creative）自动对应到各自的 WSL 变体。
dsh-wsl-workspace 这个 DSH plugin 支持哪些核心特性？
该插件提供以下关键特性：
- WSL 工作区管理：在 DSH Web GUI 侧边栏底部（Settings 旁）出现一个 W 按钮，点击后弹出“Add WSL workspace”对话框，可列出发行版、浏览目录树或输入绝对 Linux 路径（如
/home/me/proj），并通过 Check 按钮验证路径是否存在。 - 用户身份控制：用户名可选，留空则使用发行版默认用户（常为 root），指定用户名则相当于执行
wsl.exe -u <username>，仅影响 bash 工具的运行身份，文件工具不受影响。 - 会话模式映射：模式选择器（Standard、PTC、Minimal、Creative）自动对应到各自的 WSL 变体，且变体条目为双语显示（如
WSL · Standard mode（标准模式））。 - 路径与文件访问：会话中所有路径均为 Linux 路径，Windows 文件可通过
/mnt/<drive>访问。
dsh-wsl-workspace 怎么安装？
安装该 DSH plugin 有三种方式（任选其一），安装后需重启 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
重启后，侧边栏底部 Settings 旁会出现 W 按钮。
dsh-wsl-workspace 的 bash 工具和文件工具行为有何不同？
- bash 工具：在 WSL 发行版内以配置的用户名运行（空 = 发行版默认用户），可读写发行版内任意位置。由于 Windows ACL 沙箱无法包裹
wsl.exe（其子进程运行在 Linux 内核侧），WSL 本身成为隔离边界，DSH 文件策略不适用于 bash。 - 文件工具（read/write/edit）：通过 Windows 侧的 WSL 9P 共享运行，并受 DSH 文件策略约束。在
workspace-write策略下，读取不受限但写入仅限会话工作区；切换为danger-full-access可允许写入外部。用户名不影响文件工具。
dsh-wsl-workspace 的许可证和归属情况如何？
该插件采用 MIT 许可证，详见 LICENSE 和 NOTICE。NOTICE 明确列出了改编/继承的源代码：DeepSeek Harness（MIT）中的 dsh-bash-local（执行器机制）、dsh-fs-local（WslFileSystem 继承自它）以及随附的 agent 预设（由变体生成器读取和转换）；设计参考（未复制源代码）包括 dsh-bash-terminal（MIT，wsl argv / WSLENV 方法）和 dsh-side-panel。
dsh-wsl-workspace 兼容哪些 DeepSeek Harness 版本和平台？
该插件面向 Windows 平台，需要 DeepSeek Harness 的 Web GUI（dsh web）。它依赖 @deepseek-ai/dsh-fs、@deepseek-ai/dsh-fs-local、@deepseek-ai/dsh-shell、@deepseek-ai/dsh-subprocess 和 @deepseek-ai/dsh-timeout 等官方包，确保与 DSH 生态无缝集成。插件由 6Mikao9 维护，采用 TypeScript 编写，当前 Stars 6、Forks 3，无未解决问题。