From dbcab5d695cc4d233023971e2d8ccbc50db2052f Mon Sep 17 00:00:00 2001 From: class04f21 Date: Thu, 24 Sep 2026 04:02:36 +0000 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=AF=B4=E6=98=8E=E6=96=87?= =?UTF-8?q?=E6=A1=A3=EF=BC=9A=E5=86=99=E6=98=8E=E6=96=87=E4=BB=B6=E6=9E=84?= =?UTF-8?q?=E6=88=90=E3=80=81=E7=94=A8=E6=B3=95=E3=80=81=E7=AE=97=E6=B3=95?= =?UTF-8?q?=E9=93=BE=E8=B7=AF=E3=80=81=E8=AE=BE=E8=AE=A1=E5=8F=96=E8=88=8D?= =?UTF-8?q?=E4=B8=8E=E5=85=8D=E8=B4=A3=E8=8C=83=E5=9B=B4=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 43 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 42 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d3a9500..bace13b 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,44 @@ # bmi-health-calculator -BMI 与每日热量计算工具:输入性别/年龄/身高/体重/步数,输出 BMI、参考标准判定、热量目标与饮食建议,并附算法说明。 \ No newline at end of file +BMI 与每日热量计算工具:输入性别 / 年龄 / 身高 / 体重 / 步数,输出 BMI、参考标准判定、BMR、TDEE、目标热量与营养素建议。 + +## 文件 + +| 文件 | 说明 | +|---|---| +| `calculator.py` | 计算脚本(含输入校验与命令行接口) | +| `ALGORITHM.md` | 算法说明与决策记录 | + +## 使用 + +```bash +python calculator.py --sex female --age 15 --height 155 --weight 41.6 --steps 3000 +python calculator.py --sex female --age 25 --height 180 --weight 50 --steps 8000 +``` + +可选参数 `--pal` 手动指定活动系数,覆盖按步数的估算。 + +## 算法链路 + +``` +1. 数据校验(单位 / 生理上界 / 模型适用范围) +2. BMI = 体重(kg) / [身高(m)]^2 +3. 参考标准判定:>=20 岁 WHO 成人分类;5-19 岁 WHO 2007 BMI-for-age(Z 分数);0-5 岁只给 BMI 并提示改用身长/体重曲线 +4. BMR:<18 岁 Schofield(FAO/WHO);>=18 岁 Mifflin-St Jeor +5. TDEE = BMR x PAL(PAL 按步数分档,并设物理上界) +6. 目标热量 = TDEE +/- 250~350 kcal +7. 营养素反推:蛋白 g/kg、脂肪 25-30%、碳水为余量 +8. 每 2-4 周按体重趋势校准 +``` + +## 设计取舍 + +- 超出适用范围的输入(如年龄 700000、步数无穷大)一律报错,不做外推。 +- 未成年人只给维持或温和增重,不输出减脂方案。 +- BMR 下限 400 kcal/天,TDEE 上限 12000 kcal/天,超出时封顶并提示。 + +## 免责说明 + +- 公式为人群平均估计值,个体差异可达 +/-10-15%。 +- 内置参考曲线为公开资料近似值,正式临床使用请替换为 WHO 官方 LMS 表。 +- 婴幼儿、未成年人,或 BMI 超出 +/-3SD、伴随月经停闭/掉发/乏力/怕冷等症状者,请以医生或注册营养师意见为准,本工具不能替代诊断。