diff --git a/README.md b/README.md
index e249062..e6e04d4 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,120 @@
# bmi-calculator
-BMI 计算器:输入身高体重,输出 BMI 值
\ No newline at end of file
+BMI 计算器:输入身高体重,输出 BMI 值
+
+## 文件说明
+
+| 文件 | 说明 |
+|---|---|
+| `bmi.py` | 命令行版:输入身高、体重,输出 BMI 值与体重分类 |
+| `index.html` | 网页版:单文件、可离线打开,支持公制/英制切换、滑动条联动、刻度尺与体重分析 |
+| `tdee.py` | 每日热量:按身高、体重、年龄、性别与活动量估算所需热量,并给出六大营养素克数 |
+
+## 使用方法
+
+```bash
+python bmi.py # BMI 计算
+python tdee.py # 每日热量与六大营养素
+python tdee.py --sex male --age 25 --height 180 --weight 65 --steps 10000
+```
+
+网页版:用浏览器直接打开 `index.html`。
+
+## BMI 分类标准(WS/T 428-2013)
+
+| BMI 区间 | 分类 |
+|---|---|
+| < 18.5 | 偏瘦 |
+| 18.5 ~ 24 | 正常 |
+| 24 ~ 28 | 超重 |
+| ≥ 28 | 肥胖 |
+
+> WHO 国际标准的阈值为 18.5 / 25 / 30,比中国标准宽松。
+
+---
+
+## 示例:25 岁男性,180 cm / 65 kg,每天约 1 万步
+
+### 1. BMI
+
+BMI = 65 ÷ 1.80² = 65 ÷ 3.24 = **20.1** —— 正常,位于正常区间下半段(贴近偏瘦边缘)。
+
+### 2. 热量推导
+
+| 步骤 | 公式 | 计算 | 结果 |
+|---|---|---|---|
+| 基础代谢 BMR | Mifflin-St Jeor(男)`10W + 6.25H − 5A + 5` | 10×65 + 6.25×180 − 5×25 + 5 | **1,655 千卡/天** |
+| 活动系数 PAL | 每天约 1 万步 ≈ 中等活动 | 取 1.6 | — |
+| 维持热量 TDEE | `BMR × PAL` | 1,655 × 1.6 | **2,650 千卡/天** |
+| 增重盈余 | 目标每周增重 0.25~0.5 kg,+12% | 2,650 × 1.12 | **2,950 千卡/天** |
+
+> 若不走这 1 万步,维持热量约 2,400 千卡/天。这 1 万步本身约 7.5 km,净消耗约 244 千卡(7.5 km × 65 kg × 0.5 千卡/kg/km)。
+
+### 3. 六大营养素
+
+| 营养素 | 每日需要量 | 折算热量 | 供能占比 | 主要来源 |
+|---|---|---|---|---|
+| **碳水化合物** | **449 g** | 1,796 千卡 | 61% | 米饭、杂粮饭、燕麦、全麦面包、玉米、红薯、水果 |
+| **蛋白质** | **104 g** | 416 千卡 | 14% | 鸡蛋、牛奶、酸奶、鸡胸肉、鱼、豆制品 |
+| **脂肪** | **82 g** | 738 千卡 | 25% | 烹调油、坚果、全脂奶、蛋黄 |
+| **矿物质** | **约 8 g** | 不供能 | — | 奶类(钙)、深绿蔬菜(钙镁钾)、肉鱼(铁锌)、食盐(钠) |
+| **维生素** | **140 ~ 640 mg** | 不供能 | — | 深色蔬菜、水果、全谷物、蛋奶 |
+| **水** | **2,000 ~ 2,500 mL** | 不供能 | — | 白水 + 奶类 + 汤 |
+
+热量核对:1,796 + 416 + 738 = **2,950 千卡** ✓
+
+膳食纤维(常称“第七大营养素”):**30 g/天**。
+
+
+矿物质与维生素明细(点击展开)
+
+**矿物质(合计约 8 g/天,中国 DRIs 2023 成年男性)**
+
+| 矿物质 | 每日 | 矿物质 | 每日 |
+|---|---|---|---|
+| 钠 | 1,500 mg(上限 2,000 mg) | 镁 | 330 mg |
+| 氯 | 约 2,300 mg | 铁 | 12 mg |
+| 钾 | 2,000 mg | 锌 | 12.5 mg |
+| 钙 | 800 mg | 铜 / 锰 | 0.8 / 4.5 mg |
+| 磷 | 720 mg | 硒 / 碘 | 60 / 120 µg |
+
+**维生素(合计约 140 ~ 640 mg/天,含胆碱 500 mg 时取上限)**
+
+| 维生素 | 每日 | 维生素 | 每日 |
+|---|---|---|---|
+| 维生素 C | 100 mg | 维生素 B1 / B2 / B6 | 各 1.4 mg |
+| 维生素 E | 14 mg α-TE | 叶酸 | 400 µg DFE |
+| 烟酸 | 15 mg NE | 维生素 A | 800 µg RAE |
+| 泛酸 | 5 mg | 维生素 D / K | 10 / 80 µg |
+| 胆碱 | 500 mg | 维生素 B12 | 2.4 µg |
+
+
+
+### 4. 公式与出处
+
+- **BMI**:`体重(kg) ÷ 身高(m)²`;分类采用 **WS/T 428-2013《成人体重判定》**。
+- **BMR**:**Mifflin-St Jeor**(Mifflin et al., 1990),男 `10W + 6.25H − 5A + 5`,女 `10W + 6.25H − 5A − 161`。
+- **PAL**:`TDEE = BMR × PAL`,PAL 参考 **FAO/WHO 能量需求框架** 与步数分级,1 万步取 1.6。
+- **增减重**:在 TDEE 上叠加 ±10% ~ 15%(增重取 +12%,约 +300 千卡/天)。
+- **克数换算**:**Atwater 系数**——碳水 4、蛋白质 4、脂肪 9 千卡/g。
+- **营养素比例**:蛋白质 1.6 g/kg(ACSM/ISSN 增肌建议 1.2 ~ 2.2 g/kg);脂肪供能 20% ~ 30%、碳水 50% ~ 65%(中国居民膳食指南 2022)。
+- **微量营养素与水**:中国居民膳食营养素参考摄入量 **DRIs 2023**;饮水参考膳食指南 2022。
+
+> ⚠️ 估算存在误差:Mifflin 个体误差约 ±10%,PAL 不确定性最大。建议按目标热量执行 2~4 周后称重校准:每周涨 0.25 ~ 0.5 kg 为合适;体重不动则加 200 ~ 300 千卡,超过 1 kg/周则减 200 千卡。
+
+### 5. 一日菜谱示例(约 2,950 千卡)
+
+| 餐次 | 内容 | 千卡 |
+|---|---|---|
+| 早餐 | 燕麦片 55 g、水煮蛋 1 个、全脂牛奶 250 mL、全麦面包 2 片、香蕉 120 g | 729 |
+| 上午加餐 | 全脂酸奶 150 g、馒头 50 g、苹果 120 g | 280 |
+| 午餐 | 米饭 370 g、鸡胸肉 60 g、西兰花+胡萝卜+青椒 250 g、菜籽油 15 g、玉米 120 g | 826 |
+| 下午加餐 | 牛奶 250 mL、蒸红薯 100 g、橙子 100 g | 297 |
+| 晚餐 | 杂粮饭 350 g、清蒸鲈鱼 90 g、菠菜+香菇 200 g、橄榄油 12 g、玉米 100 g、腰果 15 g | 849 |
+| **合计** | 碳水 458 g / 蛋白 112 g / 脂肪 81 g | **2,981** |
+
+等热量替换:米饭 ↔ 面条 / 土豆;鸡胸 ↔ 虾 / 豆腐 / 牛里脊;鲈鱼 ↔ 龙利鱼 / 去皮鸡腿;香蕉 ↔ 蓝莓 / 猕猴桃;腰果 ↔ 杏仁 / 花生。
+
+## 免责声明
+
+本仓库仅用于学习与参考,不构成医疗或营养建议。如有健康问题,请咨询医生或注册营养师。
diff --git a/index.html b/index.html
index 1b227b1..ce07b17 100644
--- a/index.html
+++ b/index.html
@@ -269,6 +269,53 @@
+
+
每日热量与六大营养素
+
示例:25 岁男性,180 cm / 65 kg,每天约 1 万步。基础代谢用 Mifflin-St Jeor 公式,活动系数 PAL 取 1.6,增重盈余 +12%。
+
+
+ 基础代谢 BMR
+ 1,655千卡/天
+
+
+ 维持热量 TDEE
+ 2,650千卡/天
+
+
+ 每日目标热量
+ 2,950千卡/天
+
+
+
+
+
+ 1 碳水化合物
+ 449g · 1,796 千卡 · 61%
+
+
+ 2 蛋白质
+ 104g · 416 千卡 · 14%
+
+
+ 3 脂肪
+ 82g · 738 千卡 · 25%
+
+
+ 4 矿物质
+ 约 8g(钠 2000 · 氯 2300 · 钾 2000 · 钙 800 · 磷 720 · 镁 330 mg 等)
+
+
+ 5 维生素
+ 140 ~ 640mg(维 C 100 · 维 E 14 · 烟酸 15 · B1/B2/B6 各 1.4 · 胆碱 500 mg 等)
+
+
+ 6 水
+ 2,000 ~ 2,500mL/天
+
+
+
附:膳食纤维 30 g/天(常称“第七大营养素”)。克数换算采用 Atwater 系数——碳水 4、蛋白质 4、脂肪 9 千卡/g。完整算法与菜谱见 README,命令行版见 tdee.py。
+
+
说明
diff --git a/tdee.py b/tdee.py
new file mode 100644
index 0000000..589b7b4
--- /dev/null
+++ b/tdee.py
@@ -0,0 +1,193 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""每日热量与六大营养素估算。
+
+用法示例:
+ python tdee.py
+ python tdee.py --sex male --age 25 --height 180 --weight 65 --steps 10000
+ python tdee.py --goal maintain # 维持体重
+ python tdee.py --goal lose # 减重
+
+算法:
+ BMI = 体重(kg) / 身高(m)^2
+ BMR = Mifflin-St Jeor (1990)
+ TDEE = BMR × PAL(PAL 由每日步数分档)
+ 目标 = TDEE × (1 + 增减重盈余)
+ 三大营养素克数 = 目标热量按 Atwater 系数 4 / 4 / 9 kcal/g 分配
+ 矿物质 / 维生素 / 水 / 膳食纤维 = 中国居民膳食指南与 DRIs 参考值
+"""
+
+import argparse
+
+# 每日步数 -> (PAL 系数, 说明),参考 FAO/WHO 能量需求与步数分级
+STEP_LEVELS = [
+ (5000, 1.375, "久坐 / 很少活动"),
+ (7500, 1.5, "轻度活动"),
+ (10000, 1.6, "中等活动(约 1 万步)"),
+ (12500, 1.7, "较高活动"),
+ (10 ** 9, 1.9, "高强度活动"),
+]
+
+# 中国 DRIs 2023:成年男性(25 岁)矿物质参考摄入量
+MINERALS = [
+ ("钠", "1500 mg(PI 上限 2000 mg)"),
+ ("氯", "约 2300 mg"),
+ ("钾", "2000 mg"),
+ ("钙", "800 mg"),
+ ("磷", "720 mg"),
+ ("镁", "330 mg"),
+ ("铁", "12 mg"),
+ ("锌", "12.5 mg"),
+ ("铜", "0.8 mg"),
+ ("锰", "4.5 mg"),
+ ("硒", "60 µg"),
+ ("碘", "120 µg"),
+]
+
+# 中国 DRIs 2023:成年男性(25 岁)维生素参考摄入量
+VITAMINS = [
+ ("维生素 C", "100 mg"),
+ ("维生素 E", "14 mg α-TE"),
+ ("烟酸(B3)", "15 mg NE"),
+ ("泛酸(B5)", "5 mg"),
+ ("维生素 B1", "1.4 mg"),
+ ("维生素 B2", "1.4 mg"),
+ ("维生素 B6", "1.4 mg"),
+ ("叶酸(B9)", "400 µg DFE"),
+ ("维生素 A", "800 µg RAE"),
+ ("维生素 D", "10 µg"),
+ ("维生素 K", "80 µg"),
+ ("维生素 B12", "2.4 µg"),
+ ("胆碱", "500 mg"),
+]
+
+SURPLUS = {"maintain": 0.0, "gain": 0.12, "lose": -0.15}
+
+
+def pal_from_steps(steps):
+ """把每日步数换算成活动系数 PAL。"""
+ for limit, pal, label in STEP_LEVELS:
+ if steps <= limit:
+ return pal, label
+ return 1.9, "高强度活动"
+
+
+def calc_bmi(height_cm, weight_kg):
+ return weight_kg / (height_cm / 100) ** 2
+
+
+def classify(bmi):
+ """中国标准 WS/T 428-2013。"""
+ if bmi < 18.5:
+ return "偏瘦"
+ if bmi < 24:
+ return "正常"
+ if bmi < 28:
+ return "超重"
+ return "肥胖"
+
+
+def calc_bmr(sex, weight_kg, height_cm, age):
+ """Mifflin-St Jeor 基础代谢公式。"""
+ base = 10 * weight_kg + 6.25 * height_cm - 5 * age
+ return base + 5 if sex == "male" else base - 161
+
+
+def macro_grams(target_kcal, weight_kg, protein_per_kg=1.6, fat_ratio=0.25):
+ """返回 (碳水 g, 蛋白质 g, 脂肪 g)。
+
+ 蛋白质按体重给定系数;脂肪占目标热量固定比例;碳水用剩余热量补齐。
+ """
+ protein_g = protein_per_kg * weight_kg
+ fat_g = target_kcal * fat_ratio / 9
+ carb_kcal = target_kcal - protein_g * 4 - fat_g * 9
+ return carb_kcal / 4, protein_g, fat_g
+
+
+def walk_kcal(steps, weight_kg, stride_m=0.75, cost=0.5):
+ """步行净消耗估算:距离(km) × 体重(kg) × 0.5 kcal/kg/km。"""
+ km = steps * stride_m / 1000
+ return km, km * weight_kg * cost
+
+
+def line(label, value, width=14):
+ return " {:<{w}}{}".format(label, value, w=width)
+
+
+def main():
+ p = argparse.ArgumentParser(description="每日热量与六大营养素估算")
+ p.add_argument("--sex", choices=["male", "female"], default="male")
+ p.add_argument("--age", type=float, default=25)
+ p.add_argument("--height", type=float, default=180, help="身高(cm)")
+ p.add_argument("--weight", type=float, default=65, help="体重(kg)")
+ p.add_argument("--steps", type=int, default=10000, help="每天步数")
+ p.add_argument("--goal", choices=["maintain", "gain", "lose"], default="gain")
+ args = p.parse_args()
+
+ bmi = calc_bmi(args.height, args.weight)
+ bmr = calc_bmr(args.sex, args.weight, args.height, args.age)
+ pal, pal_label = pal_from_steps(args.steps)
+ tdee = bmr * pal
+ surplus = SURPLUS[args.goal]
+ target = tdee * (1 + surplus)
+ carbs, protein, fat = macro_grams(target, args.weight)
+ km, walk = walk_kcal(args.steps, args.weight)
+
+ goal_cn = {"maintain": "维持体重", "gain": "增重 / 增肌", "lose": "减重"}[args.goal]
+
+ print("=" * 44)
+ print("每日热量与六大营养素估算")
+ print("=" * 44)
+ print("【基础信息】")
+ print(line("性别 / 年龄", "{}{:.0f} 岁".format("男" if args.sex == "male" else "女", args.age)))
+ print(line("身高 / 体重", "{:.0f} cm / {:.1f} kg".format(args.height, args.weight)))
+ print(line("每天步数", "{} 步".format(args.steps)))
+ print(line("目标", goal_cn))
+ print()
+
+ print("【BMI】")
+ print(line("BMI", "{:.1f}".format(bmi)))
+ print(line("分类", "{}(WS/T 428-2013)".format(classify(bmi))))
+ print()
+
+ print("【热量】")
+ print(line("基础代谢 BMR", "{:,.0f} 千卡/天".format(bmr)))
+ print(line("活动系数 PAL", "{:.2f} ({})".format(pal, pal_label)))
+ print(line("维持热量 TDEE", "{:,.0f} 千卡/天".format(tdee)))
+ print(line("增减重盈余", "{:+.0%}".format(surplus)))
+ print(line("每日目标热量", "{:,.0f} 千卡/天".format(target)))
+ print(line("走路净消耗", "约 {:.0f} 千卡({:.1f} km)".format(walk, km)))
+ print()
+
+ print("【六大营养素】")
+ print(line("1 碳水", "{:.0f} g ({:.0f} 千卡,{:.0f}%)".format(
+ carbs, carbs * 4, carbs * 4 / target * 100)))
+ print(line("2 蛋白质", "{:.0f} g ({:.0f} 千卡,{:.0f}%)".format(
+ protein, protein * 4, protein * 4 / target * 100)))
+ print(line("3 脂肪", "{:.0f} g ({:.0f} 千卡,{:.0f}%)".format(
+ fat, fat * 9, fat * 9 / target * 100)))
+ print(line("4 矿物质", "约 8 g/天(见下列明细,不以克计供能)"))
+ print(line("5 维生素", "约 140 ~ 640 mg/天(见下列明细)"))
+ print(line("6 水", "2000 ~ 2500 mL/天"))
+ print()
+ print(" 附:膳食纤维 30 g/天(常称“第七大营养素”)")
+ print()
+
+ print("【矿物质明细(中国 DRIs 2023)】")
+ for name, amount in MINERALS:
+ print(line(" " + name, amount))
+ print()
+
+ print("【维生素明细(中国 DRIs 2023)】")
+ for name, amount in VITAMINS:
+ print(line(" " + name, amount))
+ print()
+
+ print("提示:估算存在个体误差(BMR ±10%,PAL 不确定性最大)。")
+ print(" 建议按目标热量执行 2~4 周后称重校准:")
+ print(" 每周涨 0.25~0.5 kg 为合适;体重不动则加 200~300 千卡,")
+ print(" 超过 1 kg/周则减 200 千卡。")
+
+
+if __name__ == "__main__":
+ main()