微信原生AI应用热量管理工具小程序-纤刻

# 纤刻 — 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