补充算法说明与决策记录:分年龄段标准与公式、字段上界与交叉校验、封顶规则、目标热量与营养素反推、局限。

This commit is contained in:
2026-09-24 04:02:32 +00:00
parent 8dde0ea71e
commit cf17cccf8e
+155
View File
@@ -0,0 +1,155 @@
# 算法说明与决策记录
本文记录本工具的计算链路与每一步的取舍理由。
## 0. 总体链路
```
1. 数据校验(单位 / 生理上界 / 模型适用范围)
2. BMI = 体重(kg) / 身高(m)^2
3. 选参考标准判定
4. BMR
5. TDEE = BMR x PAL
6. 目标热量 = TDEE +/- 调整量
7. 营养素反推
8. 每 2-4 周按体重趋势校准
```
任何一步的输入超出模型适用范围,都在第 1 步拦下,不做外推。
## 1. 数据校验
| 字段 | 采纳范围 | 依据 |
|---|---|---|
| 年龄 | 0 - 122 岁 | 人类最长寿纪录(Jeanne Calment,122 岁) |
| 身高 | 30 - 250 cm | 极端早产儿到最高个体 |
| 体重 | 0.5 - 500 kg | 最低可存活体重到最重纪录量级 |
| 步数 | 0 - 200000 步 | 24 小时步行纪录量级;无穷大或负值无定义 |
交叉校验:
- `年龄 < 2 岁 且 体重 > 30 kg` -> 报错。该组合与发育规律不符,属于需要即刻就医的情形,不做居家计算。
- `年龄 < 2 岁 且 身高 > 100 cm` -> 警告,要求核对。
- `年龄 < 5 岁` -> 警告,说明应改用 WHO 2006 身长/体重曲线。
- `年龄 < 18 岁` -> 警告,说明不可套用成人 18.5-24.9 标准。
## 2. BMI
```
BMI = 体重(kg) / [身高(m)]^2
```
例:50 kg / 1.80^2 = 15.4。
## 3. 参考标准选择
| 年龄段 | 标准 | 判定方式 |
|---|---|---|
| 0 - 5 岁 | WHO 2006 Child Growth Standards | 身长/体重曲线(本工具只给 BMI 数值并提示) |
| 5 - 19 岁 | WHO 2007 BMI-for-age | Z 分数 / 百分位 |
| >= 20 岁 | WHO 成人 BMI 分类 | 固定界值 |
青少年 Z 分数:
```
Z = (BMI - M) / S
百分位 = Phi(Z) x 100%
```
(M 为中位数,S 为尺度参数。本仓库用近似 M、S,正式临床使用应替换为 WHO 官方 LMS 表。)
青少年判定阈值:
| Z 分数 | 判定 |
|---|---|
| Z < -3 | 重度消瘦 |
| -3 <= Z < -2 | 消瘦 |
| -2 <= Z <= 1 | 正常 |
| 1 < Z <= 2 | 超重风险 |
| 2 < Z <= 3 | 超重 |
| Z > 3 | 肥胖 |
成人判定阈值(WHO):
| BMI | 判定 |
|---|---|
| < 16.0 | 重度偏瘦 |
| 16.0 - 16.9 | 中度偏瘦 |
| 17.0 - 18.4 | 轻度偏瘦 |
| 18.5 - 24.9 | 正常 |
| 25.0 - 29.9 | 超重 |
| 30.0 - 34.9 | I 度肥胖 |
| 35.0 - 39.9 | II 度肥胖 |
| >= 40.0 | III 度肥胖 |
## 4. BMR
按年龄分流:
- `< 18 岁`:Schofield(FAO/WHO)
```
女 0-3 岁 : 61.0 x W - 51
女 3-10 岁 : 22.5 x W + 499
女 10-18 岁: 12.2 x W + 746
男 0-3 岁 : 60.9 x W - 54
男 3-10 岁 : 22.7 x W + 495
男 10-18 岁: 17.5 x W + 651
```
- `>= 18 岁`:Mifflin-St Jeor
```
BMR = 10 x W + 6.25 x H - 5 x A + s
s = +5(男), -161(女)
```
W = 体重(kg),H = 身高(cm),A = 年龄(岁)。
## 5. TDEE
```
TDEE = BMR x PAL
```
PAL 按每日步数分档:
| 每日步数 | PAL |
|---|---|
| < 5000 | 1.45 |
| 5000 - 7499 | 1.55 |
| 7500 - 9999 | 1.65 |
| 10000 - 12499 | 1.75 |
| >= 12500 | 1.85 |
上界处理:人体能量消耗受摄氧与产热限制,TDEE 超过 12000 kcal/天(超耐力赛事历史峰值量级)时封顶并给出提示。BMR 低于 400 kcal/天时同样封顶。
## 6. 目标热量
```
目标 = TDEE + 300 # 偏瘦(成人 BMI < 18.5,或青少年 Z < -1)
目标 = TDEE - 400 # 成人 BMI >= 25
目标 = TDEE # 其余为维持
```
未成年人一律不输出减脂方案,只给维持或温和增重。
## 7. 营养素反推
| 营养素 | 目标 |
|---|---|
| 蛋白质 | <18 岁 1.3-1.5 g/kg;增重 1.5-1.8 g/kg;其余 1.2-1.6 g/kg |
| 脂肪 | 总热量 x 25-30% / 9 |
| 碳水 | (总热量 - 蛋白 x 4 - 脂肪 x 9) / 4 |
## 8. 迭代校准
- 每 2-4 周称重一次(同一时间、同一条件),看趋势而非单点。
- 每次调整 +/-100-200 kcal。
- 1 kg 体重变化约对应 7700 kcal。
## 9. 局限
- 公式为人群平均估计值,个体差异可达 +/-10-15%。
- 内置参考曲线为近似值,正式使用需替换为 WHO 官方 LMS 表。
- 婴幼儿、未成年人、BMI 超出 +/-3SD 或伴随症状(月经停闭、掉发、乏力、怕冷)者,应由医生/注册营养师评估,本工具不能替代诊断。