更新 README 文件清单与用法

- 补充「青少年 BMI 界值」输入项,写明未满 18 岁按填入界值分级
- 列出 calorie_cli.py、meal-plan.md、teen-bmi-thresholds.md 三个文件的说明
- 增加网页版与命令行版的使用示例
This commit is contained in:
2026-09-24 02:43:33 +00:00
parent 03bf998138
commit d48edbb9e0
+25 -7
View File
@@ -1,6 +1,15 @@
# nutrition-calculator
每日热量与营养素需求计算器(单文件网页,双击 `index.html` 即可使用)。
每日热量与营养素需求计算器。提供网页版(单文件,双击即可用)与 Python 命令行版。
## 文件
| 文件 | 说明 |
| --- | --- |
| `index.html` | 网页版计算器(HTML + CSS + 原生 JavaScript,无外部依赖) |
| `calorie_cli.py` | 命令行版,与网页版同一套算法 |
| `meal-plan.md` | 一日食谱(约 3000 kcal / 蛋白质约 140 g) |
| `teen-bmi-thresholds.md` | 青少年 BMI 界值使用说明 |
## 输入
@@ -8,6 +17,7 @@
- 年龄、性别
- 活动水平 PAL:1.4 久坐 / 1.6 轻度 / 1.8 中度 / 2.0 高强度
- 目标:减脂 / 维持体重 / 增肌
- 青少年 BMI 界值(未满 18 岁适用,可自行修改)
默认输入为身高 178cm、体重 177 斤(88.5kg)、15 岁、男性、轻度活动、减脂。
@@ -15,7 +25,7 @@
| 项目 | 说明 |
| --- | --- |
| BMI | 成人按 18.5 / 24 / 28 分级;青少年按 WS/T 586-2018 界值(15 岁男:超重 24.6、肥胖 26.4) |
| 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 |
@@ -23,12 +33,20 @@
| 七大营养素 | 膳食纤维、饮水,以及钙、铁、锌、碘、维生素 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 学龄儿童青少年超重与肥胖筛查》原表为准。
- 青少年 BMI 判定以《WS/T 586-2018 学龄儿童青少年超重与肥胖筛查》原表为准,详见 `teen-bmi-thresholds.md`。
- 未成年人减重请先咨询医生或营养师,不要使用极端节食、代餐或减肥药。
## 文件
- `index.html` —— 计算器页面(HTML + CSS + 原生 JavaScript,无外部依赖)