95 lines
2.3 KiB
Markdown
95 lines
2.3 KiB
Markdown
# 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 基本完成，核心功能已实现，可以进行真实设备测试。
|