WHO Growth Charts

核心用法

who-growth-charts 是一款专业儿童生长发育可视化工具，依据世界卫生组织（WHO）官方标准数据库，生成身高-年龄、体重-年龄、BMI-年龄三项核心指标的百分位曲线图。用户只需提供儿童姓名、出生日期、性别及测量数据，即可自动生成包含个体生长轨迹叠加的专业图表。

关键操作流程：
1. 首次运行时自动从 WHO 官方 CDN（cdn.who.int）下载权威参考数据并本地缓存
2. 通过命令行参数指定儿童基本信息与图表类型
3. 可选导入 JSON 格式的身高/体重测量记录，系统将绘制生长趋势线并与百分位曲线对比
4. 输出高清 PNG 图表，默认保存至 ~/clawd/who-growth-charts/

显著优点

• 数据来源权威：直接使用 WHO 官方 Child Growth Standards，非第三方转译或估算数据
• 覆盖年龄段全面：身高/BMI支持0-19岁全周期，体重支持0-10岁关键期
• 可视化专业：生成医学级百分位曲线图，支持多时间点测量数据叠加，便于识别生长偏离趋势
• 生态可扩展：预留与 withings-family 智能体重设备的数据接口，可实现自动化数据流
• 本地化处理：WHO 数据仅首次下载后本地缓存，支持离线使用

潜在局限性与风险

• 测量精度依赖：脚本要求身高以米、体重以千克为单位，用户输入错误单位会导致严重误判
• 数据格式严格：测量数据需符合特定 JSON 结构（ISO 8601 时间戳 + 数值），手工录入门槛较高
• BMI 计算隐含：系统根据身高体重自动计算 BMI，若原始数据时间戳不匹配可能产生错误计算点
• 年龄计算精度：使用 DD.MM.YYYY 日期格式，跨时区或闰年极端场景未明确处理
• 医学解释权缺失：工具仅提供可视化，不解释百分位临床意义（如第3百分位以下或第97百分位以上的医学建议）

适合人群

• 关注儿童生长发育的家长（需具备基础数据录入能力）
• 儿科保健工作者作为可视化辅助工具
• 需长期追踪生长趋势的早产儿或慢性病儿童家庭
• 已使用 Withings 智能设备的科技导向型家长

常规风险提示

⚠️ 非医疗器械声明：本工具生成的图表不可替代专业儿科评估，百分位偏离需由医生结合遗传、营养、病史综合判断。

⚠️ 数据安全：儿童生长数据含敏感个人信息，JSON 数据文件与输出图表需妥善保管，避免云端存储泄露。

⚠️ 单位校验：强烈建议在录入数据前用标准工具复核单位，厘米/米、斤/千克混淆是常见误用场景。

核心用法

who-growth-charts 是一款基于世界卫生组织（WHO）官方标准生成儿童生长曲线图的专业工具，支持身高-年龄、体重-年龄、BMI-年龄三种核心图表类型，覆盖0-19岁男童和女童的生长发育评估。

基础操作

通过命令行生成生长图表：

python3 ./scripts/growth_chart.py "Emma" "06.07.2016" --sex F --type all --data emma_data.json

• name: 儿童姓名（用于图表标题）
• birthdate: 出生日期（DD.MM.YYYY格式）
• --sex: F（女）或 M（男）
• --type: height（身高）、weight（体重）、bmi 或 all（全部）
• --data: 包含测量数据的JSON文件（可选）

数据格式

测量数据JSON支持身高（米）和体重（公斤）的时间序列：

{
  "heights": [["2024-01-15T10:00:00", 1.05]],
  "weights": [["2024-01-15T10:00:00", 17.5]]
}

工具可自动叠加实际测量点并绘制趋势线，直观对比儿童生长轨迹与WHO标准百分位曲线。

数据集成

支持与 withings-family 等智能体重秤Skill联动，实现测量数据自动导入，减少手动录入。

---

显著优点

| 优势维度 | 具体说明 |

|---------|---------|

| **数据来源权威** | 直接对接WHO官方CDN（cdn.who.int），获取经过国际科学验证的儿童生长标准数据 |

| **本地隐私优先** | 所有儿童敏感信息（姓名、出生日期、身高体重）仅本地存储处理，**零上传云端**，杜绝隐私泄露风险 |

| **可视化专业** | 基于matplotlib生成医学级生长曲线图，标准百分位线清晰，支持趋势追踪 |

| **跨平台兼容** | Python脚本形式，支持macOS、Linux、Windows等主流系统 |

| **扩展性良好** | 开源JSON数据格式，便于与其他健康设备或医疗系统集成 |

---

潜在局限

1. 技术门槛较高：需要Python环境及pandas、matplotlib、scipy等科学计算库，对非技术用户不够友好
2. 依赖外部网络：首次使用或缓存过期时需从WHO CDN下载参考数据，离线环境下功能受限
3. 无完整性校验：下载的WHO数据文件缺乏SHA256等哈希校验机制，存在极低的中间人篡改理论风险
4. 数据管理责任：儿童生长数据以明文JSON和PNG形式存储于本地，需用户自行做好备份与安全保管
5. 年龄范围限制：体重-年龄图表仅支持0-10岁，BMI和身高支持至19岁

---

适合人群

| 用户类型 | 使用场景 |

|---------|---------|

| **技术型家长** | 熟悉命令行操作，希望获得WHO标准专业图表进行自主生长监测 |

| **儿科诊所/儿保机构** | 批量生成标准化生长报告，辅助医生评估发育状况 |

| **健康数据极客** | 整合智能穿戴设备数据，构建个人儿童健康档案系统 |

| **研究人员** | 获取标准化WHO参考曲线进行流行病学或发育学研究 |

不适合：追求"一键式"App体验、无技术背景的日常家长用户。

---

常规风险与应对

| 风险类型 | 等级 | 说明与建议 |

|---------|------|-----------|

| **数据泄露（本地）** | 中 | 儿童敏感信息存储于`~/clawd/who-growth-charts/`，建议设置目录权限、定期备份加密 |

| **网络不可用** | 低 | 依赖WHO CDN可用性，建议首次使用时完成数据缓存 |

| **依赖库漏洞** | 低 | 大型科学计算库（pandas/matplotlib）可能存在CVE，建议`pip install --upgrade`定期更新 |

| **输入错误** | 低 | 日期格式或JSON格式错误会导致运行失败，建议先用示例数据测试 |

| **WHO CDN变更** | 极低 | 若WHO调整CDN URL或数据结构，需等待Skill更新 |