dsh-file-explorer

English | 中文

DSH Web 的文件浏览器。页面边缘有一个浮动「文件」按钮，点击打开左侧抽屉（工作区文件树），点文件在右侧浮出可拖拽/缩放的预览框。点击会话区"生成的文件"芯片或工具行文件链接，会自动在预览框中打开对应文件，而非跳到系统默认应用。

截图

浅色	深色

功能

1. 浮动入口：屏幕边缘始终可见的「文件」把手，点击开关文件浏览器抽屉。
2. 左抽屉：左侧全高抽屉（fixed），标题栏带刷新 + 关闭按钮，内含工作区文件树。
3. 文件浏览：懒加载目录树，跟随当前会话的工作区根目录，切换会话时自动刷新。
4. 悬浮预览框：点文件在右侧浮出可拖拽/缩放/最小化/关闭的预览框。
5. 文件预览：内置文本（源码）、Markdown（渲染 + 源码切换）、图片（data URL）、二进制（文件信息）预览。
6. 可扩展预览：通过 fileExplorer 服务按扩展名注册预览器，未注册的扩展名回退到 binary 预览。新增蛋白质结构（.cif/.pdb → Mol*）、CSV、PDF 等预览器无需改动核心。
7. 行操作菜单：hover 文件/目录行末尾出现「···」菜单（打开 / 复制绝对路径 / 复制相对路径）。
8. 快捷键：Ctrl/Cmd+Shift+E 开关文件浏览器抽屉。

安装

从 git 仓库安装（推荐）：

dsh plugin --profile web add github:wolfsonliu/dsh-file-explorer
dsh web

或从本地目录安装：

git clone https://github.com/wolfsonliu/dsh-file-explorer
cd dsh-file-explorer
npm install
npm run build
dsh plugin --profile web add .
dsh web

配置

组合包默认启用以下配置：

- insert:
    - id: file-explorer
      name: '@dsh-external/dsh-file-explorer'
      config:
        maxTextBytes: 2097152
        maxImageBytes: 10485760

配置项	默认值	说明
maxTextBytes	2 MiB	可预览的单个文本文件大小上限
maxImageBytes	10 MiB	可预览的单个图片大小上限

数据层

宿主半部通过 ctx.webServer.register() 注册一个 精确路由，动作（ 查询参数）：