docs: README 增加网页版说明与文件清单
This commit is contained in:
@@ -1,8 +1,23 @@
|
|||||||
# bmi-tdee-calculator
|
# bmi-tdee-calculator
|
||||||
|
|
||||||
BMI 分类与每日热量需求(BMR / TDEE)计算器。**交互式输入**,纯标准库、无需安装任何依赖。
|
BMI 分类与每日热量需求(BMR / TDEE)计算器。**两种用法都是交互式输入**,任选其一:
|
||||||
|
|
||||||
## 运行
|
| 文件 | 说明 |
|
||||||
|
| --- | --- |
|
||||||
|
| `index.html` | 网页版,双击用浏览器打开即可;输入即出结果,无需安装任何环境 |
|
||||||
|
| `tdee_calculator.py` | 命令行版,纯标准库、零依赖,适合脚本调用与批处理 |
|
||||||
|
|
||||||
|
## 用法一:网页版
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 直接双击 index.html,或本地起个服务:
|
||||||
|
python -m http.server 8000
|
||||||
|
# 然后浏览器打开 http://localhost:8000/index.html
|
||||||
|
```
|
||||||
|
|
||||||
|
填写/拖动 性别、年龄、身高、体重、每日步数、目标,结果实时刷新。
|
||||||
|
|
||||||
|
## 用法二:命令行版
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python tdee_calculator.py
|
python tdee_calculator.py
|
||||||
@@ -25,9 +40,7 @@ python tdee_calculator.py --sex female --age 30 --height 163 --weight 50 --steps
|
|||||||
| `--steps` | 每日步数 |
|
| `--steps` | 每日步数 |
|
||||||
| `--goal` | `maintain` 维持(默认)/ `gain` 增重 / `cut` 减重 |
|
| `--goal` | `maintain` 维持(默认)/ `gain` 增重 / `cut` 减重 |
|
||||||
|
|
||||||
## 示例输出
|
## 示例输出(每天 1 万步、BMI 贴近偏瘦边缘的成年人)
|
||||||
|
|
||||||
每天走 1 万步、BMI 贴近偏瘦边缘的成年人:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
个人信息:女,30 岁,163 cm,50.0 kg,每天 10000 步
|
个人信息:女,30 岁,163 cm,50.0 kg,每天 10000 步
|
||||||
@@ -56,6 +69,8 @@ BMI:18.8 → 正常
|
|||||||
3. **TDEE**:`TDEE = BMR × PAL`
|
3. **TDEE**:`TDEE = BMR × PAL`
|
||||||
4. **目标摄入**:维持 = TDEE;增重 = TDEE + 300~500;减重 = TDEE × 0.825,且不低于 BMR 与安全下限(男 1500 / 女 1200 kcal)
|
4. **目标摄入**:维持 = TDEE;增重 = TDEE + 300~500;减重 = TDEE × 0.825,且不低于 BMR 与安全下限(男 1500 / 女 1200 kcal)
|
||||||
|
|
||||||
|
两个版本的公式与阈值完全一致(`index.html` 与 `tdee_calculator.py` 同源),换着用结果相同。
|
||||||
|
|
||||||
## 已知限制
|
## 已知限制
|
||||||
|
|
||||||
- 步数只能粗略估计活动量,快走与慢走差别可达 ±15%,结果应视为**起始值**,执行 2~3 周后按体重趋势微调 ±100~200 kcal。
|
- 步数只能粗略估计活动量,快走与慢走差别可达 ±15%,结果应视为**起始值**,执行 2~3 周后按体重趋势微调 ±100~200 kcal。
|
||||||
|
|||||||
Reference in New Issue
Block a user