docs: README 增加网页版说明与文件清单

This commit is contained in:
2026-10-08 00:24:24 +00:00
parent 31bb4b678e
commit 4da4d61a72
+20 -5
View File
@@ -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。