开发成果 12/15
- 需求梳理与交互结构(4 个主 Tab + 建档流程)
- 美术资源:吉祥物 / 20 个习惯图标 / 官网配图
- Flutter v1.0:打卡、统计、奖励、习惯管理
- 自建 Node 同步后端 + 家庭邀请码登录
- 官网 + HTTPS + 每日备份上线
- 设计规范文档(tokens / components / screens / assets)
- v1.1:做家务奖励 + 惩罚项「无理取闹」扣花
- v1.2:习惯库 19 个推荐习惯 + 底部导航对比度修复
- v1.3:一人多机拆成人/设备两层 + 配对码 + 删除墓碑
- 源码托管:Gitee 私有仓库 + 免密推送
- v1.3.1:老 session 回填 deviceId(分清本机 / 防误踢自己)
- 竖版宣传片:8 屏截图 + 中文旁白(1080×1920 / 72.9s)
- 真机安装 v1.3.1(等手机插上 USB)
- iOS 原生打包上架(需 Apple 开发者账号)
- 剩余 3 处对比度设计债(牵涉品牌蓝压深)
项目简介
Flutter 单代码库(iOS / Android / Web)+ 自建零依赖 Node 同步后端 + 官网。线上:https://xiaohonghua.filebreeze.cn(/app/ 网页版,/download/little-blossom.apk 安卓包)。设计规范以 5 个 HTML 页面沉淀在 design/。
开发历程 8 条
竖版宣传片:8 屏真机截图 + 中文旁白(生成脚本可重跑)
成片:
dist/xiaohonghua-promo.mp4— 1080×1920 / 30fps / 72.9 秒 / H.264+AAC / 15.5MB,手机上可直投视频号、抖音、小红书。结构(8 屏):欢迎页 → 首页打卡 → 19 个习惯库 → 惩罚与二次确认 → 成长统计 → 攒花换奖励 → 两台手机同步 → 品牌结束卡。
做法:
tools/make_promo.py—— PIL 逐屏排版(渐变底 + 柔光色块 + 圆角截图卡 + 阴影 + 字幕)+say -v Tingting生成中文旁白 + ffmpegzoompan做缓慢推镜,每屏时长跟随旁白自动伸缩,最后 concat 合成。踩过的坑:
1. homebrew 这版 ffmpeg 没编
drawtext(Unknown filter)→ 字幕改由 PIL 画进画面2. PIL 在 RGBA 图上画半透明是替换不是混合 → 标题底衬变成实心蓝方块;必须走独立图层
alpha_composite3. 柔光色块的模糊超出图层边界时露出方形边缘 → 图层要预留 blur×2.2 的内边距
4.
-loop 1 -i img默认输入 25fps,导致成片只有 1821 帧(应为 2184)→ 加-framerate 30后 2185 帧 / 29.99fps5. 应用图标 PNG 四角是白底 → 贴图前必须按圆角裁 mask,否则是个白方块
验收:抽帧出 8 屏联系表逐屏核对(内容与字幕相符、无黑帧/截断);
volumedetect均值 -18.8dB / 峰值 -2.4dB,确认旁白已混入。v1.3.1:回填 deviceId,修掉「分不清本机 / 能把自己踢下线」
现象:设置 → 家庭成员里两台设备都显示「移除」、没有「这台」标记,能把自己踢下线。
根因:
isMyDevice()拿session.deviceId比,但 v1.2 以前存的本地 session 没这个字段;而服务端GET /api/state早已返回me.deviceId,只是ApiClient.fetchState只解析了me.name,把设备身份丢了。修法:RemoteState 增
deviceId/deviceLabel并解析;Session 增copyWith;refresh()里若本地 deviceId 为空则从服务端回填并持久化(老用户升级后自动修好,不用重新登录);身份未知时隐藏「移除」并给出提示,作为最后一道防护。验证:
flutter analyze0 问题;flutter test36 项全过(新增 device_identity_test 4 项)。v1.3.0:一人多机拆成人/设备两层,修掉取消打卡被撤销
问题:飞哥指出「app 好像没解决一个人有多个手机」。实测比这更宽:手机 1 取消打卡 → 手机 2 推旧快照 → 服务端打卡数 0→1,取消被撤销,两个人两台手机同样中招。
根因:① 「成员」其实就是「设备」,每台手机加入就是新 member;② 整份快照 + 并集合并,删除没墓碑,取消/删除在另一端必然复活;③ 成员重复、无法踢设备下线。
修法:服务端 member 拆出
devices[](token 归设备,老数据启动自动迁移,不用重新登录);新增 6 位数字配对码(10 分钟一次性)把新手机绑到同一成员;CheckIn/Reward加deletedAt改软删除;加入页两种身份,设置页可看设备并踢下线。验证:本地 server 8 项端到端全过(老 token 可用 / 成员不重复 / 码一次性 / 踢设备后 401);
flutter test32 项全过;真机小米装 v1.3.0 截图确认。上线:apiVersion=2,2 个家庭均迁移为 1 人 1 设备,打卡与习惯数据完好,已备份。
代码推到 Gitee 私有仓库,本地与远端打通
- 仓库:https://gitee.com/(账户)/little-blossom(私有,halley2026 账号下首个仓库)
- 共 4 个提交,远端 master =
ee120e9,211 个文件(App 124 / 设计稿 40 / 官网 17 / 文档 11 / 素材 9 / 工具 4 / 后端 2 / 校验清单 1) - 入库前已确认排除:
dist/*.apk(60.7MB,只留 SHA-256 清单)、server/data.json(线上真实家庭数据)、build/、.dart_tool/ - 凭据:本仓库级别
credential.helper = store --file=(本机路径)(权限 600),git push免输密码 - 踩坑:
(服务器路径)系统级挂了osxkeychain,git 会先问钥匙串 → 弹出授权窗口 → 无人值守时命令直接卡死被杀(exit 137)。修法:本仓库 config 先用credential.helper=空值清空继承链,再加 store,才能免弹窗 - README 补「源码托管」章节(克隆地址 + 为何不含 APK/数据)
踩坑合集:Gradle 缺 .ok 标记、代理环境变量、UTF-16-LE 搜中文
- Android 构建无输出卡 19 分钟:真因不是网络也不是内存,而是
(本机路径)里只有 zip 和解压目录、缺.ok完成标记,Gradle 每次都重新下载 234MB。touch .../gradle-9.3.1-all.zip.ok解决。千万不要把 distributionUrl 换成镜像 —— 目录名是 URL 的哈希,换了等于重新下载。 flutter test/flutter run报 Invalid WebSocket upgrade:本机HTTP_PROXY=127.0.0.1:51582干扰。必须env -u HTTP_PROXY -u HTTPS_PROXY ... NO_PROXY=127.0.0.1。flutter build apk报 Unable to locate a Java Runtime:要显式JAVA_HOME=(服务器路径)。- 无头 Chrome 一启动就 FATAL(GPU process isn't usable):必须
--no-sandbox --disable-gpu --disable-dev-shm-usage。 - release web 包里的中文搜不到:被编译成
\uXXXX转义,直接 grep 中文字符串一定是 0;APK 里libapp.so则是 UTF-16-LE。两者都要编成对应形式再查。 - 设计稿全局样式会泄漏:
a { border-bottom }把侧边导航也画上了下划线,看起来像分隔线错位。 - 8GB M1 同时跑无头浏览器 + web 编译:load average 能上 30,编译从 70s 拖到 5 分钟以上;先关浏览器再编译。
- Android 构建无输出卡 19 分钟:真因不是网络也不是内存,而是
v1.2.0 发布:习惯库 19 个推荐习惯 + 两处关键对比度修复
- 版本:v1.2.0+3(Android APK 约 60MB,含 3 个 ABI)。
- 新增:习惯库 19 个推荐习惯,6 个分组:生活自理 / 吃饭 / 学习专注 / 礼貌社交 / 运动睡眠 / 要扣花的事。点一下就加,不用自己写名字。
- 新图标 6 个:洗手泡沫、绘本、打招呼、皮球草地、书包、水杯 —— 同批生成、同套去白底,和原 8 个黏土图标放在一起没有断层。
- 顺带修的对比度:底部标签栏未选中态
#B4C0D2(1.84:1)→inkMute5.64:1;花数字#E05A76(3.56:1)→ 新增令牌flowerInk #B3244A6.43:1,全站 7 处一起换。 - 顺手发现的 bug:习惯编辑弹层直接改的是列表里同一个对象 —— 改到一半点取消也会生效(实测把「无理取闹」1 朵改成 3 朵后取消,列表真变了)。改成传副本、保存才按 id 回写。
- 验证:
flutter analyze干净;flutter test22 项全过(新增 10 项:重名检测、与默认习惯不撞名、图标非空、分组顺序、扣花分组一致、模板转习惯 id 唯一等);无头浏览器真实点击走完“设置 → 每日习惯 → 习惯库 → 加一个 → 回列表能看到”。
四个产品口径:惩罚不进分母、库而非全开、扣花两步走
1)惩罚项不进分母。 首页大数字是「今天已经收到 4 / 7 朵」。分母只算奖励项,被扣的花不扣减这个数字,而是单独一行「⊖ 今天扣掉 1 朵」。
理由:直接减会让 5 岁孩子看到自己的成果倒退,惩罚从教育变成挫败。
2)贴花一步,扣花两步。 点「记一次」先弹确认,按钮上写死数字「确定扣 1 朵」,并明说可以再点一次撤销。加花误点只是多一朵,扣花误点是拿走孩子已经得到的东西。
3)习惯做成「库」,不是全塞进默认列表。 库里 19 个推荐习惯,默认只开 7 个(6 奖励 + 1 扣花)。用户原始需求就写了「每天四五个好习惯」,一次全开等于没有重点。挑的动作本身就是一次家长决策。
4)扣花按钮不用粉底白字。 粉色实心块上白字只有 2.16:1,儿童端等于看不清。一律「浅底深字」(alertSoft / alert = 4.95:1)。
5)老家庭迁移用固定 id。
h_seed_chores_v2/h_seed_tantrum_v2,两台手机各补一次mergeFrom时按 id 去重不会变成两行;迁移标记只落本机,用户手动删掉后不会被加回来。v1.0 全链路:Flutter 客户端 + 自建 Node 同步后端上线
- 需求:5 岁女儿(幼儿园大班)爱睡懒觉、不爱刷牙。首页建档只要名字/年龄/性别;我和老婆两部手机同步;每天 4–5 个好习惯,贴小红花;月度统计换奖励。
- 技术选型:Flutter 单代码库(iOS/Android/Web),
provider+shared_preferences存 JSON 快照(不用 SQLite,避免平台差异);后端自写 零依赖 Node(一个 server.js + data.json),pm2 + nginx + certbot 部署到 (服务器IP)。 - 为什么不用托管云服务:官方云服务 SDK 只有 JS,Dart 直接请求
/.cloud/**属违规用法 —— 换成自建后端反而更简单可维护。 - 美术:内置生图工具出图(黏土质感、马卡龙色),本地 Pillow 做去白底 + 切图 + 缩放到 256px。去白底的坑:floodfill 后强制 alpha=255 会把吉祥物变成黑方块 —— 必须真算 alpha 通道再从四角验证 alpha==0。
- 验收方式:不用“看起来对”,而是 Flutter Web + 无头 Chromium + CDP 脚本真实点击截图(tools/cdp.js),逐页查溢出、截图、读文案。
周期
2026-10-26 → 未定