# clean_ai

**Repository Path**: cloud-aios/clean_ai

## Basic Information

- **Project Name**: clean_ai
- **Description**: 一款基于大模型AI判断的系统清理工具，旨在通过智能分析替代人工决策，自动识别可清理垃圾文件与不可删除的关键文件，实现安全高效的系统清理。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-02
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Clean AI - AI驱动的系统清理工具

一款基于大模型AI判断的系统清理工具，旨在通过智能分析替代人工决策，自动识别可清理垃圾文件与不可删除的关键文件，实现安全高效的系统清理。

## 项目概述

本项目严格按照《系统智能清理软件需求文档》开发，实现了以下核心功能：

- **文件/目录扫描**：支持系统盘、缓存目录、临时文件等多种扫描范围
- **AI智能判断**：内置安全规则，区分"可安全清理"、"建议保留"、"谨慎清理"、"禁止清理"四类文件
- **安全清理执行**：采用隔离区机制，所有清理文件先移至隔离区而非直接删除
- **便捷的用户界面**：简洁直观的操作界面，支持扫描、清理、设置、帮助四大模块

## 核心特性

### 1. 智能扫描
- 支持默认扫描路径（系统临时文件、缓存目录等）
- 支持自定义扫描范围和文件过滤
- 提取文件详细信息用于AI分析

### 2. AI驱动的安全判断
- 严格保护系统关键文件和用户重要数据
- 基于文件路径、扩展名、大小、访问时间等多维度分析
- 三级别安全标识：SAFE（安全清理）、WARN（谨慎清理）、FORBID（禁止清理）

### 3. 安全清理机制
- 文件移至隔离区而非直接删除
- 支持文件恢复功能
- 隔离区文件定期自动清理

### 4. 用户友好的界面
- 底部导航栏设计，包含扫描、清理、设置、帮助四个模块
- 直观的文件安全等级标识
- 详细的清理前后对比

## 技术架构

- **前端框架**：Flutter（跨平台支持）
- **扫描引擎**：Dart语言实现的文件系统扫描
- **AI分析**：本地模型集成（预留接口）
- **文件操作**：安全的文件移动和恢复机制

## 安全保障

- 内置系统目录白名单，防止误删关键系统文件
- 文件占用检测，避免删除正在使用的文件
- 隐私保护，所有处理均在本地完成
- 隔离区机制，支持误删文件恢复

## 快速开始

1. 克隆项目
   ```bash
   git clone <repository-url>
   cd clean_ai
   ```

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

3. 运行应用
   ```bash
   flutter run
   ```

## 使用说明

1. **扫描**：点击底部导航栏的"扫描"按钮，选择扫描范围并开始扫描
2. **AI分析**：系统自动对扫描到的文件进行AI分析，确定安全等级
3. **清理**：在"清理"页面查看AI判断结果，确认后执行清理操作
4. **设置**：在"设置"页面配置扫描参数、隔离区保留时间等选项
5. **帮助**：在"帮助"页面查看使用指南和常见问题

## 验收标准

本项目按照需求文档的验收标准开发：

- 功能验收：扫描、AI判断、清理功能正常工作
- 安全验收：白名单保护、文件恢复、异常处理、隐私保护机制有效
- 性能验收：资源占用合理，响应迅速

## 许可证

本项目仅供学习和参考使用。

## Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)

For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.