拾光记是一款功能丰富的多平台习惯追踪和个人管理应用，帮助用户养成良好习惯，提高工作效率，记录生活点滴。通过直观的界面和强大的功能，为用户提供全方位的个人管理解决方案。
- 待办事项管理：创建、编辑、删除待办事项，标记完成状态，设置优先级
- 习惯打卡与追踪：创建习惯，设置提醒，记录打卡历史，查看统计数据
- 富文本日记：支持图片、音频等附件，Markdown 格式，标签管理
- 番茄钟专注计时：专注时间管理，记录专注历史，提高工作效率
- 数据统计与分析：习惯打卡统计，待办事项完成率，专注时间分析
- 积分兑换系统：通过完成任务获得积分，兑换各种奖励
- 回收站功能：恢复误删除的项目，防止数据丢失
- 个人中心：用户信息管理，应用设置，主题切换
- 管理员功能：通过特殊方式进入管理员注册界面
- 多平台支持：同时支持移动端、桌面端和 Web 端
- 响应式设计：适配不同屏幕尺寸
- 数据备份：定期自动备份，手动备份选项
- 主题切换：支持明暗主题
- 框架：Flutter 3.0+
- 状态管理：BLoC (flutter_bloc)
- 依赖注入：Riverpod (flutter_riverpod)
- 富文本编辑器：Flutter Quill
- UI 组件：Material Design
- 移动端/桌面端：SQLite (sqflite)
- Web 端：模拟内存数据库
- 配置存储：SharedPreferences
- 移动端：Android 6.0+, iOS 12.0+
- 桌面端：Windows 7+, macOS 10.14+, Linux (Ubuntu 18.04+)
- Web 端：现代浏览器
- Flutter SDK 3.0+
- Dart SDK 2.17+
- Android Studio / VS Code (推荐)
- 对应平台的开发工具链
-
克隆仓库
git clone https://github.com/ydxt/momentkeep.git cd momentkeep -
安装依赖
flutter pub get
-
运行应用
-
移动端：连接设备后运行
flutter run
-
Web 端：
flutter run -d chrome
-
桌面端：
# Windows flutter run -d windows # macOS flutter run -d macos # Linux flutter run -d linux
-
-
构建 Web 版本
flutter build web
-
构建桌面版本
# Windows flutter build windows # macOS flutter build macos # Linux flutter build linux
-
构建移动版本
# Android flutter build apk # iOS flutter build ios
momentkeep/
├── android/ # Android 平台代码
├── ios/ # iOS 平台代码
├── lib/ # 核心代码
│ ├── core/ # 核心配置、服务、主题和工具
│ ├── domain/ # 领域模型和实体
│ ├── presentation/ # UI 层（页面、组件、BLoC）
│ ├── services/ # 数据库服务
│ └── main.dart # 应用入口
├── web/ # Web 平台代码
├── windows/ # Windows 平台代码
├── macos/ # macOS 平台代码
├── linux/ # Linux 平台代码
├── assets/ # 静态资源
└── docs/ # 文档
- 打开应用
- 进入"关于"界面
- 连续点击应用图标 5 次
- 输入暗号：
admin_reg - 填写管理员注册信息
- 点击"注册"按钮
- 用户管理：查看和管理所有用户
- 系统设置：修改系统级设置
- 数据管理：备份和恢复系统数据
- 日志查看：查看系统日志
我们欢迎并感谢所有形式的贡献！无论是功能开发、Bug 修复、文档改进还是建议，都可以帮助我们改进这个项目。
-
Fork 仓库 在 GitHub 上点击 "Fork" 按钮，将仓库复制到您自己的账号下。
-
创建分支
git checkout -b feature/your-feature-name
-
进行修改 实现您的功能或修复 Bug。
-
提交更改
git commit -m "Add: your feature description" -
推送分支
git push origin feature/your-feature-name
-
创建 Pull Request 在 GitHub 上提交 Pull Request，描述您的更改内容和目的。
- 遵循 Flutter 官方代码风格指南
- 为关键代码添加注释
- 确保代码可测试性
- 运行
flutter analyze检查代码质量
项目使用 BLoC 模式进行状态管理，所有的状态管理逻辑都位于 lib/presentation/blocs/ 目录。
- 使用
DatabaseService进行数据库操作 - 使用
SharedPreferences存储配置信息 - Web 端使用模拟数据库实现
- 应用主题定义在
lib/core/theme/app_theme.dart - 主题状态管理在
lib/core/theme/theme_provider.dart - 支持明暗主题切换
- 忘记密码：点击登录页面的"忘记密码"链接，按照提示重置密码
- 无法登录：检查网络连接，确认账号和密码是否正确
- 数据备份：应用会定期自动备份数据，也可以在设置中手动备份
- 数据导出：在个人中心的"数据管理"中选择"导出数据"
- 数据恢复：可以从最近的备份中恢复数据
- 应用卡顿：清理缓存，关闭后台应用，或重启应用
- 应用崩溃：重启应用，如问题持续，请提交 Issue 并提供崩溃日志
- 邮箱：support@momentkeep.com
- GitHub Issues：提交问题
- 微信公众号：拾光记
- 微博：@拾光记APP
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件
- Flutter 团队 - 提供了强大的跨平台框架
- 所有贡献者 - 感谢你们的辛勤工作和创意
- 所有用户 - 感谢你们的支持和反馈
感谢使用拾光记！ 希望这款应用能够帮助您养成良好习惯，提高生活质量。如有任何问题或建议，欢迎随时联系我们。