diff --git a/README.md b/README.md index 525cfc3..06d02a0 100644 --- a/README.md +++ b/README.md @@ -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,无外部依赖)