From 31bb4b678ef2090c30f8d93f4d2b1ac1e7bf18a5 Mon Sep 17 00:00:00 2001 From: class07f23 Date: Thu, 8 Oct 2026 00:22:49 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=A8=20README=EF=BC=88?= =?UTF-8?q?=E4=BD=BF=E7=94=A8=E6=96=B9=E6=B3=95=E3=80=81=E5=8F=82=E6=95=B0?= =?UTF-8?q?=E3=80=81=E7=A4=BA=E4=BE=8B=E8=BE=93=E5=87=BA=E4=B8=8E=E7=AE=97?= =?UTF-8?q?=E6=B3=95=E8=AF=B4=E6=98=8E=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 61 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ed111ce..18ed262 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,63 @@ # bmi-tdee-calculator -BMI 分类与每日热量需求(BMR/TDEE)交互式计算器:输入身高、体重、年龄、每日步数,输出 TDEE 与建议摄入热量 \ No newline at end of file +BMI 分类与每日热量需求(BMR / TDEE)计算器。**交互式输入**,纯标准库、无需安装任何依赖。 + +## 运行 + +```bash +python tdee_calculator.py +``` + +运行后依次输入性别、年龄、身高、体重、每日步数、目标即可;每一步**直接回车**就使用默认值。 + +也可以带参数一次算完(适合脚本调用): + +```bash +python tdee_calculator.py --sex female --age 30 --height 163 --weight 50 --steps 10000 --goal gain +``` + +| 参数 | 说明 | +| --- | --- | +| `--sex` | `male` / `female` | +| `--age` | 年龄(岁) | +| `--height` | 身高(cm) | +| `--weight` | 体重(kg) | +| `--steps` | 每日步数 | +| `--goal` | `maintain` 维持(默认)/ `gain` 增重 / `cut` 减重 | + +## 示例输出 + +每天走 1 万步、BMI 贴近偏瘦边缘的成年人: + +``` +个人信息:女,30 岁,163 cm,50.0 kg,每天 10000 步 +BMI:18.8 → 正常 +---------------------------------------------------------- +基础代谢 BMR:1204 kcal/天(Mifflin 1194 · Schofield 1214,两者取平均) +活动系数 PAL:1.60(按步数分档约 1.50 ~ 1.60) +每日总消耗 TDEE:1926 kcal/天(合理区间约 1806 ~ 1926) +---------------------------------------------------------- +目标:健康增重(每日 +300~500 kcal) +建议每日摄入:2226 ~ 2426 kcal/天 +蛋白质建议:60 ~ 80 g/天;脂肪约 40 g/天以上;其余热量由主食与果蔬补足。 +⚠ 你的 BMI 贴近偏瘦边缘:目标可设在 BMI 20~21,即体重 53.1 ~ 55.8 kg + (还需增重 3.1 ~ 5.8 kg)。建议按 TDEE +300~500 kcal 吃,不要减重。 +``` + +## 算法 + +1. **BMR(基础代谢率)**:Mifflin-St Jeor 与 Schofield 两式取平均 + - Mifflin:`10×体重kg + 6.25×身高cm − 5×年龄 + (男 +5 / 女 −161)` + - Schofield:男 `<18 岁 17.7×W+657` | 成年 `15.3×W+679`;女 `<18 岁 13.4×W+692` | 成年 `14.7×W+496` +2. **PAL(活动系数)**:由每天步数换算 + - 连续式:`PAL = 1.2 + 步数/1000 × 0.04`,钳制在 `1.2 ~ 1.95` + - 分档式:`<5000 →1.15~1.25`|`5000~ →1.30~1.45`|`7500~ →1.45~1.55`|`10000~ →1.50~1.60`|`≥12500 →1.60~1.80` + - 每天 1 万步 → `PAL ≈ 1.60` +3. **TDEE**:`TDEE = BMR × PAL` +4. **目标摄入**:维持 = TDEE;增重 = TDEE + 300~500;减重 = TDEE × 0.825,且不低于 BMR 与安全下限(男 1500 / 女 1200 kcal) + +## 已知限制 + +- 步数只能粗略估计活动量,快走与慢走差别可达 ±15%,结果应视为**起始值**,执行 2~3 周后按体重趋势微调 ±100~200 kcal。 +- 未满 18 岁的 BMI 判定须用年龄别百分位(WS/T 586-2018),不能套用成人 18.5 / 24 / 28 阈值。 +- 本工具仅作健康科普参考,不构成医疗建议。