补充 README 项目文档:整理 BMI 与每日营养方案的设计决策与用法

- 说明 BMI 分级同时采用中国标准(WS/T 428-2013)与 WHO 标准,并按身高反推健康体重范围
- 说明体脂率未实测时按 Deurenberg 公式估算,基础代谢取 Mifflin-St Jeor 与 Katch-McArdle 两式平均
- 说明按活动系数估算 TDEE、再按减脂/维持/增肌目标调整热量,并给出三大营养素克数与每日食物建议量
- 说明网页版以 BMI 正常偏瘦、每天约 1 万步为前提,采用 MET 法步行能耗与 DRI 2023 供能比,实时重算七大营养素
- 补充命令行与网页版的使用方法
This commit is contained in:
2026-10-08 02:25:29 +00:00
parent ea8fc625e6
commit 916016ff5c
+57 -1
View File
@@ -1,3 +1,59 @@
# bmi-calculator
BMI 计算器:输入身高体重,输出 BMI 值
BMI 与每日营养方案计算工具集:输入身高、体重、年龄、性别、步数等参数,输出 BMI 值、分级,以及每日所需热量与七大营养素建议。
## 目录结构
| 文件 | 说明 |
| --- | --- |
| `bmi.py` | 命令行 BMI 计算器:输入身高、体重,输出 BMI 值与分级 |
| `nutrition_plan.py` | 命令行每日营养方案计算器:输出体脂率、BMR、TDEE、目标热量与三大营养素克数 |
| `nutrition-calculator.html` | 网页版「每日热量与七大营养素计算器」,输入参数后实时重算结果 |
## 设计决策
### BMI 计算与分级(`bmi.py`)
- 计算公式:BMI = 体重(kg) ÷ 身高(m)²
- 分级同时给出两套标准:
- 中国标准(WS/T 428-2013):< 18.5 偏瘦;18.5–23.9 正常;24.0–27.9 超重;≥ 28.0 肥胖
- WHO 国际标准:< 18.5 偏瘦;18.5–24.9 正常;25.0–29.9 超重;≥ 30.0 肥胖
- 按身高反推「正常」BMI 区间对应的健康体重范围,并提示与目标体重的差距
- 输入做范围校验(身高 50–250 cm、体重 10–500 kg),非法输入则重新询问
### 每日营养方案(`nutrition_plan.py`)
- 以体重 70 kg、身高 180 cm 为基准示例
- 体脂率:未实测时按 Deurenberg 公式估算,并据此换算去脂体重
- 基础代谢率:Mifflin-St Jeor 与 Katch-McArdle 两式取平均
- 按活动系数(久坐 / 轻度 / 中度 / 高度)估算 TDEE,再按目标(减脂 −18% / 维持 / 增肌 +8%)调整,得出目标摄入热量
- 三大产能营养素:蛋白质 2.2 g/kg 去脂体重、脂肪 1.0 g/kg 体重,剩余热量由碳水补足
- 输出三大营养素克数、能量系数与供能比,以及每日食物建议量(以 2300 kcal 为基准按目标热量等比缩放)
### 网页版计算器(`nutrition-calculator.html`)
- 以 BMI 正常但偏瘦、每天约 1 万步的活动量为前提设定默认值
- 计算方法:Mifflin-St Jeor 基础代谢 + MET 法步行能耗 + DRI 2023 供能比
- 三大产能营养素供能比:蛋白质 16.7%、脂肪 27.5%、碳水化合物 55.8%
- 步行能耗按 MET 3.5、步速 100 步/分钟估算
- 输入身高、体重、年龄、性别、步数、目标,实时重算
- 七大营养素全景:蛋白质、脂肪、碳水(产能);膳食纤维、维生素、矿物质、水(不产能)
## 使用方法
### 命令行
```bash
python bmi.py
python nutrition_plan.py --weight 70 --height 180 --bodyfat 15.5 \
--age 25 --sex male --activity light --goal maintain
```
### 网页版
用浏览器打开 `nutrition-calculator.html`,修改任一输入会立即重新计算。
## 说明
以上结果均为参考估算,不构成医疗或营养处方;公式计算存在 ±10%–15% 的个体差异,建议以 2–4 周体重变化实测校准。