docs: 补全 README(使用方法、参数、示例输出与算法说明)
This commit is contained in:
@@ -1,3 +1,63 @@
|
||||
# bmi-tdee-calculator
|
||||
|
||||
BMI 分类与每日热量需求(BMR/TDEE)交互式计算器:输入身高、体重、年龄、每日步数,输出 TDEE 与建议摄入热量
|
||||
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 阈值。
|
||||
- 本工具仅作健康科普参考,不构成医疗建议。
|
||||
|
||||
Reference in New Issue
Block a user