qwen_agent/WEBDAV_GUIDE.md

📁 文件管理服务

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

🌐 访问方式

1. Web界面（推荐）

直接在浏览器中打开：

http://localhost:8001/public/file-manager.html

2. REST API

基础地址：

http://localhost:8001/api/v1/files

✨ 主要功能

🚀 文件操作

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

🎯 高级功能

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

📚 API 使用

文件列表

curl "http://localhost:8001/api/v1/files/list?path=uploads"

上传文件

curl -X POST "http://localhost:8001/api/v1/files/upload" \
  -F "file=@example.txt" \
  -F "path=uploads"

下载文件

curl "http://localhost:8001/api/v1/files/download/uploads/example.txt" -o example.txt

文件夹压缩下载

curl -X POST "http://localhost:8001/api/v1/files/download-folder-zip" \
  -H "Content-Type: application/json" \
  -d '{"path": "uploads"}' \
  -o uploads.zip

批量下载

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压缩
• 流式文件下载

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