first commit

快速启动指南.md

@@ -0,0 +1,116 @@
+# 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) - 真实设备测试说明
+