在 DeepSeek Harness Desktop 中添加工作空间时,应用通常会在 Web 界面渲染一个内置的目录浏览器。这个插件拦截了该流程,直接调用 Windows 原生组件,让用户使用系统级的文件夹选择器。
插件定位¶
这是一个 DeepSeek Harness Desktop 桌面端插件。由开发者 liell 维护,核心价值在于绕过应用内部的目录选择 UI,直接唤起原生 Windows 资源管理器进行文件夹选择。
核心功能¶
- 原生窗口调用:从“添加工作空间”入口(包括对话 Hero 区域和侧边栏)直接打开原生 Windows 文件夹对话框。
- 无 UI 自身:作为渲染无关的客户端插件,自身不持有任何界面代码,仅作为逻辑接入点。
- 系统级体验:利用 Electron 的
dialog.showOpenDialog,提供完整的资源管理器体验(如快速访问、路径导航、新建文件夹)。 - 更新免疫:插件安装在
$DSH_HOME目录下,不会随应用主程序更新而被覆盖。 - 安装幂等:安装脚本可重复执行,不会报错或重复添加配置。
- 无卷限制:支持访问任何可读写的卷,包括 exFAT、FAT32 和网络卷。
安装与启用¶
在仓库根目录下,通过 PowerShell 运行安装脚本。脚本会将插件文件复制到用户目录下的 profiles 文件夹中,并自动修改 cordis.patch.yml 配置文件。
powershell -ExecutionPolicy Bypass -File .\install.ps1
安装完成后,必须重启 DeepSeek Harness Desktop 以加载新插件。插件安装在 $DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker\,这意味着应用更新不会影响其存在。
典型用法¶
- 在 DSH Desktop 中点击“添加工作空间”。
- 系统不再弹出 Web 界面的目录选择器,而是直接显示 Windows 资源管理器对话框。
- 选择目标文件夹后,确认即可创建工作区。
适用场景与注意事项¶
- 操作系统限制:该功能依赖 Windows 原生 Shell 特性,仅支持 Windows 系统。
- 运行环境:需要 DeepSeek Harness Desktop 桌面应用运行。
- 降级机制:如果在未加载桌面桥接(desktop bridge)的环境下运行,插件会回退到主机的
directory-picker接口。 - 权限与安全:由于插件以当前 DSH 进程的权限运行,请确保从可信源安装并检查源码与许可证(MIT)。
总结¶
dsh-workspace-explorer-picker 为 Windows 用户提供了更贴近系统的文件管理体验,且通过安装在用户配置目录下,保证了在应用升级后的稳定性。