涵盖路线步量换算、uHabits 风格家务习惯与生活记录 (探店/影视/图书) 的全能跨平台助手
- 作者声明：非码农专业，本程序根据个人需求高度量身定制。
- 如果你也有类似的个人记录与生活打卡需求，欢迎参考或使用。
- 纯 AI 独立迭代打造，解决问题的能力几乎 = 0（笑）。
| 🏃 步量路线打卡 | 🏠 uHabits 家务习惯 | 🛍️ 生活记录与打卡 |
|---|---|---|
| 客观路线资产、公里/千卡精准推算 | 5天近况矩阵、1.2k量化缩写 | 影视/图书/探店、Card与列表双视图 |
- 客观路线资产拆分 (
RouteItem)：将路线固定属性（名称、描述、测量人、测量步数、isLocked锁定）与具体打卡履约日志（StepLog）严格解耦。 - 锁定防误触防护：支持对重要路线进行一键锁定，锁定状态下防止误删或误改。
- 一键
⚡ 记一次：根据路线参考步数快速倍增打卡，自动精准换算实际里程 (km) 与卡路里消耗 (kcal)。
- 5 天日期近况矩阵：主页直观展示近 5 天打卡状况，符合大拇指舒适触控区间 (
38x38dp)。 - 量化打卡智能格式化 (
1.2k)：开启量化属性的家务（如买菜记账元），打卡格取消✓勾选，自动换算展示如1.2k/15k/1.5M等智能缩写。 - 单项独立热力图与饼图 (
ChoreDetailScreen)：点击任意家务可生成专属的年度 Calendar Heatmap 热力图与成员贡献占比饼图。
- 基础模板体系：内置影视观影、餐饮美食、通用记录等多套模板，新建时一键选用；通用模板支持自定义字段（文本/多行/数字/日期/标签）。
- 影视模板 + TMDB：一键搜索电影/电视剧并自动填充海报、题材、剧情简介、导演主演、剧集总集数；媒体类型（电影/电视剧）与题材（科幻/动作…）二级分类，海报 2:3 竖版 + 文字环绕排版。
- 观看状态与进度：影视支持 想看/在追/看完/搁置/抛弃 快捷标记与筛选；电视剧/动漫可按集数打卡，浏览卡片直接展示
看了 x/y 集进度条。 - 短评长评：种草理由升级为「一句话点评」快速展示在卡片，新增「长评」仅详情页展示。
- 观看平台多选：平台改为多选列表，历史已用平台自动成为快捷选项，支持自由新增（如自建 Jellyfin），卡片同步展示；卡片同时展示题材徽章（二级分类）。
- 影视二级筛选：媒体类型（电影/电视剧/动漫…）、题材（科幻/动作…）、上映年份可叠加筛选，快速定位想看的内容。
- 餐饮菜单管理：店铺菜单固定菜品与价格；菜品支持自由添加份量规格（如 大份/小份、面条一两/二两/三两），每个规格可单独定价，打卡选菜时按规格计价并自动合计消费；历史打卡记录可修改（金额/成员/点菜/点评/时刻）。
- 1.0 ~ 5.0 亮金星级 Rating 评分：支持在表单中自由点选星级评分，列表直观星级呈现。
- 照片画廊 (至多 3 张)：集成
image_picker选择器，图片写入应用缓存，支持至多 3 张剧照/海报/店铺实拍照片预览。 - Card 模式 ↔ 紧凑列表模式：3D 玻璃网格卡片与单行紧凑列表双视图切换，上次视图选择自动在数据库持久化记忆。
- 可收缩分类侧边栏 (Drawer)：自定义分类创建、重命名与安全平滑删除（删除后记录自动归类到“通用未分类”）。
- 设置中心：生活页右上角统一入口，缓存统计与上限清理、TMDB API Key（v3/v4 通用）、默认打卡成员等；支持 WebDAV 云同步 备份与恢复。
Member实体融合了姓名、性别、身高 (cm)、体重 (kg)、年龄与自定义步长。- 步量 Tab 和家务 Tab 共享同一套家庭成员档案库。
- 步量打卡时自动联动选定成员的专属身高与体重，实现多成员差异化精准里程与 MET 卡路里换算。
针对 Android 不同 CPU 芯片架构，系统提供了 4 种规格的最终可执行构建产物（位于 build/app/outputs/flutter-apk/）：
| 文件名 | 适用 CPU 架构 | 文件大小 | 推荐说明 |
|---|---|---|---|
StepLife-v1.6.3-arm64-v8a.apk |
64 位 ARM (arm64-v8a) |
26.9 MB | 🔥 最推荐！适配 99% 的现代 Android 手机 |
StepLife-v1.6.3-armeabi-v7a.apk |
32 位 ARM (armeabi-v7a) |
24.7 MB | 适配老旧 32 位 Android 机型 |
StepLife-v1.6.3-x86_64.apk |
Intel/AMD (x86_64) |
28.3 MB | 适配 Android 模拟器与 x86 平板 |
StepLife-v1.6.3-universal.apk |
通用全架构胖包 | 66.0 MB | 整合全架构二进制，兼容任意设备 |
- 核心框架: Flutter (Dart) Material 3 & Google Fonts (
Outfit) - 状态管理: Provider (
ProfileProvider,StepProvider,ChoreProvider,StoreProvider) - 本地持久化: SQLite (
sqflite/sqflite_common_ffi，Schema v9 兼容升级，旧版数据安全接管合并迁移，菜品规格/打卡规格非破坏新增) - 影视数据: TMDB v3 API（v3 Key / v4 Token 自动识别）
- 云同步: WebDAV 备份与恢复
- UI 风格: Modern Frosted Glassmorphism (毛玻璃模糊 + 霓虹暗夜色彩系统)；全局输入框提示文字统一淡灰小字号，避免喧宾夺主
- 图像选择:
image_picker
- Windows 桌面端运行：
flutter run -d windows
- Android 设备运行：
flutter run -d <android-device-id>
flutter build apk --release --split-per-abi项目内置 GitHub Actions 工作流（.github/workflows/release.yml），推送版本 tag 后自动在 CI 构建 4 个 APK（universal / arm64-v8a / armeabi-v7a / x86_64）并发布到 Releases：
# 更新 pubspec.yaml 的 version 后，提交并推送 tag 即可自动发布
git add -A && git commit -m "chore: release v1.5.0"
git tag v1.5.0+20260819
git push origin main --tags也可以在 GitHub Actions 页面手动触发 Build & Release APKs（自动读取 pubspec 版本号，可勾选发布为草稿）。
- v1.4.9 起使用固定正式签名（
android/steplife-release.jks，本仓库 .gitignore 忽略，不随代码分发），所有 Release 签名一致，跨版本升级不再提示「签名不一致」。 - 一次性卸载说明：v1.4.8 及更早版本由 CI 临时 debug 密钥签名，与 v1.4.9 正式签名不同，本次升级必须卸载旧版一次。卸载前请先在应用内 设置中心 → 数据与同步（WebDAV）→ 立即上传 备份，卸载重装后 立即恢复 即可，数据不丢。v1.4.9 之后的版本升级不再需要卸载。
- CI 签名配置（GitHub Secrets）：
.github/workflows/release.yml从以下 Secrets 读取正式签名，未配置时构建会直接失败（防止再产出 debug 签名包）：ANDROID_KEYSTORE_BASE64：steplife-release.jks的 Base64 内容ANDROID_STORE_PASSWORD/ANDROID_KEY_PASSWORD/ANDROID_KEY_ALIAS
flutter build windows --release项目内附带有 docs/architecture.md 架构说明与 AGENTS.md AI 协作规范，包含详细的数据库 Upgrade 升版规则、桌面 FFI 适配规则、解耦与成员换算规则，方便后续无缝接续维护。
本项目采用 MIT License 协议开源。