前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在智能体开发与调试过程中,开发者常需要快速定位当前会话所使用的系统工作目录(cwd)。在 Web UI 环境下,直接调用操作系统打开当前目录是一个高频需求。dsh-open-folder 插件通过在会话页头增加一个入口,将这一操作标准化。
插件介绍¶
dsh-open-folder 是一个 DSH Web UI 插件,由开发者 KureKaruna 维护。它的核心作用是在会话页头最右侧的 conversation.session.header.utilities 区域,向 “Session log” 按钮的左边增加一个 “打开工作区” 按钮。点击该按钮后,插件读取当前 Session 的 cwd,通过 Host 的 workspaces.openPath() 调用操作系统打开该文件夹。
核心功能¶
- 位置与排序:使用
conversation.session.header.utilities列表插槽,注册时设置order: -10,因此会排在默认order: 0的 “Session log” 按钮左侧。 - 自动禁用:当当前会话没有可用
cwd(例如空白会话或异常会话)时,按钮会自动处于禁用状态。 - 权限与实现:纯浏览器插件,Host 侧为无操作入口。按钮调用 Host 的
workspaces.openPath(cwd),因此打开的是当前 Session 真正的工作目录,而非浏览器前端路径。
安装与启用¶
下载插件文件后,在本地终端执行以下命令:
cd C:\Users\Jason-Woo\Desktop && dsh plugin --profile <你的profile> add .\dsh-open-folder
安装完成后启动 Web UI,打开任意工作区会话,在页头右侧 Session log 左边即可看到 “打开工作区” 按钮。
典型用法¶
- 启动 DeepSeek Harness Web UI。
- 打开任意一个有明确工作目录的会话。
- 点击页头右侧工具栏中的“打开工作区”按钮。
- 操作系统将根据当前 Session 的
cwd打开对应的文件夹。
适用场景与注意¶
该插件适合需要在 Web UI 界面中快速跳转至当前智能体上下文工作目录的开发者。使用时需注意,按钮的操作权限由 DSH 的 Host 提供,安装前建议检查源码与许可证。
结语¶
dsh-open-folder 提供了一个低成本的目录跳转方案,将 Web UI 与本地文件系统操作打通。
- GitHub: https://github.com/KureKaruna/dsh-open-folder
- 生态目录: https://www.skillhub.cn/plugins/KureKaruna/dsh-open-folder