Files
bmi-tdee-calculator/README.md
T

79 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# bmi-tdee-calculator
BMI 分类与每日热量需求(BMR / TDEE)计算器。**两种用法都是交互式输入**,任选其一:
| 文件 | 说明 |
| --- | --- |
| `index.html` | 网页版,双击用浏览器打开即可;输入即出结果,无需安装任何环境 |
| `tdee_calculator.py` | 命令行版,纯标准库、零依赖,适合脚本调用与批处理 |
## 用法一:网页版
```bash
# 直接双击 index.html,或本地起个服务:
python -m http.server 8000
# 然后浏览器打开 http://localhost:8000/index.html
```
填写/拖动 性别、年龄、身高、体重、每日步数、目标,结果实时刷新。
## 用法二:命令行版
```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)
两个版本的公式与阈值完全一致(`index.html` 与 `tdee_calculator.py` 同源),换着用结果相同。
## 已知限制
- 步数只能粗略估计活动量,快走与慢走差别可达 ±15%,结果应视为**起始值**,执行 2~3 周后按体重趋势微调 ±100~200 kcal。
- 未满 18 岁的 BMI 判定须用年龄别百分位(WS/T 586-2018),不能套用成人 18.5 / 24 / 28 阈值。
- 本工具仅作健康科普参考,不构成医疗建议。