# disk.cleaner.master

**Repository Path**: Hellcs/disk.cleaner.master

## Basic Information

- **Project Name**: disk.cleaner.master
- **Description**: disk cleaner master 磁盘清理大师
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电脑C盘清理大师 (Disk Cleaner Master)

一个基于Flutter开发的现代化磁盘清理工具，具有直观的用户界面和强大的系统清理功能。

## 功能特性

### 🏠 首页功能
- **实时磁盘状态显示** - 显示C盘使用情况和可清理空间
- **3D动画垃圾桶** - 吸引人的浮动动画效果
- **功能卡片导航** - 快速访问各种清理功能
- **一键清理** - 简单直观的清理操作

### 🔍 详细清理页面
- **分类清理** - 按软件和系统文件分类显示
- **图标化界面** - 直观的应用程序图标显示
- **选择性清理** - 支持勾选/取消勾选特定项目
- **实时大小统计** - 显示总大小和已选择大小

### 🛠️ 支持的清理类型
- **软件专清**
  - 微软产品缓存
  - Chrome浏览器数据
  - Edge浏览器数据
  - WPS办公软件缓存
  - QQ聊天记录
  - 系统日志文件
  - 系统缓存文件

- **系统不常用文件**
  - 系统补丁残留
  - 安装包残留文件
  - Office缓存文件

## 技术架构

### 前端技术栈
- **Flutter** - 跨平台UI框架
- **Provider** - 状态管理
- **Material Design 3** - 现代化设计语言

### 核心组件
- `CleanerProvider` - 主要业务逻辑和状态管理
- `FileScannerService` - 文件扫描和清理服务
- `MainScreen` - 主界面容器
- `HomeView` - 首页视图
- `DetailView` - 详细清理页面
- `AnimatedTrashCan` - 3D动画垃圾桶组件

## 安装和运行

### 环境要求
- Flutter SDK 3.0.0+
- Dart SDK 3.0.0+
- Windows 10/11 (主要支持平台)

### 安装步骤

1. **克隆项目**
   ```bash
   git clone https://gitee.com/Hellcs/disk.cleaner.master.git
   cd disk_cleaner_master
   ```

2. **安装依赖**
   ```bash
   flutter pub get
   ```

3. **运行应用**
   ```bash
   flutter run -d windows
   ```

### 构建发布版本
```bash
flutter build windows --release
```

## 项目结构

```
lib/
├── main.dart                 # 应用入口
├── models/
│   └── clean_item.dart      # 数据模型
├── providers/
│   └── cleaner_provider.dart # 状态管理
├── services/
│   └── file_scanner_service.dart # 文件扫描服务
├── screens/
│   └── main_screen.dart     # 主屏幕
├── widgets/
│   ├── sidebar.dart         # 侧边栏
│   ├── home_view.dart       # 首页视图
│   ├── detail_view.dart     # 详情页视图
│   └── animated_trash_can.dart # 动画垃圾桶
└── utils/
    └── app_theme.dart       # 主题配置
```

## 设计特色

### 🎨 视觉设计
- **品牌色彩** - 绿色主色调 (#00C48C) 配合橙色强调色 (#FF6B00)
- **现代化界面** - 圆角卡片、阴影效果、渐变背景
- **响应式布局** - 适配不同屏幕尺寸

### ✨ 交互体验
- **平滑过渡** - 页面切换动画效果
- **视觉反馈** - 悬停效果和点击反馈
- **直观操作** - 拖拽选择和一键操作

### 🔄 动画效果
- **浮动动画** - 垃圾桶上下浮动
- **旋转动画** - 轻微的摆动效果
- **文件图标** - 随机浮动的文件类型图标

## 安全特性

- **选择性清理** - 用户完全控制清理内容
- **安全提示** - 清理前的警告和说明
- **模拟清理** - 开发版本使用模拟数据，确保安全

## 扩展计划

- [ ] 添加更多清理类型
- [ ] 支持macOS和Linux
- [ ] 集成C++核心引擎
- [ ] 添加定时清理功能
- [ ] 支持自定义清理规则

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 贡献

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

---

**注意**: 这是一个演示版本，实际的文件清理功能需要系统级权限和更复杂的实现。在生产环境中使用前，请确保充分测试并备份重要数据。