前言¶
DeepSeek Harness 原生只有一个文件面板,默认在右侧。对于需要频繁查看文件、与文档对话的开发者来说,这种布局会造成来回切换。本插件通过调整布局,将文件面板移到左侧,同时保留右侧的原生预览能力,形成三栏工作区。
插件定位¶
dsh-three-pane 是 DeepSeek Harness 的一个客户端插件,由维护者 Wfssll 开发。它将原本右侧的「文件」面板移到左侧,文件预览继续留在右边,并在左侧提供一个独立的文件栏开关。
插件不创建新的文件浏览界面,而是复用 Harness 原生组件,只调整面板位置和宽度。这意味着它不存储文件数据,也不自行读取文件,本地文件和 SSH 文件仍由宿主已有文件面板处理。
核心功能¶
布局调整¶
插件安装后,工作区变为三栏布局:
展开时: [ 对话历史(可收起) ] [ 原生文件面板 ] [ 聊天 ] [ 原生文件预览 ]
收起后: [ 对话历史(可收起) ] [ 聊天 ] [ 原生文件预览 ]
文件栏和右侧预览各自管理开关,互不联动:收起预览不会收起文件,开关文件栏也不会开关预览。
独立开关¶
会话历史栏的收起按钮左侧新增一个文件夹图标,点击可独立展开、收起文件栏。历史栏收起后,文件夹按钮仍与「展开会话历史」「新建会话」两个原生按钮一起保留,顺序为「文件 → 会话历史 → 新建会话」。
文件栏顶部不再提供右侧侧栏的控件(分栏、全屏、侧栏收缩按钮),这些控件保留在右侧预览栏中。
预览与拖拽¶
点击文件会在右侧原生侧栏预览。文件栏右边缘可拖动调整宽度;聚焦分隔线后可用左右方向键调节,双击可恢复到 300px。文件栏始终占用独立列,右侧预览优先缩小以保留至少 400px 的聊天区域;极窄窗口下可以横向滚动,不会覆盖聊天内容。
文件栏隐藏后,保留原生文件页签和目录展开状态;文件页签上的关闭按钮也只隐藏文件栏,不关闭预览。
安装¶
Desktop 客户端¶
desktop profile 在应用运行期间由桌面版专门管理,不能通过外部 CLI 修改。
Web 客户端¶
dsh plugin --profile web add https://github.com/Wfssll/dsh-three-pane/releases/download/v0.3.0/dsh-three-pane-0.3.0.tgz
将 web 换成自己的 profile 名称。安装后重新加载客户端,必要时重启该 profile。尚未发布到 npm,请使用 GitHub Release 安装包。
卸载¶
- Desktop:在「插件」页卸载
dsh-three-pane。 - Web:
dsh plugin --profile web remove dsh-three-pane。
适用场景与注意¶
插件已在 DeepSeek Harness 0.2.1-rc.3 的 Web 与官方 macOS Desktop 上验证。其他宿主版本未逐一实测。
插件复用宿主的原生组件,未来宿主升级后可能需要适配。停用或卸载会恢复原生组件并移除自己的样式和布局留白。
插件以当前 DSH 进程权限运行,安装前应检查源码与许可证(MIT)。
总结¶
dsh-three-pane 通过简单的布局调整,为需要同时操作文件和对话的开发者提供了更高效的工作流。它不引入额外的文件系统依赖,完全基于 Harness 原生能力构建,适合习惯原生界面的用户。
- 插件目录页:https://www.skillhub.cn/plugins/Wfssll/dsh-three-pane
- GitHub 仓库:https://github.com/Wfssll/dsh-three-pane