feat: 添加交互式 BMI/TDEE 热量计算器

This commit is contained in:
2026-10-08 00:22:43 +00:00
parent 9a34817b3f
commit 0ef74ab351
+259
View File
@@ -0,0 +1,259 @@
# -*- coding: utf-8 -*-
"""BMI 分类与每日热量需求(BMR / TDEE)交互式计算器
用法
----
1) 交互式(推荐,一路回车即可使用默认值):
python tdee_calculator.py
2) 命令行一次性给出参数:
python tdee_calculator.py --sex female --age 30 --height 163 --weight 50 --steps 10000 --goal maintain
算法
----
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
3. TDEE(每日总消耗)= BMR * PAL
4. 目标摄入:维持 = TDEE;增重 = TDEE + 300~500;
减重 = TDEE * 0.825,且不低于 BMR 与安全下限(男 1500 / 女 1200 kcal)
说明:本工具仅作健康科普参考,不构成医疗建议。
"""
from __future__ import annotations
import argparse
import sys
SAFE_FLOOR = {"male": 1500, "female": 1200} # 减重安全下限 kcal/天
# --------------------------------------------------------------------------
# 输入部分
# --------------------------------------------------------------------------
def parse_args(argv=None):
parser = argparse.ArgumentParser(
description="BMI / BMR / TDEE 计算器(不给参数则进入交互式输入)"
)
parser.add_argument("--sex", choices=["male", "female"], help="性别:male / female")
parser.add_argument("--age", type=float, help="年龄(岁)")
parser.add_argument("--height", type=float, help="身高(cm)")
parser.add_argument("--weight", type=float, help="体重(kg)")
parser.add_argument("--steps", type=float, help="每日步数")
parser.add_argument(
"--goal",
choices=["maintain", "gain", "cut"],
default=None,
help="目标:maintain 维持 / gain 增重 / cut 减重",
)
return parser.parse_args(argv)
def prompt_value(label, unit, cast, default=None, lo=None, hi=None):
"""反复询问直到拿到合法数值;直接回车则用默认值。"""
while True:
tip = f"(回车默认 {default:g}{unit})" if default is not None else ""
raw = input(f"{label}({unit}){tip}:").strip()
if raw == "" and default is not None:
return cast(default)
try:
value = cast(raw)
except ValueError:
print(" × 请输入数字,例如 163 或 51.5")
continue
if (lo is not None and value < lo) or (hi is not None and value > hi):
print(f" × 数值需在 {lo:g} ~ {hi:g} 之间")
continue
return value
def prompt_sex(default="female"):
while True:
tip = "女" if default == "female" else "男"
raw = input(f"性别(男/女,回车默认{tip}):").strip().lower()
if raw == "":
return default
if raw in ("男", "m", "male", "1"):
return "male"
if raw in ("女", "f", "female", "0", "2"):
return "female"
print(" × 请输入 男 或 女")
def prompt_goal(default="maintain"):
mapping = {"1": "maintain", "2": "gain", "3": "cut"}
while True:
print("目标:1) 维持体重 2) 增重 3) 减重")
raw = input("请选择(回车默认 1):").strip()
if raw == "":
return default
if raw in mapping:
return mapping[raw]
print(" × 请输入 1 / 2 / 3")
def collect_interactive(vals):
"""交互式收集输入,上一轮的值作为默认值。"""
vals["sex"] = prompt_sex(vals.get("sex") or "female")
vals["age"] = prompt_value("年龄", "岁", float, vals.get("age") or 30, 6, 120)
vals["height"] = prompt_value("身高", "cm", float, vals.get("height") or 165, 100, 220)
vals["weight"] = prompt_value("体重", "kg", float, vals.get("weight") or 55, 20, 200)
vals["steps"] = prompt_value(
"每日步数", "步", float,
vals.get("steps") if vals.get("steps") is not None else 10000, 0, 60000,
)
vals["goal"] = prompt_goal(vals.get("goal") or "maintain")
return vals
# --------------------------------------------------------------------------
# 计算部分
# --------------------------------------------------------------------------
def bmi_of(weight_kg, height_cm):
h = height_cm / 100.0
return weight_kg / (h * h)
def bmi_class(bmi, age):
if age < 18:
return "未成年人(成人阈值不适用,请用年龄别 BMI 百分位判定)"
if bmi < 18.5:
return "偏瘦"
if bmi < 24:
return "正常"
if bmi < 28:
return "超重"
return "肥胖"
def bmr_mifflin(weight_kg, height_cm, age, sex):
base = 10 * weight_kg + 6.25 * height_cm - 5 * age
return base + (5 if sex == "male" else -161)
def bmr_schofield(weight_kg, age, sex):
if sex == "male":
return 17.7 * weight_kg + 657 if age < 18 else 15.3 * weight_kg + 679
return 13.4 * weight_kg + 692 if age < 18 else 14.7 * weight_kg + 496
def pal_from_steps(steps):
"""连续式 PAL。"""
return max(1.2, min(1.95, 1.2 + steps / 1000.0 * 0.04))
def pal_bucket(steps):
"""分档式 PAL 区间,用作上下限估计。"""
if steps < 5000:
return 1.15, 1.25
if steps < 7500:
return 1.30, 1.45
if steps < 10000:
return 1.45, 1.55
if steps < 12500:
return 1.50, 1.60
return 1.60, 1.80
def target_intake(tdee, bmr, goal, sex):
"""返回 (下限, 上限, 目标说明)。"""
if goal == "maintain":
return tdee, tdee, "维持体重"
if goal == "gain":
return tdee + 300, tdee + 500, "健康增重(每日 +300~500 kcal)"
val = max(tdee * 0.825, bmr, SAFE_FLOOR[sex])
return val, val, "减重(约 -17.5%,不低于 BMR 与安全下限)"
# --------------------------------------------------------------------------
# 输出部分
# --------------------------------------------------------------------------
def report(sex, age, height, weight, steps, goal):
sex_cn = "男" if sex == "male" else "女"
bmi = bmi_of(weight, height)
mifflin = bmr_mifflin(weight, height, age, sex)
schofield = bmr_schofield(weight, age, sex)
bmr = (mifflin + schofield) / 2
pal = pal_from_steps(steps)
pal_lo, pal_hi = pal_bucket(steps)
tdee = bmr * pal
t_lo, t_hi, goal_desc = target_intake(tdee, bmr, goal, sex)
h = height / 100.0
w20, w21 = 20 * h * h, 21 * h * h
print()
print("=" * 58)
print(f"个人信息:{sex_cn},{age:.0f} 岁,{height:.0f} cm,{weight:.1f} kg,每天 {steps:.0f} 步")
print(f"BMI:{bmi:.1f} → {bmi_class(bmi, age)}")
print("-" * 58)
print(f"基础代谢 BMR:{bmr:.0f} kcal/天"
f"(Mifflin {mifflin:.0f} · Schofield {schofield:.0f},两者取平均)")
print(f"活动系数 PAL:{pal:.2f}(按步数分档约 {pal_lo:.2f} ~ {pal_hi:.2f})")
print(f"每日总消耗 TDEE:{tdee:.0f} kcal/天"
f"(合理区间约 {bmr * pal_lo:.0f} ~ {bmr * pal_hi:.0f})")
print("-" * 58)
print(f"目标:{goal_desc}")
if abs(t_hi - t_lo) < 1:
print(f"建议每日摄入:{t_lo:.0f} kcal/天")
else:
print(f"建议每日摄入:{t_lo:.0f} ~ {t_hi:.0f} kcal/天")
if goal == "cut":
print("(若已触及 BMR 或安全下限,说明热量已压到最低,请勿再减)")
prot_lo, prot_hi = (1.5 * weight, 1.8 * weight) if age < 20 else (1.2 * weight, 1.6 * weight)
print(f"蛋白质建议:{prot_lo:.0f} ~ {prot_hi:.0f} g/天;"
f"脂肪约 {weight * 0.8:.0f} g/天以上;其余热量由主食与果蔬补足。")
if age < 18:
print("⚠ 未满 18 岁:成人 BMI 阈值不适用,请用年龄别 BMI 百分位(WS/T 586-2018)判定,"
"并请医生用 EER 青少年公式复核热量。")
if bmi < 20:
need_lo, need_hi = max(0.0, w20 - weight), max(0.0, w21 - weight)
tip = (f"还需增重 {need_lo:.1f} ~ {need_hi:.1f} kg"
if need_hi > 0.05 else "体重已在目标区间内")
print(f"⚠ 你的 BMI 贴近偏瘦边缘:目标可设在 BMI 20~21,即体重 "
f"{w20:.1f} ~ {w21:.1f} kg({tip})。建议按 TDEE +300~500 kcal 吃,不要减重。")
print("-" * 58)
print("提示:步数只能粗略估计活动量(快走/慢走可差 ±15%),此为本阶段的起始值;")
print(" 执行 2~3 周后看体重趋势再微调 ±100~200 kcal。本工具不构成医疗建议。")
print("=" * 58)
# --------------------------------------------------------------------------
# 入口
# --------------------------------------------------------------------------
def main(argv=None):
args = parse_args(argv)
given = {
"sex": args.sex,
"age": args.age,
"height": args.height,
"weight": args.weight,
"steps": args.steps,
"goal": args.goal,
}
interactive = any(given[k] is None for k in ("sex", "age", "height", "weight", "steps"))
vals = dict(given)
while True:
if interactive:
vals = collect_interactive(vals)
report(vals["sex"], vals["age"], vals["height"],
vals["weight"], vals["steps"], vals["goal"] or "maintain")
if not interactive:
break
if input("\n再算一次?(y/N):").strip().lower() not in ("y", "yes", "是"):
print("再见!")
break
return 0
if __name__ == "__main__":
sys.exit(main())