diff --git a/ALGORITHM.md b/ALGORITHM.md new file mode 100644 index 0000000..376d722 --- /dev/null +++ b/ALGORITHM.md @@ -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 或伴随症状(月经停闭、掉发、乏力、怕冷)者,应由医生/注册营养师评估,本工具不能替代诊断。