# kuake

**Repository Path**: SkySystem/kuake

## Basic Information

- **Project Name**: kuake
- **Description**: 夸克网盘批量修正文件名等。。。。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-09-14
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 夸克网盘文件管理器

一个基于Spring Boot后端和原生前端技术的夸克网盘文件管理工具，提供直观的文件浏览、搜索、下载等功能。

## 功能特性

### 🎯 核心功能
- **文件列表展示**: 支持列表视图和网格视图
- **文件夹导航**: 面包屑导航，支持进入子文件夹
- **文件搜索**: 实时搜索文件名
- **文件下载**: 支持单个文件和批量下载
- **文件详情**: 查看文件详细信息
- **分页浏览**: 支持自定义每页显示数量

### 🎨 界面特性
- **现代化设计**: 采用渐变色彩和卡片式布局
- **响应式布局**: 支持桌面和移动设备
- **图标系统**: 根据文件类型显示不同图标
- **加载状态**: 优雅的加载动画和空状态提示
- **消息提示**: 操作反馈和错误提示

### ⚙️ 技术特性
- **RESTful API**: 基于Spring Boot的后端服务
- **原生前端**: 使用HTML5、CSS3、JavaScript ES6+
- **模块化设计**: 面向对象的JavaScript架构
- **本地存储**: 设置信息本地保存
- **错误处理**: 完善的异常处理机制

## 项目结构

```
kuake/
├── src/main/java/com/example/kuake/     # Spring Boot后端代码
│   ├── controller/QuarkController.java  # REST API控制器
│   ├── service/QuarkService.java        # 业务逻辑服务
│   ├── entity/                          # 实体类
│   └── config/                          # 配置类
├── index.html                           # 前端主页面
├── styles.css                           # 样式文件
├── script.js                            # JavaScript逻辑
└── README.md                            # 项目说明
```

## 快速开始

### 1. 启动后端服务

```bash
# 进入项目目录
cd kuake

# 使用Maven启动Spring Boot应用
mvn spring-boot:run
```

后端服务将在 `http://localhost:8080` 启动

### 2. 打开前端页面

直接在浏览器中打开 `index.html` 文件，或使用本地服务器：

```bash
# 使用Python启动简单HTTP服务器
python -m http.server 8000

# 或使用Node.js
npx http-server
```

### 3. 配置Cookie

1. 点击页面右上角的"设置"按钮
2. 输入你的夸克网盘Cookie信息
3. 点击"保存设置"
4. 刷新页面开始使用

## API接口

### 获取文件列表
```
GET /api/quark/files
```

**参数:**
- `folderId`: 文件夹ID，默认为"0"表示根目录
- `page`: 页码，从1开始，默认1
- `pageSize`: 每页大小，默认20
- `cookie`: 夸克网盘Cookie（必需）
- `eagleeyeTraceid`: 追踪ID（可选）

**响应示例:**
```json
{
  "status": 200,
  "code": 0,
  "message": "",
  "timestamp": 1757829582,
  "data": {
    "list": [
      {
        "fid": "file_id",
        "file_name": "example.txt",
        "size": 1024,
        "file_type": 0,
        "dir": false,
        "created_at": 1757829582,
        "updated_at": 1757829582
      }
    ],
    "metadata": {
      "size": 20,
      "page": 1,
      "count": 1,
      "total": 1
    }
  }
}
```

### 获取网盘信息
```
GET /api/quark/info
```

返回API服务的基本信息和接口说明。

## 使用说明

### 基本操作

1. **浏览文件**: 点击文件夹进入子目录，使用面包屑导航返回上级目录
2. **查看详情**: 点击文件名或详情按钮查看文件信息
3. **下载文件**: 点击下载按钮或使用批量下载功能
4. **搜索文件**: 在搜索框中输入文件名进行实时搜索
5. **切换视图**: 使用列表/网格视图切换按钮改变显示方式

### 高级功能

1. **批量操作**: 选择多个文件进行批量下载或删除
2. **排序功能**: 按名称、大小、日期、类型排序文件
3. **分页浏览**: 调整每页显示数量，使用分页控件导航
4. **设置管理**: 配置Cookie和追踪ID等参数

## 技术栈

### 后端
- **Spring Boot 2.x**: 主框架
- **Spring Web**: REST API支持
- **Jackson**: JSON序列化
- **Swagger**: API文档
- **Maven**: 依赖管理

### 前端
- **HTML5**: 页面结构
- **CSS3**: 样式设计，使用Flexbox和Grid布局
- **JavaScript ES6+**: 交互逻辑，使用类和模块化设计
- **Font Awesome**: 图标库
- **Fetch API**: HTTP请求

## 浏览器兼容性

- Chrome 60+
- Firefox 55+
- Safari 12+
- Edge 79+

## 注意事项

1. **Cookie安全**: 请妥善保管你的夸克网盘Cookie，不要泄露给他人
2. **网络连接**: 确保网络连接正常，API调用需要访问夸克网盘服务
3. **文件权限**: 只能访问你有权限查看的文件和文件夹
4. **下载限制**: 下载功能依赖于夸克网盘提供的下载链接

## 故障排除

### 常见问题

1. **无法加载文件列表**
   - 检查Cookie是否正确设置
   - 确认网络连接正常
   - 查看浏览器控制台错误信息

2. **下载失败**
   - 确认文件下载链接有效
   - 检查浏览器下载设置
   - 尝试单个文件下载

3. **页面显示异常**
   - 清除浏览器缓存
   - 检查JavaScript是否启用
   - 确认CSS文件加载正常

## 开发计划

- [ ] 文件上传功能
- [ ] 文件重命名和移动
- [ ] 文件夹创建和删除
- [ ] 文件预览功能
- [ ] 多账户支持
- [ ] 主题切换
- [ ] 快捷键支持

## 许可证

本项目仅供学习和研究使用，请遵守相关法律法规和夸克网盘的使用条款。

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。

---

**免责声明**: 本工具仅用于技术学习和研究，使用者需自行承担使用风险，开发者不承担任何责任。