docs: README 增加一周增重食谱说明与文件索引

This commit is contained in:
2026-09-24 03:41:35 +00:00
parent 3327939673
commit d64a1c9843
+39 -5
View File
@@ -1,7 +1,7 @@
# daily-calorie-calculator # daily-calorie-calculator
每日热量需求计算器:根据**性别 / 年龄 / 身高 / 体重 / 日常活动量**估算 BMI、BMR,并计算每日所需热量, 每日热量需求计算器:根据**性别 / 年龄 / 身高 / 体重 / 日常活动量**估算 BMI、BMR,并计算每日所需热量,
给出「维持 / 减脂 / 增重」三种目标的每日建议摄入量。 给出「维持 / 减脂 / 增重」三种目标的每日建议摄入量,并附一份**一周增重食谱 + 三大营养素拆分**。
**按年龄自动切换算法**:成人(≥18 岁)用 Mifflin-St Jeor + PAL;青少年(9–18 岁)用 IOM EER 公式(含生长所需)。 **按年龄自动切换算法**:成人(≥18 岁)用 Mifflin-St Jeor + PAL;青少年(9–18 岁)用 IOM EER 公式(含生长所需)。
@@ -10,6 +10,7 @@
| 文件 | 说明 | | 文件 | 说明 |
| --- | --- | | --- | --- |
| `index.html` | 网页版计算器(纯 HTML + CSS + 原生 JS,单文件,双击即可使用,无需联网或安装依赖) | | `index.html` | 网页版计算器(纯 HTML + CSS + 原生 JS,单文件,双击即可使用,无需联网或安装依赖) |
| `meal-plan.html` | 一周增重食谱 + 三大营养素拆分(7 天 × 6 餐,热量与营养素自动核算) |
| `calorie_calculator.py` | 命令行版计算器(Python 3,无第三方依赖) | | `calorie_calculator.py` | 命令行版计算器(Python 3,无第三方依赖) |
## 算法 ## 算法
@@ -86,14 +87,34 @@ PA(身体活动等级)系数:
### 其他参考值 ### 其他参考值
- 蛋白质:约 1.2 g/kg 体重/天 - 蛋白质:约 1.2 g/kg 体重/天(增重期建议 1.5–2.0 g/kg)
- 饮水:约 30 ml/kg 体重/天 - 饮水:约 30 ml/kg 体重/天
## 一周增重食谱(`meal-plan.html`)
以「16 岁女生、162 cm、45.5 kg、几乎没有活动」为例,按 EER + 300 kcal 设计:
| 指标 | 每日目标 |
| --- | --- |
| 热量 | ≈ 1,900 kcal |
| 蛋白质 | ≈ 90 g(约 2.0 g/kg,15–20% 能量) |
| 脂肪 | ≈ 60 g(25–30% 能量) |
| 碳水 | ≈ 240 g(50–60% 能量) |
设计逻辑:
1. **热量按 4/9/4 反算**:90×4 + 60×9 + 240×4 = 1,860 ≈ 1,900 kcal。
2. **一天 6 餐**:早餐 / 上午加餐 / 午餐 / 下午加餐 / 晚餐 / 睡前,因为胃口小的人三顿饭装不下 1,900 kcal。
3. **加餐是主力**:每次 150–250 kcal,一天两次即多出约 400 kcal(香蕉+坚果、酸奶+红薯、牛奶+燕麦)。
4. **蛋白质守住 1.5–2.0 g/kg**,多余热量主要靠**碳水**补,脂肪不低于总热量 25%。
5. 7 天互为同类替换(鸡胸 ↔ 牛肉 ↔ 鱼虾 ↔ 鸡蛋;米饭 ↔ 面条 ↔ 馒头 ↔ 红薯),吃不腻。
6. 页面内的热量与三大营养素**由代码自动求和**,并可 Ctrl/Cmd + P 打印成 PDF。
## 使用方式 ## 使用方式
### 网页版 ### 网页版
直接用浏览器打开 `index.html`,填写性别、年龄、身高、体重,选择活动量,点击「计算」。 直接用浏览器打开 `index.html`(热量计算器)与 `meal-plan.html`(一周食谱)。
### 命令行版 ### 命令行版
@@ -101,6 +122,19 @@ PA(身体活动等级)系数:
python3 calorie_calculator.py python3 calorie_calculator.py
``` ```
按提示输入即可,例如:
```
性别(男/女,默认女):女
年龄(岁):16
身高(cm):162
体重(kg):45.5
日常活动量:
1. 几乎没有 / 久坐(基本不运动,以坐为主)
...
请选择活动量编号(默认 1:几乎没有):1
```
## 计算示例 ## 计算示例
### 示例 1:16 岁女生,162 cm,45.5 kg,几乎没有活动(青少年公式) ### 示例 1:16 岁女生,162 cm,45.5 kg,几乎没有活动(青少年公式)
@@ -110,7 +144,7 @@ python3 calorie_calculator.py
3. 青少年 EER(女,久坐 PA = 1.00) 3. 青少年 EER(女,久坐 PA = 1.00)
= 135.3 − 30.8×16 + 1.00×(10.0×45.5 + 934×1.62) + 25 = 135.3 − 30.8×16 + 1.00×(10.0×45.5 + 934×1.62) + 25
= 135.3 − 492.8 + 1,968.1 + 25 = **1,636 kcal** = 135.3 − 492.8 + 1,968.1 + 25 = **1,636 kcal**
4. 建议:**维持约 1,640 kcal/天**;因贴近偏瘦,建议按 **1,640 ~ 1,940 kcal/天** 摄入 4. 建议:**维持约 1,640 kcal/天**;因贴近偏瘦,建议按 **1,640 ~ 1,940 kcal/天** 摄入(食谱即按 1,900 设计)
> 若错误地套用成人公式:BMR 1,227 × 1.2 = 1,472 kcal/天,会低估约 160 kcal。 > 若错误地套用成人公式:BMR 1,227 × 1.2 = 1,472 kcal/天,会低估约 160 kcal。
@@ -120,4 +154,4 @@ python3 calorie_calculator.py
2. BMR = 10×48 + 6.25×160 − 5×25 − 161 = **1,194 kcal** 2. BMR = 10×48 + 6.25×160 − 5×25 − 161 = **1,194 kcal**
3. TDEE = 1,194 × 1.2 = **1,433 kcal/天** 3. TDEE = 1,194 × 1.2 = **1,433 kcal/天**
> 以上均为估算值,个体误差约 ±10%。若患有疾病或处于特殊生理阶段,请咨询医生或注册营养师。 > 以上均为估算值,个体误差约 ±10%(食谱另受烹饪用油影响)。若患有疾病或处于特殊生理阶段,请咨询医生或注册营养师。