# 📁 文件管理服务

您的项目现在拥有了完整的文件管理功能，通过现代的Web界面和REST API提供。

## 🌐 访问方式

### 1. Web界面（推荐）
直接在浏览器中打开：
```
http://localhost:8001/public/file-manager.html
```

### 2. REST API
基础地址：
```
http://localhost:8001/api/v1/files
```

## ✨ 主要功能

### 🚀 文件操作
- 📤 **上传文件** - 拖拽上传，支持多文件
- 📥 **下载文件** - 单文件直接下载
- 📦 **文件夹压缩下载** - 一键下载整个文件夹为ZIP
- 📋 **批量下载** - 选择多个文件统一打包下载
- 📁 **创建文件夹** - 新建目录结构
- ✏️ **重命名** - 文件和文件夹重命名
- 🗑️ **删除** - 安全删除文件和文件夹
- 🔍 **搜索** - 快速搜索文件
- 📊 **文件信息** - 查看详细信息和预览

### 🎯 高级功能
- ☑️ **批量选择** - 支持全选和部分选择
- 📦 **批量操作** - 多文件同时处理
- 🎨 **现代界面** - 响应式设计，移动端友好
- ⚡ **实时操作** - 快速响应的用户体验

## 📚 API 使用

### 文件列表
```bash
curl "http://localhost:8001/api/v1/files/list?path=uploads"
```

### 上传文件
```bash
curl -X POST "http://localhost:8001/api/v1/files/upload" \
  -F "file=@example.txt" \
  -F "path=uploads"
```

### 下载文件
```bash
curl "http://localhost:8001/api/v1/files/download/uploads/example.txt" -o example.txt
```

### 文件夹压缩下载
```bash
curl -X POST "http://localhost:8001/api/v1/files/download-folder-zip" \
  -H "Content-Type: application/json" \
  -d '{"path": "uploads"}' \
  -o uploads.zip
```

### 批量下载
```bash
curl -X POST "http://localhost:8001/api/v1/files/download-multiple-zip" \
  -H "Content-Type: application/json" \
  -d '{"paths": ["uploads", "data/123"], "filename": "batch.zip"}' \
  -o batch.zip
```

### 其他操作
- `POST /api/v1/files/create-folder` - 创建文件夹
- `POST /api/v1/files/rename` - 重命名
- `POST /api/v1/files/delete` - 删除
- `GET /api/v1/files/search?query=keyword` - 搜索
- `GET /api/v1/files/info/{path}` - 获取文件信息

## 🎨 使用方法

### Web界面
1. 访问文件管理器
2. 拖拽文件到上传区域
3. 点击文件夹旁的"下载ZIP"
4. 使用"批量操作"模式进行多文件选择

### API集成
完整的REST API支持各种客户端集成，适合程序化文件操作。

## 🔧 技术特性

### 🛡️ 安全性
- 路径验证和限制
- 文件大小和数量限制
- 错误处理和用户友好提示

### ⚡ 性能
- 异步文件操作
- 内存中ZIP压缩
- 流式文件下载

现在您可以享受现代化的文件管理体验！