docs: add file explorer

Author: surunzi

docs/.vitepress/sidebar.mts

@@ -99,6 +99,10 @@ export const enSidebar = [
         text: 'Duplicate Cleaner',
         link: '/guide/built-in-plugins/duplicate-cleaner',
       },
+      {
+        text: 'File Explorer',
+        link: '/guide/built-in-plugins/file-explorer',
+      },
       {
         text: 'File Search',
         link: '/guide/built-in-plugins/file-search',
@@ -582,6 +586,10 @@ export const zhSidebar = [
         text: '重复文件清理',
         link: '/zh/guide/built-in-plugins/duplicate-cleaner',
       },
+      {
+        text: '文件管理',
+        link: '/zh/guide/built-in-plugins/file-explorer',
+      },
       {
         text: '文件搜索',
         link: '/zh/guide/built-in-plugins/file-search',

docs/guide/built-in-plugins/file-explorer.md

@@ -0,0 +1,36 @@
+# tinker-file-explorer
+
+A file manager plugin for [TINKER](https://github.com/liriliri/tinker) that provides a full-featured file browser with sidebar navigation, multi-tab support, clipboard operations, and integrated terminal access.
+
+![Screenshot](/file_explorer.png)
+
+## Features
+
+- **Sidebar navigation** — shortcuts to Home, Desktop, Documents, Downloads, Pictures, Music, Videos, detected drives, and custom locations
+- **Multi-tab browsing** — open multiple directories in tabs, reorder tabs via drag and drop
+- **Back/Forward/Up navigation** — browser-like history for seamless directory traversal
+- **List and grid views** — switch between detailed list view and icon grid view
+- **Path breadcrumb** — clickable path segments with an editable path input bar
+- **Real-time filter** — filter files by name with visible/total count display
+- **Sorting** — sort by name, size, or modification time in ascending or descending order
+- **File operations** — create new folders, rename, delete (move to trash)
+- **Clipboard operations** — copy/cut files and paste into another directory within the app
+- **Multi-selection** — Ctrl/Cmd+click for individual selection, Shift+click for range selection, select all
+- **Context menu** — right-click files for show in file manager, open in terminal, copy, cut, rename, delete; right-click blank area for paste, new folder, sort options
+- **File preview** — toggleable preview panel for selected files
+- **Integrated terminal** — open any directory directly in the built-in terminal
+- **Custom locations** — add, edit, and remove your own favorite folders in the sidebar
+- **Auto-refreshing drives** — periodically detects mounted volumes across macOS, Windows, and Linux
+
+## Usage
+
+1. Open "File Explorer" from the TINKER plugin menu
+2. Navigate using the sidebar (shortcuts, drives, and custom locations) or the toolbar (back, forward, up, refresh)
+3. Double-click a folder to enter it, or double-click a file to open it with the default application
+4. Use the view toggle to switch between list view and grid view
+5. Filter files by typing in the search box — press `F` to focus the filter
+6. Right-click on files or blank areas for context menu operations
+7. Use Ctrl/Cmd+C to copy and Ctrl/Cmd+V to paste files within the file explorer
+8. Click the preview button to toggle the file preview panel on the right
+9. Click "Open in Integrated Terminal" from the context menu to open a terminal at the current path
+10. Right-click the "Custom" section in the sidebar to add your own frequently used folders

docs/public/file_explorer.png

@@ -0,0 +1,36 @@
+# tinker-file-explorer
+
+一个面向 [TINKER](https://github.com/liriliri/tinker) 的文件管理插件，提供功能完善的文件浏览器，支持侧边栏导航、多标签页、剪贴板操作和集成终端访问。
+
+![Screenshot](/file_explorer.png)
+
+## 功能
+
+- **侧边栏导航** — 快捷访问主目录、桌面、文档、下载、图片、音乐、视频，以及自动检测的磁盘和自定义位置
+- **多标签页浏览** — 在多个标签页中打开不同目录，支持拖拽排序
+- **后退/前进/上级导航** — 类似浏览器的访问历史，方便在目录间穿梭
+- **列表和图标视图** — 可在详细列表视图和图标网格视图之间切换
+- **路径面包屑** — 可点击的路径分段显示，支持直接编辑路径
+- **实时过滤** — 按文件名过滤，显示可见/总数统计
+- **文件排序** — 按名称、大小、修改时间升序或降序排序
+- **文件操作** — 新建文件夹、重命名、删除（移至回收站）
+- **剪贴板操作** — 复制/剪切文件后在另一个目录中粘贴
+- **多选支持** — Ctrl/Cmd+点击多选，Shift+点击范围选择，全选
+- **右键菜单** — 文件上右键支持在文件管理器中显示、在终端打开、复制、剪切、重命名、删除；空白区域右键支持粘贴、新建文件夹、排序
+- **文件预览** — 可切换的预览面板，预览选中的文件
+- **集成终端** — 可在内置终端中直接打开任意目录
+- **自定义位置** — 在侧边栏添加、编辑、删除自定义的常用文件夹
+- **磁盘自动刷新** — 周期性检测并更新已挂载的磁盘（支持 macOS、Windows、Linux）
+
+## 使用
+
+1. 从 TINKER 插件菜单中打开"文件管理"
+2. 通过侧边栏（快捷位置、磁盘和自定义位置）或工具栏（后退、前进、上级、刷新）进行导航
+3. 双击文件夹进入，双击文件使用默认程序打开
+4. 使用视图切换按钮在列表视图和图标视图之间切换
+5. 在搜索框中输入关键词过滤文件 — 按 `F` 键可快速聚焦过滤框
+6. 右键点击文件或空白区域使用上下文菜单操作
+7. 使用 Ctrl/Cmd+C 复制、Ctrl/Cmd+V 粘贴文件
+8. 点击预览按钮切换右侧的文件预览面板
+9. 在右键菜单中选择"在集成终端中打开"可在当前路径打开终端
+10. 右键点击侧边栏"自定义位置"区块可添加常用文件夹