From adc639c3e6fca9ff4865d846876394a2898ec5df Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Fri, 13 Mar 2026 01:26:12 +0000 Subject: [PATCH] Update README.md --- README.md | 406 ++++++++++++++++-------------------------------------- 1 file changed, 117 insertions(+), 289 deletions(-) diff --git a/README.md b/README.md index 5837af6..48f2ab5 100644 --- a/README.md +++ b/README.md @@ -1,337 +1,165 @@ -**轻断食APP** -（治愈手账版） -**产品设计方案** +# 轻断食APP -版本：V3.0（综合优化版） +**治愈手账版** -核心定位：你的随身健康手账 +[![Platform](https://img.shields.io/badge/platform-WeChat%20App%20%7C%20iOS%20%7C%20Android%20%7C%20H5-blue)](https://gitee.com/zigzagwag/fasting-app) +[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) -支持终端：微信小程序 / App (iOS & Android) / H5 +## 📱 项目简介 -目录 +轻断食APP（治愈手账版）是一款以"正念、陪伴、极简手账"为核心理念的轻断食辅助应用。通过结合临床营养学研究，提供无焦虑、精细化、高安全性的断食记录与健康管理工具。 -提示：请右键点击目录，选择"更新域"以显示正确的页码 +### 核心定位 +**你的随身健康手账** - 不同于市面上硬核的"运动表盘"设计，本应用采用温暖治愈的手账风格，帮助用户在轻松愉悦的氛围中完成断食目标。 -一、项目概述 +### 支持终端 +- 微信小程序 +- App (iOS & Android) +- H5 -1.1 项目背景 +--- -轻断食（Intermittent -Fasting，简称IF）是一种科学有效的饮食与健康管理方法，通过在规律的时间段内禁食，促进身体消耗糖原、燃烧脂肪，并触发细胞自噬。根据《新英格兰医学杂志》关于间歇性断食的综述，以及针对女性内分泌特征的断食研究，轻断食已被科学证实能有效改善代谢、促进减脂。 +## ✨ 核心功能 -然而，市面多数应用采用硬核的"运动表盘"设计，配以冷冰冰的倒计时，容易引发容貌焦虑、暴食反弹，甚至因缺乏医学筛查导致女性内分泌紊乱。多数初学者在实践中面临"不知道该断多久"、"忘记记录时间"、"缺乏正反馈"等痛点。本项目旨在打造一款专业的轻断食辅助应用，以"正念、陪伴、极简手账"为核心理念，结合临床营养学研究，提供一款无焦虑、精细化、高安全性的断食记录与健康管理工具。 +### 🏥 健康初筛与安全守护 +- 首次使用进行"健康问诊"，收集BMI、年龄、健康史 +- 医学红线初筛机制，温柔劝退不适宜人群 +- SOS一键求救功能，及时响应身体不适 -1.2 项目目标 +### ⏱️ 智能陪伴式计时器 +- 可视化的断食进度环，带有生长动画 +- 身体时间轴实时科普（血糖平稳期 → 糖原消耗期 → 燃脂期 → 细胞自噬期） +- 温和的饮水提醒与不适急救提示 -1. 精准计时与陪伴：提供直观的断食倒计时与正向计时器，配合本地通知提醒，将功能高度浓缩，用手绘插画和动态科普缓解倒计时压迫感。 +### 📊 数据追踪与反馈 +- 断食时长记录与体重追踪 +- 情绪与饮水量多维度记录 +- 手账涂改液功能，支持历史记录修改 +- 女性生理期联动模式 -2. 闭环的数据反馈：结合断食记录与体重追踪，形成数据对比，给予用户坚持的动力，让用户直观看到"水分充足的日子情绪更好"。 +### 🎨 四大主题皮肤 +| 主题 | 适合人群 | 视觉意象 | +|------|----------|----------| +| 燕麦拿铁 | 女性/温暖治愈系 | 生长藤蔓、伸懒腰的小猫 | +| 挪威森林 | 男性/沉稳专注系 | 树木年轮、露营篝火 | +| 星际漫游 | 深度放松系/深色模式 | 发光星轨、月相变化 | +| 复古牛皮纸 | 极简硬核/数据党 | 手绘虚线、网格纸 | -3. 安全第一（Safety - First）：建立严格的医学红线初筛机制，温柔劝退不适宜人群，在用户首次打开App时进行"健康问诊"。 +--- -4. 千人千面推荐：基于性别、BMI与生理期数据，智能分配梯度断食方案，实现精细化、个性化的健康管理体验。 +## 🛠️ 技术架构 -5. 低门槛多端覆盖：借助UniApp技术栈，首发微信小程序以极低获客成本验证市场，后续平滑过渡至独立App。 +### 技术栈 +- **前端框架**: UniApp (跨平台开发) +- **设计规范**: + - 纸张呼吸感底色 + - 连续曲率与手绘边缘 (20px-24px圆角) + - 错位填色插画风格 + - 印章式交互动效 -6. 容错机制：提供灵活的补录和修改功能，适配真实生活场景，修改后的记录打上"手写修正贴纸"UI标记。 +### 数据结构 -1.3 目标用户 +**用户健康档案 (UserProfile)** +- `gender`: 性别 +- `bmi`: 体重指数 +- `medicalRisks`: 疾病史 +- `unlockedBadges`: 累积打卡印章数 +- `activeTheme`: 当前主题 -- 减脂瘦身人群：核心用户，希望通过控制进食窗口达到减重目的，需要科学的指导与陪伴。 +**综合断食记录 (FastingRecord)** +- `planId`: 断食计划类型 +- `duration`: 实际完成时长 +- `status`: 完成状态 (completed/sos) +- `mood`: 情绪反馈 +- `periodPhase`: 生理期阶段 +- `waterIntake`: 饮水量 -- 忙碌的上班族：需要简单的工具提醒自己何时可以进食，追求极简高效的记录体验。 +--- -- 健康数据控：喜欢记录身体数据、观察趋势的自律人群，重视数据的可视化呈现。 +## 📦 安装说明 -- 女性用户群体：特别关注生理期与断食的关联，需要更细腻的健康指导和情绪支持。 +### 微信小程序 +1. 克隆项目到本地 +2. 使用微信开发者工具打开项目 +3. 导入项目目录即可运行 -二、界面设计规范（多主题治愈手账系统） +### App 端 (iOS/Android) +```bash +# 安装依赖 +npm install -2.1 核心设计语言：不变的"手账骨架" +# 运行到微信小程序 +npm run dev:mp-weixin -本应用抛弃传统的"硬核健身"和"冷冰冰的科技表盘"风格，将设计理念定位为"随身携带的健康手账"。女性用户在减脂或断食期间，往往伴随着心理压力，我们通过视觉元素的生长、昼夜更替的插画，给予用户"你在变得更好"的情感暗示。 +# 运行到H5 +npm run dev:h5 -- 纸张呼吸感：摒弃纯白，采用带微弱纸张噪点（Noise - Texture）的底色，减少屏幕对眼睛的刺激。 +# 运行到Android +npm run dev:app-android -- 连续曲率与手绘边缘：全局采用20px-24px平滑圆角；局部提示框采用和纸胶带（Washi - Tape）分割线，模仿手账贴纸的效果。 +# 运行到iOS +npm run dev:app-ios +``` -- 错位填色插画：核心图标采用"深灰色纤细描边 + - 莫兰迪色块轻微错位填充"，呈现高级的法式/日系微卡通感，避免使用高饱和度的儿童画色彩。 +### 构建生产版本 +```bash +# 微信小程序 +npm run build:mp-weixin -- 印章式交互：打卡成功时触发"咔哒"声的手账盖章动效；按钮点击带有解压的"果冻物理回弹"效果。 +# Android +npm run build:app-android -- 优雅不幼稚：卡通元素主要体现在错位填色图标、植物生长隐喻、无脸/极简五官的优雅女性插画上，保持成熟女性的精致感。 +# iOS +npm run build:app-ios +``` -2.2 四大精选主题皮肤（满足全人群审美） +--- -为满足不同用户的审美偏好，应用提供四大精选主题皮肤。每个主题都拥有独特的视觉意象、配色方案和陪伴插画，用户可在"知己"页面自由切换，打造专属的数字健康手账。 +## 📖 使用指南 - -------------------------------------------------------------------------------------------------- - **主题名称** **适合人群 & **核心配色方案** **进度环与陪伴插画** - 视觉意象** - -------------- ---------------------- ------------------ ----------------------------------------- - ① 燕麦拿铁 女性偏爱/温暖治愈系 背景：#FAF9F5 生长藤蔓：随时间长出叶子 - (Oat Latte) 阳光、桌面手账、生机 主色：#FFC8C3 陪伴主角：伸懒腰的小猫/喝咖啡的极简女孩 - 文字：#5C5454 +### 首次使用 +1. **健康建档**: 按照提示填写身高、体重、年龄等基本信息 +2. **医学筛查**: 完成健康问卷，系统将为您推荐适合的断食方案 +3. **选择主题**: 在"知己"页面选择您喜欢的主题皮肤 - ② 挪威森林 男性高频/沉稳专注系 背景：#F4F6F4 树木年轮：颜色逐渐注满 - (Nordic 深呼吸、植物学笔记 主色：#6B8E7B 陪伴主角：极简山脉轮廓、燃烧的露营篝火 - Forest) 文字：#2C3531 +### 开始断食 +1. 在首页点击「开始今日断食」 +2. 观察身体时间轴，了解当前阶段的生理变化 +3. 如感不适，点击SOS按钮求助 +4. 结束断食后打卡，记录身体状态 - ③ 星际漫游 深度放松系/深色模式 背景：#1A1D24 发光星轨：显示月相的变化 - (Starry Night) 宇宙、月相盈亏、助眠 主色：#BFAEE3 陪伴主角：闭眼冥想的宇航员/线条鲸鱼 - 文字：#E5E9F0 +### 查看记录 +- 进入「足迹」页面查看历史打卡记录 +- 点击日历查看每日详情 +- 如需修改历史记录，使用"手账涂改液"功能 - ④ 复古牛皮纸 极简硬核/纯粹数据党 背景：#EADCB7 手绘虚线：随时间被碳素笔涂实 - (Vintage 档案袋、网格纸、速写 主色：#D05B43 陪伴主角：纯粹的网格线与手写百分比 - Kraft) 文字：#1E1E1E - -------------------------------------------------------------------------------------------------- +--- -表2-1 四大精选主题皮肤对比 +## 🤝 贡献指南 -2.3 字体规范（文艺手账感） +欢迎提交 Pull Request 或创建 Issue！ -为了配合微卡通和治愈系的风格，字体选择应摒弃过于方正、严肃的黑体，转而采用圆润、带有一定书写感的字体体系，营造"手账本上的温馨留言"的感觉。 +1. Fork 本仓库 +2. 创建特性分支 (`git checkout -b feature/xxx`) +3. 提交更改 (`git commit -m 'Add xxx'`) +4. 推送分支 (`git push origin feature/xxx`) +5. 提交 Pull Request -- 数字字体（核心）：计时器数字采用类似Baloo或Quicksand的圆体等宽英文字体，数字显得饱满可爱，削弱倒计时的焦虑感。 +--- -- 中文字体：标题使用圆体（如苹果系统的平滑圆体），正文保持系统常规无衬线体（PingFang - SC），字重偏向较细的Regular或Light，凸显呼吸感。 +## 📄 开源协议 -- 点缀字体：每日的"鼓励语/健康贴士"可采用轻微的手写体，营造"手账本上的温馨留言"的感觉。 +本项目基于 MIT 协议开源。 -2.4 核心界面元素与图形设计 +--- -2.4.1 "微波浪"与"连续曲率"圆角 +## 📧 联系方式 -全面弃用直角。卡片使用20px-24px的大圆角（连续曲率），甚至可以在特定卡片（如我的记录卡片）顶部使用极轻微的波浪线边缘，模仿手账贴纸的效果。按钮统一为胶囊状(Pill-shape)，按钮带有对应主题色的弥散阴影，增加界面的悬浮感和精致度。 +- 项目地址: https://gitee.com/zigzagwag/fasting-app +- 问题反馈: https://gitee.com/zigzagwag/fasting-app/issues -2.4.2 断食陪伴环（视觉中心） +--- -这是吸引女性用户的"杀手锏"设计，将原先单调的SVG进度环升级为"情景化插画进度环"。进度环内部不再是空白，而是带有极简的插画背景。如果是白天断食，内部是缓慢飘动的云朵和太阳；如果是夜间，内部会自动切换为深蓝底色、散落的星星和弯月。进度环的轨道本身设计成一根"藤蔓"或"花环"，随着断食时间的增加，藤蔓上会逐渐"长"出小叶子或含苞待放的花朵；当达到目标时间时，花朵完全绽放，并触发撒花瓣的动效。 - -2.5 插画与动效规范 - -2.5.1 减压动效设计 - -- 呼吸反馈：在断食进行中，首页的背景和计时环会有周期为4秒的极微弱"呼吸放大缩小"动效，引导用户跟随节奏深呼吸，缓解饥饿带来的焦虑。 - -- 果冻弹跳（Jelly - Bounce）：点击任何按钮，按钮会有轻微的果冻Q弹物理效果，增加交互的趣味性和解压感。 - -- 打卡盖章动效：在日历视图中，当用户完成当天的断食，会有一个类似手账本"盖下可爱印章"的动画，伴随轻快的一声"啵"的音效，提供极强的情绪价值和成就感。 - -三、功能需求分析（医学严谨与个性化治愈版） - -3.1 功能架构总览 - -应用架构在原有的基础上，新增了"健康初筛与个性化引擎"，确保安全第一。通过将【计划】模块化身为"手账书签与抽屉面板"整合进首页，应用实现了极致的"一屏专注"体验。 - - ------------------------------------------------------------------------------------------------------ - **模块名称** **核心功能** **功能描述** - --------------- ------------------- ------------------------------------------------------------------ - 启程（全新） 健康筛查与建档 收集BMI/年龄/健康史，触发生命安全拦截机制，生成专属方案 - - 今日（首页） 陪伴式计时器 身体状态时间轴、当前生理阶段科普、SOS不适急救、温和饮水提醒 - - 计划（融合） 智能模式推荐 基于身体数据的梯度解锁（12:12 → 14:10 → 16:8），融入首页书签抽屉 - - 足迹（记录） 身心状态复盘 记录断食时长、体重曲线、每日情绪与生理期记录，支持手账涂改液修正 - - 知己（我的） 个性化健康库 主题手账本商城、女性激素周期与断食指南、食谱推荐、医学科普卡片 - ------------------------------------------------------------------------------------------------------ - -表3-1 功能架构总览 - -3.2 健康初筛与"温柔劝退"机制 - -轻断食并非适合所有人。本应用引入强医学介入约束，在用户首次打开App时进行"健康问诊"。这一机制确保了用户在开始断食前充分了解自身状况，避免因不当断食造成的健康风险。 - -3.2.1 身体档案建立 - -- 基础数据：收集年龄、身高、体重（自动计算BMI）、日常活动量，为后续个性化推荐提供数据支撑。 - -- 生理状态：询问当前是否处于生理期、备孕期，针对女性用户提供更细腻的健康关怀。 - -- 健康问卷（红线勾选）：列表包含"是否怀孕或哺乳期"、"是否未成年"、"是否有进食障碍史"、"是否患有1型糖尿病/低血糖症"等关键问题。 - -3.2.2 触发"温柔劝退"机制 - -如果用户勾选了上述任何红线选项，或BMI \< 18.5（体重过轻），或年龄 \< -18岁，系统将锁定断食核心功能。交互设计为弹出一张带有拥抱插画的卡片，文案表达为："亲爱的，系统检测到您当前的身体状况需要更多的营养和呵护。强行断食可能会伤害到您。我们暂时为您关闭了断食功能，但您依然可以使用我们的喝水记录和健康食谱功能。比起变瘦，我们更在乎您的健康。" - -3.3 智能计划推荐：基于用户画像的精细化方案 - -科学研究表明，女性对长时间禁食的应激反应比男性更敏感，容易导致皮质醇升高或影响甲状腺功能。因此，应用拒绝"一刀切"，采用算法推荐与梯度解锁机制。 - -3.3.1 新手与女性保护方案（12:12 或 14:10） - -- 触发条件：无断食经验的新手，或BMI处于正常偏下范围的女性。 - -- 科学依据：14小时禁食能有效改善胰岛素敏感性，同时极大程度避免女性因长时间断食导致的脱发、大姨妈出走等内分泌紊乱问题。 - -- UI表现：标记为"温和唤醒"模式，推荐给该类用户。 - -3.3.2 标准减脂方案（16:8） - -- 触发条件：BMI ≥ 24（超重），且已有至少一周的14:10成功打卡经验。 - -- 科学依据：16小时断食是启动"细胞自噬"和显著燃烧脂肪的黄金窗口，是临床验证最有效的断食时长之一。 - -3.3.3 进阶模式的"防沉迷"锁定 - -为了防止用户急于求成，高难度模式（如超过18小时断食）在初期是锁定的，必须积累足够的"温和断食"勋章后方可解锁，且每周限制开启次数，避免过度节食。 - -3.4 首页核心：陪伴式计时器与"身体时间轴" - -传统的计时器只显示倒计时，容易引起焦虑。本应用将计时器设计为"一场身体内部的奇妙旅行"，根据断食的小时数，实时告诉用户体内正在发生什么，给予正向反馈。 - - --------------------------------------------------------------------------------------------------------------------------------------------- - **时间段** **身体状态** **治愈文案与行动建议** - --------------- -------------------------- -------------------------------------------------------------------------------------------------- - 第 0-4 小时 【血糖平稳期】 食物正在转化为能量，血糖慢慢恢复平稳。此时可以喝一杯温水哦。 - 胃部正在安静消化 - - 第 4-8 小时 【糖原消耗期】 胃空了，饥饿感素开始分泌，这是正常的波峰。忍耐一下，它像海浪一样很快会退去。建议喝黑咖啡或绿茶。 - 饥饿波峰出现 - - 第 8-12 小时 【燃脂准备期】 肝脏里的糖原库存快见底啦，身体即将切换引擎，准备去仓库（脂肪）里拿能量了！ - 身体小火炉升温 - - 第 12-14 小时 【轻度生酮与燃脂期】 恭喜！你已正式进入燃脂模式。身体正在燃烧顽固脂肪，代谢变得更清晰。 - 女性黄金点 - - 第 16 小时以上 【细胞自噬期】 抗衰老阶段 奇妙的'细胞自噬'开启了，身体正在自我大扫除，清理受损细胞，这也是断食抗衰老的秘密。 - --------------------------------------------------------------------------------------------------------------------------------------------- - -表3-2 身体时间轴动态提示 - -3.4.1 【SOS】一键求救与终止机制 - -在计时器下方提供一个醒目的"我不舒服 -(SOS)"按钮。如果用户在断食期间感到头晕、心慌、手抖（低血糖症状），点击该按钮后系统立即停止计时，弹出急救卡片，提醒用户补充糖分。SOS中止不计入失败记录。 - -3.5 记录与复盘：整合女性生理周期 - -女性的体重和食欲受生理期（荷尔蒙）影响巨大。本应用创新性地将生理期追踪与断食记录整合，提供更人性化的健康管理体验。 - -3.5.1 "大姨妈"联动模式 - -- 生理期标记：在日历中允许用户标记生理期，系统自动识别不同生理阶段的身体需求。 - -- 智能降级建议：当检测到用户处于经期前一周（黄体期）或经期中时，系统会自动弹出提示，建议暂停断食或将目标降级为轻松的12:12。 - -3.5.2 情绪与饮水追踪 - -- 多维度记录：结束断食打卡时，除了记录时间，增加"今日情绪"和"饮水量"的选择。 - -- 数据关联洞察：通过图表关联，让用户直观看到"原来我喝水够的那天，情绪和断食完成度都很好"，从而培养综合健康习惯。 - -- 手账涂改液（容错修改机制）：点击过去日期，可手动调整开始/结束时间，修改后的记录会打上"手写修正贴纸"UI标记。 - -四、界面功能模块拆解（三Tab极简架构） - -APP底部导航栏精简为3个错位填色图标的标签页，将复杂的计划选择无缝融入首页交互中，实现极致的"一屏专注"体验。 - -4.1 【今日】（首页：集成计划选择与计时伴随） - -首页是用户停留时间最长的"手账主页"，采用双状态切换（Dual-State -UI）设计，分为断食态与进食态，根据用户当前状态自动切换界面呈现。 - -4.1.1 状态机流转逻辑 - -1. 等待开启态：按钮显示「开始今日断食」，点击后伴随盖章动效，进度环归零开始生长。 - -2. 断食进行态：按钮变更为「结束断食」（防误触需长按1秒或滑动），进度环随时间变化，时间轴高亮当前身体代谢阶段。 - -3. 进食窗口态：达成目标后自动或手动结束，界面色调变暖，按钮变更为「开始下一轮断食」，页面中心展示营养补充建议卡片。 - -4.1.2 断食态页面布局 - -- 问候与书签区（顶部）：左上角显示手写体每日寄语。手账书签式计划切换，点击标签从底部平滑升起抽屉式面板，陈列梯度方案。 - -- 身体旅程环（视觉中心）：展示基于当前主题的动态进度环，随时间推移显示不同阶段的插画与温和科普。 - -- 行动操作区（中下部）：巨大的胶囊形按钮带果冻Q弹动效，SOS一键求救按钮位于下方。 - -- 状态时间轴（底部）：像手账时间轴一样，预测并展示今天的关键节点。 - -4.2 【足迹】（记录：复盘与图表） - -- 网格纸日历：抛弃传统红绿点，打卡成功显示"主题专属印章"（如挪威森林主题盖上一片小松叶）。 - -- 身心联动图表：手绘平滑曲线展示体重变化，下方叠加情绪色块分布与饮水达标率。 - -- 手账涂改液：点击过去日期可手动调整时间，修改后打上"手写修正贴纸"UI标记。 - -4.3 【知己】（我的：健康库与个性化） - -- 主题手账本商城：在此自由切换四大视觉主题皮肤，打造专属的数字健康手账。 - -- 身体档案与红线设置：修改身高体重、开关生理期追踪，管理个人健康档案。 - -- 女性/健康专栏：保留基础设置与健康档案管理，科普内容已碎片化场景化提取至首页。 - -五、数据结构设计 - -5.1 用户健康档案 (UserProfile) - - --------------------------------------------------------------------------- - **字段名** **类型** **说明** **业务逻辑用途** - ---------------- ------------ ------------------ -------------------------- - gender string 性别 决定默认推荐与防沉迷阈值 - - bmi number 体重指数 \<18.5 触发断食锁死 - - medicalRisks array 疾病史 触发守护卡拦截 - - unlockedBadges number 累积打卡印章数 用于解锁高阶断食计划 - - activeTheme string 当前主题 渲染前端皮肤引擎 - --------------------------------------------------------------------------- - -表5-1 用户健康档案数据结构 - -5.2 综合断食记录 (FastingRecord) - - ----------------------------------------------------------------------- - **字段名** **类型** **说明** - ----------------- ------------- --------------------------------------- - planId string 记录本次使用的断食计划 (如 16:8) - - duration number 实际完成时长（小时） - - status string completed (完成) / sos (安全中止) - - mood string 情绪反馈 (平静/烦躁/活力/无力) - - periodPhase string 当前所处生理期阶段 - - waterIntake number 当日饮水量（杯） - ----------------------------------------------------------------------- - -表5-2 综合断食记录数据结构 - -六、总结与扩展规划 - -6.1 设计亮点总结 - -本方案通过深度融合V1.1版本的功能完整性与V2.1版本的架构简洁性，打造出一款兼具医学严谨性与情感温度的轻断食应用。核心亮点包括：四大主题皮肤系统满足不同用户审美需求；三Tab极简架构实现"一屏专注"体验；六大阶段身体时间轴将抽象的生理变化具象化；SOS急救机制与红线拦截系统确保用户安全第一；女性专属生理期联动功能提供更细腻的健康关怀。 - -6.2 未来扩展规划（6-12个月） - -1. 白噪音伴随：在首页计时器中融入基于主题的白噪音（如挪威森林主题播放微弱的篝火声），深夜抚慰饥饿感。 - -2. 手账集市生态：允许创作者上传新的错位填色图标、打卡印章样式和和纸胶带素材，构建UGC内容生态。 - -3. AI - 伴随周报：根据一周的打卡、情绪与SOS中止记录，每周日生成一封"手写信格式"的健康回顾总结。 - -4. 社交打卡圈子：建立轻量级的打卡社群，用户可分享自己的断食心得与手账页面。 - -5. 智能食谱推荐：基于用户的断食计划和营养需求，提供个性化的食谱推荐。 +*比起变瘦，我们更在乎您的健康。* 🌸 \ No newline at end of file -- Gitee