前言¶

在 WSL 里跑 DeepSeek Harness（DSH）时，Web 客户端里若要绑定工作区或选择本地目录，浏览器或 Linux 侧的文件选择体验往往和 Windows 主机上的习惯不一致：路径映射、权限、以及「到底选的是 /mnt/c/... 还是 Windows 盘符路径」容易让人犹豫。若你主要在 Windows 上开发、通过 WSL 使用 DSH，更希望弹出熟悉的 Windows 文件夹对话框来完成选目录，而不是在 Web 里凑合选一个路径。

下面介绍社区插件 dsh-wsl-windows-folder-picker（维护者 VoidPrim）。它面向 DSH 的 Web 客户端（platform: web），在 WSL 环境下接入 Windows 原生文件夹选择能力。插件归属社区目录 SkillHub，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，是否安装由你自行评估源码与许可证。

这是什么¶

dsh-wsl-windows-folder-picker 一句话定位：在 WSL 中使用 DSH 时，用 Windows 文件夹对话框 完成目录选择（README 原文：Use the Windows folder dialog when using dsh under WSL.）。

• 分类：客户端插件（依赖 @deepseek-ai/dsh-client-ui-workspace 等客户端注入项，作用于 Web 端 UI）。
• 许可证：MIT（见仓库 README 与 package.json）。
• 当前包版本（package.json）：0.1.7-rc.1；要求 DSH >=0.1.7-rc.1，Node >=18.17.0。

核心功能¶

资料中能核实的能力如下，不展开未在 README / package.json 中出现的配置项或 API：

1. WSL + Windows 选目录：针对「DSH 跑在 WSL、人在 Windows 桌面环境用浏览器开 Web 客户端」这一组合，用 Windows 侧文件夹对话框替代默认的选目录方式（与关键词 directory-picker、workspace 一致，和工作区相关 UI 配合）。
2. Web profile 安装：通过 dsh plugin --profile web add ... 安装，说明改动落在 Web 客户端插件链路上，而非单独的后端服务文档。
3. Cordis patch 打包：package.json 中 dsh.bundle.patch 指向 cordis.patch.yml，以 DSH 插件标准方式注入客户端能力。

README 未提供具体操作截图或逐步「点哪里选文件夹」的界面说明；启用后行为以你在 Web 工作区里触发的目录选择流程为准。

安装与启用¶

安装前确认本机 DSH 版本满足 >=0.1.7-rc.1。官方安装命令如下（须原样使用，勿自行拼接其它 github: 路径）：

dsh plugin --profile web add github:VoidPrim/dsh-wsl-windows-folder-picker

安装后需要 重启 DSH，再刷新 Web 页面。README 给出的方式是：

dsh web

卸载：

dsh plugin --profile web remove dsh-wsl-windows-folder-picker

典型用法¶

仓库 README 没有单独的「业务代码示例」；可复现流程就是 安装 → 重启 DSH → 打开 Web 客户端 → 在需要选择工作区目录的场景下使用文件夹选择。建议步骤：

1. 在 WSL 终端确认 DSH 版本不低于 0.1.7-rc.1。
2. 执行上文 dsh plugin --profile web add github:VoidPrim/dsh-wsl-windows-folder-picker。
3. 重启 DSH 后执行 dsh web，在浏览器中打开客户端。
4. 进入与工作区 / 目录绑定相关的界面，触发选文件夹；若环境匹配（WSL 上的 DSH + Windows 侧对话框可用），应出现 Windows 文件夹对话框而非仅依赖 Web 内嵌的选路径方式。

若对话框未出现，先核对是否在 web profile 下安装、是否已重启 DSH，以及当前是否 indeed 在 WSL 中使用 DSH；细节问题可到 GitHub Issues 反馈。

适用场景与注意¶

适合谁

• 在 WSL 中运行 DSH，浏览器在 Windows 上访问 Web 客户端的开发者。
• 希望选目录时走 Windows 原生文件夹 UI，减少 WSL 路径与 Windows 路径混用时的困惑。

注意事项

1. 客户端插件：仅对 Web 客户端生效；安装命令带 --profile web，与后端或其它 profile 无关。
2. 版本对齐：插件包版本与引擎要求均为 0.1.7-rc.1 /rc 线，升级 DSH 或插件时注意 README 中的引擎字段。
3. 权限与安全：插件随当前 DSH 进程与用户权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，自行判断是否用于你的环境。
4. 非 WSL 场景：README 明确面向 WSL；在纯 Linux 或纯 Windows 原生环境是否适用，资料未说明，勿想当然 extrapolate。

结尾¶

dsh-wsl-windows-folder-picker 解决的是 WSL 开发者在使用 DSH Web 客户端时「选目录」体验与 Windows 桌面习惯对齐的问题，安装路径清晰、依赖 DSH >=0.1.7-rc.1。需要目录信息或提交问题时，可参考：

• 社区目录页：https://www.skillhub.cn/plugins/VoidPrim/dsh-wsl-windows-folder-picker
• GitHub：https://github.com/VoidPrim/dsh-wsl-windows-folder-picker