前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在 Web UI 中,默认的工作区目录选择器从 Linux 主目录开始,且面包屑导航在此折叠。在 WSL 环境下,Windows 驱动器通常挂载在 /mnt/c、/mnt/d 等路径,默认选择器很难通过点击找到这些目录,且无法通过面包屑导航到根目录。dsh-wsl-workspace-picker 插件通过插槽优先级覆盖的方式,重写了默认的浏览对话框,解决了这个问题。
是什么¶
这是一个纯 UI 插件,用于增强 DeepSeek Harness Web UI 的工作区目录选择体验。它由 WilliamShi666 维护,采用 MIT 许可证。
核心功能¶
该插件提供了以下功能,旨在简化在 WSL 环境下的文件系统导航:
- 快捷访问芯片:提供 Home、
/、/mnt以及常见 Windows 挂载点(如/mnt/c、/mnt/d、/mnt/e、/mnt/f)的一键访问。 - 始终可见的路径输入:可以直接输入绝对路径(例如
/mnt/d/projects)并按回车确认。 - 完整的面包屑导航:面包屑从根目录
/开始,不再在 Home 目录折叠。 - 文件操作:支持创建新文件夹和切换显示隐藏文件。
安装与启用¶
在安装之前,请确保本地运行着 DeepSeek Harness 0.1.0-rc.6 及以上版本(web profile)。
执行以下命令安装插件:
dsh plugin --profile web add dsh-wsl-workspace-picker
安装完成后,重启 dsh web 并刷新浏览器页面。在侧边栏的 workspaces 区域点击 + 按钮,或在 conversation-hero 区域打开工作区选择器,即可看到增强后的对话框。
卸载¶
如需移除该插件,执行以下命令:
dsh plugin --profile web remove dsh-wsl-workspace-picker
技术原理与限制¶
该插件注册在 directoryFlow 插槽上(包括 sidebar.workspaces.directoryFlow 和 conversation.hero.workspace.directoryFlow),优先级为 -10。DSH 的插槽系统采用“最低优先级优先”的原则,因此优先级 -10 会覆盖默认的优先级 0 插件。卸载该插件后,默认对话框将自动恢复。
在实现上,该插件复用了主机现有的 browse 能力(即 ctx.workspaces.listDirectory 和 createDirectory),不包含任何主机端代码或网络连接请求。
插件要求环境中有 /mnt/<drive> 的挂载点(典型的 WSL 环境)。在其他环境下,快捷芯片可能仅显示不存在的目录,但不影响使用。