dsh-file-explorer：DSH Web 的文件浏览器插件

在 DSH Web 的开发与调试过程中，直接在工作区内部查看文件树和内容是常见的操作需求。该插件为 DSH Web 提供了一个集成的文件浏览器，通过左侧抽屉显示工作区文件树，并在右侧提供可拖拽的预览框，方便开发者快速浏览和检查文件。

是什么¶

dsh-file-explorer 是由 wolfsonliu 维护的客户端插件。它为 DSH Web 添加了文件浏览能力，主要解决在 Web 界面下直接查看工作区文件结构的需求。

安装与启用¶

在终端中执行以下命令安装插件：

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

安装完成后，启动 DSH Web 即可使用。

核心功能¶

1. 浮动入口
   页面左侧边缘有一个浮动的“Files”按钮。默认状态下它收缩为一个小的把手，不干扰主工作区。点击即可展开或切换文件抽屉。

2. 左侧抽屉与文件树
   抽屉占据左侧全屏高度，标题栏包含关闭按钮。内部显示当前会话工作区的文件树结构，支持搜索、排序（名称、大小、修改时间）以及显示/隐藏文件的切换。

3. 文件预览
   点击文件后，右侧会浮动显示一个可拖拽、调整大小的预览框。插件内置了对以下类型的支持：
   * 文本
   * Markdown
   * 图像
   * CSV
   * 二进制文件（以 Hexdump 形式展示）

4. 可扩展预览器
   支持通过 registerViewer 注册自定义预览器，以便支持更多文件类型。

5. 文件操作
   在文件树中选中文件或目录后，支持重命名、移动、复制和删除操作。

6. 快捷键
   使用 Ctrl / Cmd + Shift + E 快速切换文件抽屉的显示与隐藏。

7. 行菜单选择
   在文件树的行菜单（通常为“···”）中选择 “Open with…”，可以为特定文件指定查看器。

典型用法¶

1. 打开文件抽屉
   点击页面左侧边缘的“Files”按钮，或按下快捷键 Ctrl / Cmd + Shift + E，左侧会滑出文件树。

2. 切换查看器
   在预览面板的标题栏或文件树的行菜单中选择 “Open with…”，可以切换当前文件使用的查看器。这有助于处理多种文件类型。

3. 扩展预览能力
   如果需要查看更多文件类型，可以安装额外的预览器插件，插件会自动通过 registerViewer 注册到文件浏览器中。

注意事项¶

1. 预览大小限制
   插件对预览文件的大小有限制，以防止内存溢出：
   * 文本文件最大 2 MiB
   * 图像文件最大 10 MiB
   * 二进制文件最大 64 KiB

2. 二进制检测
   插件通过扫描 NUL 字节来检测文件是否为二进制文件。

3. 路径限制
   所有文件操作路径必须在当前工作区范围内，超出范围的路径会被拒绝。

4. 隐藏文件
   隐藏文件（以点开头的文件）默认不显示，但可以通过界面设置开启显示。

结语¶

dsh-file-explorer 通过提供原生的文件树浏览和可扩展的预览能力，简化了在 DSH Web 中管理工作区文件的过程。对于需要频繁检查代码、配置或数据的开发者，该插件能提升本地调试的效率。

• 插件目录页
• GitHub 仓库