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 倉庫