减脂助手

减脂助手是一个本地优先的 Flutter 减脂记录工具，用来追踪每日执行、体重变化、健康数据趋势，以及局域网内的数据同步。

项目的核心取向是：用尽量低的录入成本，把减脂过程中真正会反复看的信息留在本地，而不是把数据拆散在备忘录、健康 App、体重 App 和临时表格里。

功能概览

• 今日记录：任务打卡、体重记录、每日总结
• 数据分析：7 天、28 天、长期趋势和健康详情
• 健康同步：读取授权后的 Apple 健康指标并写入本地记录
• 定位同步：在授权后写入当天位置，可由每日自动触发或手动触发
• 数据管理：本地记录、CSV 导入导出、目标体重
• 局域网同步：同一局域网内的设备发现与记录同步
• 系统提醒：早餐、午餐、晚间、睡眠提醒

平台状态

• iOS：主要使用平台，维护 Apple 健康同步、定位同步、局域网同步和本地提醒
• macOS：主要用于桌面开发、预览和本地数据管理
• Android / Web / Linux / Windows：保留 Flutter 工程支持，但当前不是主要维护和验证平台

隐私与数据

• 应用默认使用本地 Hive 存储，不依赖云端账号体系
• Apple 健康数据只在设备授权后读取，不上传到外部服务
• 定位数据只在授权后写入当天记录，不做后台持续轨迹采集
• 局域网同步只在同一局域网内传输本地记录
• 删除已安装 iOS App 会删除沙盒内本地数据

技术栈

• Flutter / Dart
• Riverpod
• Hive
• fl_chart
• flutter_local_notifications
• share_plus
• nsd / multicast_dns

开发环境

• Flutter 3.11+
• Dart SDK 3.11+
• iOS / macOS：Xcode、CocoaPods
• Android：Android Studio 或命令行 SDK

安装依赖：

flutter pub get
cd ios && pod install

运行：

flutter run
flutter run -d macos
flutter run -d ios

更多开发入口、预览入口和调试数据说明见 docs/development.md。

常用验证

flutter analyze
flutter test

如果改动涉及 provider、持久化、平台能力或发布准备，请按 CONTRIBUTING.md 和 docs/release.md 补充对应验证。

第三方代码

仓库中 vendored 了 third_party/share_plus，用于锁定当前项目实际使用的分享实现。第三方许可证与说明见 NOTICE.md。

文档

• 架构说明：docs/architecture.md
• 开发流程：docs/development.md
• 设计系统：docs/design-system.md
• 发布检查：docs/release.md
• 开发约束：AGENTS.md
• 参与贡献：CONTRIBUTING.md

参与贡献

欢迎提 issue 和 PR。提交改动前请先阅读 CONTRIBUTING.md，并至少运行：

flutter analyze
flutter test

License

本项目基于 MIT License 开源。