前言¶
在 DeepSeek Harness (DSH) 的会话视图中,右侧边栏通常用于展示上下文或输出。master1sun/dsh-file-workbench-lib 插件将这一区域改造为一个功能完备的 Web 工作台。它基于 Vue 3 + Vite 构建,提供类似 Windows 11 资源管理器的文件浏览体验,并内置了多标签代码编辑器和持久化终端。所有功能共享同一个工作区根目录,旨在减少在浏览器与本地应用之间切换的频率。
插件定位¶
该插件由用户 master1Sun 维护,是一个功能集成的 DSH Web 插件。它主要解决在 Web 环境下进行文件操作、代码编写和终端交互的需求,将原生桌面应用的能力迁移到了浏览器端。
核心功能¶
插件在右侧边栏提供了三个核心面板:
文件工作台¶
提供单窗口 Win11 风格的资源管理器界面。支持多视图模式(如大图标、列表、详情等)、拖拽调整布局、目录优先的不区分大小写排序、以及递归搜索(支持正则表达式)。具备完整的 CRUD(增删改查)功能、回收站、外部拖拽上传、压缩解压等操作。
文件编辑器¶
基于代码编辑器。支持多标签页编辑,通过扩展按需加载 TypeScript/JavaScript/Python 等语言支持。编辑器具有面包屑导航、项目树(状态持久化)以及右键菜单操作。文件保存操作绑定在 Ctrl+S。
持久终端¶
使用 ConPTY 和 node-pty 提供真实的控制台语义,支持中文输出和全屏 TTY 程序。终端是一个全局单例,会话在面板关闭后依然存活。支持多标签(最多9个),标签页可悬浮、拖拽、调整大小。在 Windows 环境下关闭面板时,会通过 taskkill /T 命令清理进程树,防止孤儿进程残留。
Git / SVN 管理¶
在文件工作台和编辑器中均可通过右键唤起。Git 面板提供变更、历史、分支、标签、远程、暂存和命令行操作;SVN 面板提供更新、提交、冲突解决等功能。
外部视图注入¶
插件支持外部插件通过 Activity Bar 注册自定义视图,无需依赖 Vue 或 React 框架。
使用方式¶
插件没有提供输入框按钮,主要通过右侧边栏的指南区域进入:
- 打开工作台:在右侧边栏指南区域点击对应卡片(顺序:File Workbench 100 -> File Editor 101)。
- 终端操作:在文件列表中右键目录,选择 “Open in Terminal”。
- 文件编辑:右键文件选择 “Edit” 打开内置记事本,或选择 “Handle with sub-agent” 将文件交给子代理处理。
- 保存文件:在编辑器中按
Ctrl+S保存。
技术细节与注意事项¶
- 文件查看委托:文件列表的查看功能(如 Markdown、代码高亮、图片预览)委托给 DSH 原生查看器。如需编辑,请使用内置编辑器或右键 “Edit”。
- 权限标识:终端标签页右上角会显示权限徽章,指示当前会话是管理员还是标准用户。
- Windows 清理:在 Windows 系统关闭插件终端时,会执行
taskkill /T清理进程树。 - 外部注册:外部脚本可通过
window.__dshFileWorkbenchVSCode__.activityBar.register或window.__dshFileWorkbenchWorkbench__.activityBar.register注册视图。
总结¶
该插件通过 Web 技术实现了类桌面应用的开发体验。对于需要在 DSH 中频繁进行文件管理、代码编写和终端交互的用户,它提供了一个高效的集成方案。安装请参考官方目录或 GitHub 仓库。