前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时,工作区是存放代码和资源的主要容器。左侧的 Workspace 列表通常只提供切换和查看功能,如果需要在本地文件系统中打开当前工作区对应的文件夹,往往需要手动定位或使用外部命令。这会增加操作步骤,打断开发心流。
dsh-workspace-open 插件通过在工作区列表中直接增加操作入口,解决了这一问题。
功能¶
插件在每个真实工作区行(左侧 Workspace 列表)上增加了一个文件夹按钮。
点击该按钮后,DSH 会调用内置的 ctx.workspaces.openPath(path) 方法,由 Host 进程调用系统默认文件管理器打开对应的工作区文件夹。目前支持以下系统:
* Windows:资源管理器
* macOS:Finder
* Linux:xdg-open 默认文件管理器
安装与启用¶
在 DSH 的 web profile 目录下执行以下命令进行安装:
dsh plugin --profile web add ./dsh-workspace-open
安装完成后,需要重启 DSH Web 服务(Host 侧插件加载),然后刷新浏览器页面即可生效。
工作原理¶
插件采用了双半区架构:
* Host 半区:lib/index.js 是一个空的 apply 函数,仅用于让 DSH 发现并加载本包。
* 浏览器半区:lib/client.js 注册到 DSH 客户端。
在实现方式上,插件优先尝试使用未来版本可能提供的 sidebar.workspaces.row-menu slot。由于当前 DSH 版本(0.1.0-rc.x)暂未提供该 slot,插件会自动回退到 DOM 适配器模式,将文件夹按钮插入到工作区行的 hover 操作区。
注意事项¶
- 显示范围:插件只对“真实 Workspace”行添加按钮;“Ungrouped / 未分组”行不会显示。
- 未来兼容:如果 DSH 官方后续提供稳定的工作区行菜单 slot,本插件会自动切换到原生注册方式。
通过这个插件,可以在不离开 DSH 界面的情况下快速访问本地文件系统,减少切换窗口的操作。
插件源码与文档:
* GitHub: https://github.com/1274623767/dsh-workspace-open
* Catalog: https://www.skillhub.cn/plugins/1274623767/dsh-workspace-open