# AutoTime Tracker

自动时间追踪与效率分析工具

## 📱 项目简介

AutoTime Tracker 是一款自动追踪应用使用时间并进行分析的效率工具。通过自动化的方式帮助用户了解自己的时间使用，提升效率。

## ✨ 功能特性

- ✅ **自动时间追踪** - 后台自动追踪应用使用时间
- ✅ **智能分类** - 预设分类规则，支持手动调整
- ✅ **数据统计** - 今日/周/月统计，丰富的图表展示
- ✅ **效率评分** - 基于时间分配的效率评分
- ✅ **目标设定** - 设置每日时间目标
- ✅ **数据导出** - 导出 CSV 数据和统计报告
- ✅ **空状态优化** - 友好的空状态和错误处理

## 🛠️ 技术栈

- **Flutter 3.x** - 跨平台框架
- **Riverpod** - 状态管理
- **fl_chart** - 图表库
- **sqflite** - 本地数据库
- **Google Fonts** - 字体系统

## 🚀 快速开始

### 安装依赖
```bash
flutter pub get
```

### 运行项目

**Web 平台（推荐用于开发测试）：**
```bash
flutter run -d web-server
```

**Android 设备：**
```bash
# 1. 连接设备并启用 USB 调试
flutter devices

# 2. 运行应用
flutter run
```

**详细说明：** 查看 [快速启动指南.md](./快速启动指南.md)

### 测试真实数据

**重要：** 测试真实数据需要安装到真实手机设备上！

```bash
# 连接手机后运行
flutter run
```

**详细测试指南：** 查看 [真实数据测试指南.md](./真实数据测试指南.md)

## 📊 开发进度

**当前完成度：** 98%

### ✅ 已完成
- 核心功能完整实现
- 所有主要界面已实现
- 数据层完整（SQLite + DAO）
- 服务层完整（分类、统计、导出等）
- 空状态和错误处理优化
- Web 平台测试数据支持

### ⚠️ 待完善
- 原生 API 实际实现（需要真实设备测试）
- iOS Screen Time API 完整实现
- Android Usage Stats API 完整实现

**详细进度：** 查看 [开发进度.md](./开发进度.md)

## 📚 文档

- [快速启动指南.md](./快速启动指南.md) - 如何运行和测试项目
- [开发进度.md](./开发进度.md) - 开发进度和待办事项
- [真实数据测试指南.md](./真实数据测试指南.md) - 真实设备测试说明

## 📄 许可证

MIT License

---

**项目状态：** MVP 基本完成，核心功能已实现，可以进行真实设备测试。