Files
class03m09 d48edbb9e0 更新 README 文件清单与用法
- 补充「青少年 BMI 界值」输入项,写明未满 18 岁按填入界值分级
- 列出 calorie_cli.py、meal-plan.md、teen-bmi-thresholds.md 三个文件的说明
- 增加网页版与命令行版的使用示例
2026-09-24 02:43:33 +00:00

53 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# nutrition-calculator
每日热量与营养素需求计算器。提供网页版(单文件,双击即可用)与 Python 命令行版。
## 文件
| 文件 | 说明 |
| --- | --- |
| `index.html` | 网页版计算器(HTML + CSS + 原生 JavaScript,无外部依赖) |
| `calorie_cli.py` | 命令行版,与网页版同一套算法 |
| `meal-plan.md` | 一日食谱(约 3000 kcal / 蛋白质约 140 g) |
| `teen-bmi-thresholds.md` | 青少年 BMI 界值使用说明 |
## 输入
- 身高(cm)、体重(斤 / 公斤)
- 年龄、性别
- 活动水平 PAL:1.4 久坐 / 1.6 轻度 / 1.8 中度 / 2.0 高强度
- 目标:减脂 / 维持体重 / 增肌
- 青少年 BMI 界值(未满 18 岁适用,可自行修改)
默认输入为身高 178cm、体重 177 斤(88.5kg)、15 岁、男性、轻度活动、减脂。
## 输出
| 项目 | 说明 |
| --- | --- |
| BMI | 成人按 18.5 / 24 / 28 分级;未满 18 岁按填入的界值分级 |
| BMR | 18 岁以下用 Schofield 青少年公式;18 岁及以上用 Mifflin-St Jeor 公式 |
| TDEE | BMR × PAL |
| 建议摄入 | 减脂 = TDEE − 450 kcal(不低于 2000 kcal);维持 = TDEE;增肌 = TDEE + 300 kcal |
| 三大营养素 | 蛋白质 1.4–1.6 g/kg、脂肪约占总热量 27%、碳水补足余量,附克数与占比 |
| 七大营养素 | 膳食纤维、饮水,以及钙、铁、锌、碘、维生素 A/D/E/B 族/C、镁、钾、钠的每日需要量 |
| 三餐分配 | 早餐 25% / 午餐 35% / 加餐 10% / 晚餐 30% |
## 用法
网页版:直接用浏览器打开 `index.html`。
命令行版:
```bash
python calorie_cli.py
python calorie_cli.py --height 178 --weight 177 --unit jin --age 15 --sex male --pal 1.6 --goal cut
python calorie_cli.py --age 14 --sex female --weight 55 --unit kg --pal 1.4 --teen-over 23.0 --teen-obese 25.5
```
## 说明
- 所有数值均为估算参考,公式误差约 ±10%,实际应以 2–3 周体重趋势回调。
- 青少年 BMI 判定以《WS/T 586-2018 学龄儿童青少年超重与肥胖筛查》原表为准,详见 `teen-bmi-thresholds.md`。
- 未成年人减重请先咨询医生或营养师,不要使用极端节食、代餐或减肥药。