diff --git a/README.md b/README.md index 18ed262..8e6c56d 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,23 @@ # 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 python tdee_calculator.py @@ -25,9 +40,7 @@ python tdee_calculator.py --sex female --age 30 --height 163 --weight 50 --steps | `--steps` | 每日步数 | | `--goal` | `maintain` 维持(默认)/ `gain` 增重 / `cut` 减重 | -## 示例输出 - -每天走 1 万步、BMI 贴近偏瘦边缘的成年人: +## 示例输出(每天 1 万步、BMI 贴近偏瘦边缘的成年人) ``` 个人信息:女,30 岁,163 cm,50.0 kg,每天 10000 步 @@ -56,6 +69,8 @@ BMI:18.8 → 正常 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。