diff --git a/README.md b/README.md index 7094496..74d3a54 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,241 @@ # bmi-tdee-calculator -BMI 计算与每日热量需求(BMR/TDEE)计算器 +BMI 计算与每日热量需求(BMR / TDEE)计算器 —— 网页版(千禧年闪亮风)+ 命令行版 + React 组件源码。 -## 文件说明 +> 一句话:算出你一天该吃多少千卡,再给你三套「减重 / 维持 / 增重」可选可替换的一日食谱。 -| 文件 | 说明 | -| --- | --- | -| `index.html` | 网页版「每日热量需求与膳食计算器」,直接打开即可使用(React + Tailwind,免构建) | -| `CalorieCalculator.jsx` | 网页所用的 React 组件源码,需要接入打包项目时可直接引用 | -| `bmi_calculator.py` | 命令行版 BMI 计算器 | +--- -> 说明:原先的 `tdee_calculator.py` 其实是一段 React 代码(扩展名写错了), -> 现已整理为 `CalorieCalculator.jsx`,并做成了可直接打开的 `index.html`。 +## 一、目录结构(4 个文件) -## 网页版功能 +| 文件 | 大小 | 作用 | 打开方式 | +| --- | --- | --- | --- | +| `index.html` | 约 38 KB | **主程序**。单文件网页,浏览器直接打开就能用 | 双击,或部署到 Pages | +| `CalorieCalculator.jsx` | 约 24 KB | React 组件源码(想接进 React 项目时引用) | 需要构建工具 | +| `bmi_calculator.py` | 约 1.3 KB | 命令行版 BMI 计算器(最早的原型) | `python3 bmi_calculator.py` | +| `README.md` | 本文件 | 说明书 | 直接看 | -- 输入性别 / 年龄 / 身高 / 体重 / 每日步数 -- Mifflin-St Jeor 公式算 BMR,结合步数区间系数得到 TDEE,并给出「维持热量 + 300 千卡」的增重目标 -- 蛋白质 / 脂肪 / 碳水三大产能营养素目标 -- 早餐 / 午餐 / 晚餐 / 加餐:每餐可点选替换食材,实时汇总热量与营养素 -- 膳食纤维、钙、铁、锌、维生素 A / C、水分的摄入量与参考值进度条 +> 说明:早期有个 `tdee_calculator.py`,其实是 React 代码误用了 `.py` 后缀,已改名为 `CalorieCalculator.jsx`。 +> `index.html` 是当前唯一的「正式入口」,另外两个文件是历史版本 / 备用形态,**改功能只需要改 `index.html`**。 -## 使用方式 +`index.html` 的运行方式(没有构建步骤): -直接双击打开 `index.html` 即可(首次加载需联网获取 CDN 上的 React / Tailwind)。 +``` +cdnjs:React 18.3.1 UMD ×2 + babel-standalone 7.26.4 + └─