# 纤刻 — AI 驱动的智能饮食与运动管理助手
> 记录今天,刻下改变。
---
## 一、产品概述
纤刻(Qianke)是一款基于微信小程序平台的 AI 智能健康管理工具,面向关注体重管理、饮食质量和代谢安全的用户群体。产品深度集成人工智能能力,提供从食物识别、营养规划到运动记录的全链路闭环体验,让用户在微信生态内即可完成科学、个性化的健康管理。
### 核心定位
- **不只是热量计算器**:纤刻在传统热量追踪基础上,引入代谢安全监控(Energy Availability)、饮食结构分析、AI 自适应目标调整等进阶能力,帮助用户在安全范围内达成健康目标。
- **AI 原生体验**:从拍照识别食物、对话式运动记录,到基于 14 天行为数据的动态目标生成,AI 贯穿产品的每一个核心环节。
- **科学安全优先**:内置激进策略风险检测、健康状况守卫、体重漂移校验等多层安全机制,确保用户不会因追求速度而损害健康。
---
## 二、目标用户
- 希望管理体重(减脂 / 维持 / 增重)的微信用户
- 关注饮食营养质量、希望了解每日膳食结构的人群
- 有慢性病管理需求(高血压、二型糖尿病、慢性肾病等)需要谨慎控制饮食的用户
- 偏好在微信生态内完成健康管理、不想额外安装独立 App 的用户
---
## 三、核心功能
### 3.1 智能仪表盘(Dashboard)
仪表盘是用户的「今日中心」,一屏呈现完整的当日健康状态:
| 模块 | 说明 |
|------|------|
| 热量英雄卡 | 显示剩余可摄入热量,动态渐变色彩随摄入比例变化(绿色 → 黄色 → 红色),圆环进度指示器 |
| 三大宏量营养素卡片 | 蛋白质 / 碳水 / 脂肪各自的进度条、摄入量、目标值、最低摄入线和颜色引导 |
| 代谢安全卡 | 实时计算 Energy Availability(可用能量 / 去脂体重),三级安全状态(安全 / 注意 / 危险) |
| 四餐记录 | 早 / 午 / 晚 / 加餐四个餐次,展开查看每条食物记录,支持编辑和删除 |
| 饮食结构分析 | 汇总当日所有食物标签,显示警告标签(高糖、高钠等)和正面标签(高纤维、抗炎等) |
| 运动卡 | 展示当日运动记录,支持增删改 |
| 体重卡 | 显示当日体重及与上次的变化量 |
下拉刷新可同步微信运动步数并刷新 AI 日标。
### 3.2 AI 拍照识别(AI Camera)
两种模式,覆盖食物和配料表两大场景:
**食物识别模式**
- 拍照或从相册选择食物图片
- AI 返回:食物名称、每 100g 营养素(热量 / 蛋白质 / 碳水 / 脂肪)、建议份量、置信度、推荐文案
- 丰富的标签体系:微量营养素亮点(microHighlights)、功能效果(f
# 纤刻 — 项目技术实现文档
---
## 一、技术栈与基础设施
### 1.1 整体架构
纤刻采用微信小程序 + 微信云开发(CloudBase)的全 Serverless 架构,前端与后端均运行在微信生态内,无需独立服务器。
| 层级 | 技术选型 |
|------|---------|
| 前端框架 | 微信小程序原生(WXML + WXSS + JavaScript) |
| 后端运行时 | 微信云函数(Node.js,各函数独立 `package.json`) |
| 数据库 | 微信云数据库(NoSQL,文档型) |
| 文件存储 | 微信云存储(`cloud://` 协议) |
| AI 服务 | 阿里云百炼(DashScope)— 文本生成 + 多模态视觉 |
| 语音识别 | 阿里云 DashScope ASR(WebSocket 流式转写) |
| 运动数据 | 微信运动(WeRun)API |
### 1.2 云开发环境
- 环境 ID:`cloud1-d3ggq2x4738cdb09a`(硬编码于 `miniprogram/app.js` 的 `globalData.env`)
- 云函数内统一使用 `cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })` 自动对齐调用方环境
- 小程序 AppID:`wx789b1123ed674776`(`project.config.json`)
### 1.3 文件结构概览
```
Qianke/
├── miniprogram/ # 前端小程序
│ ├── app.js / app.json / app.wxss # 全局入口与配置
│ ├── pages/ # 13 个页面(四文件约定)
│ ├── components/ # 4 个自定义组件
│ ├── custom-tab-bar/ # 自定义 TabBar
│ ├── services/ # 12 个服务模块
│ ├── utils/ # 13 个工具模块
│ ├── data/ # 种子数据、法律文本
│ └── images/ # 图标资源
├── cloudfunctions/ # 8 个云函数
│ ├── aiCamera/ # AI 拍照识别
│ ├── aiC