# AutoTime Tracker - 快速启动指南

## 🚀 立即运行

### 1. 安装依赖

```bash
flutter pub get
```

### 2. 运行项目

#### Windows 用户（推荐）

**方式 1：使用运行脚本（最简单）**
```bash
# 双击运行 运行.bat 或在 PowerShell 中运行
.\运行.ps1
```

**方式 2：直接运行命令**
```bash
# Windows 桌面应用
flutter run -d windows

# Web 服务器模式（推荐，兼容性最好）
flutter run -d web-server
# 运行后会显示 URL，在浏览器中打开即可

# Edge 浏览器
flutter run -d edge
```

#### Mac/Linux 用户

```bash
# iOS 模拟器
flutter run -d ios

# Android 模拟器/设备
flutter run -d android

# 或指定设备
flutter devices  # 查看可用设备
flutter run -d <device-id>
```

#### 启动 Android 模拟器（无需 Android Studio）

```bash
# 1. 查看可用模拟器
flutter emulators

# 2. 启动模拟器
flutter emulators --launch <emulator-id>

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

**提示：** 如果还没有模拟器，可以使用 Android Studio 创建，或者使用物理设备（启用 USB 调试后直接 `flutter run`）。

## 📱 界面说明

### 主界面（Today）
- **总时长显示**：大字体显示今日总使用时长
- **效率评分**：基于时间分配的效率评分（0-100%）
- **分类饼图**：可视化展示各分类时间分布
- **Top 应用**：显示今日使用时间最长的 5 个应用

### 统计界面（Stats）
- **时间趋势图**：折线图展示每日总时长趋势
- **分类对比图**：堆叠柱状图对比各分类时间
- **应用详情**：查看每个应用的详细使用数据

### 设置界面（Settings）
- **应用分类管理**：管理应用分类规则
- **时间目标设定**：设置每日时间目标
- **数据与隐私**：数据管理、导出、删除
- **升级到 Pro**：查看高级功能


## 🐛 常见问题

### Q: 运行报错 "No devices found"
**A:** 确保已启动模拟器或连接设备
```bash
# iOS
open -a Simulator

# Android
flutter emulators --launch <emulator-id>
```

### Q: 依赖安装失败
**A:** 检查网络连接，或使用国内镜像
```bash
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
flutter pub get
```

### Q: 图表不显示
**A:** 确保已安装 fl_chart 依赖
```bash
flutter pub get
flutter clean
flutter pub get
```

## 📚 相关文档

- [README.md](./README.md) - 项目概览
- [开发进度.md](./开发进度.md) - 开发进度和待办事项
- [真实数据测试指南.md](./真实数据测试指南.md) - 真实设备测试说明