From cf17cccf8e2bf5823dd552a9568ab258e22f75f0 Mon Sep 17 00:00:00 2001 From: class04f21 Date: Thu, 24 Sep 2026 04:02:32 +0000 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E7=AE=97=E6=B3=95=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E4=B8=8E=E5=86=B3=E7=AD=96=E8=AE=B0=E5=BD=95=EF=BC=9A?= =?UTF-8?q?=E5=88=86=E5=B9=B4=E9=BE=84=E6=AE=B5=E6=A0=87=E5=87=86=E4=B8=8E?= =?UTF-8?q?=E5=85=AC=E5=BC=8F=E3=80=81=E5=AD=97=E6=AE=B5=E4=B8=8A=E7=95=8C?= =?UTF-8?q?=E4=B8=8E=E4=BA=A4=E5=8F=89=E6=A0=A1=E9=AA=8C=E3=80=81=E5=B0=81?= =?UTF-8?q?=E9=A1=B6=E8=A7=84=E5=88=99=E3=80=81=E7=9B=AE=E6=A0=87=E7=83=AD?= =?UTF-8?q?=E9=87=8F=E4=B8=8E=E8=90=A5=E5=85=BB=E7=B4=A0=E5=8F=8D=E6=8E=A8?= =?UTF-8?q?=E3=80=81=E5=B1=80=E9=99=90=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ALGORITHM.md | 155 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 ALGORITHM.md 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 或伴随症状(月经停闭、掉发、乏力、怕冷)者,应由医生/注册营养师评估,本工具不能替代诊断。