health-report-trend-analysis

体检指标趋势分析系统：把多年度、多形态的体检报告统一解析为标准化指标时间序列，产出趋势分析报告 + 交互式健康管理工作台。全程本地处理、自动脱敏、动态扩展。

功能特性

• 3 种输入形态：电子版 PDF（文本层）、扫描件 PDF（无文本层）、照片 JPG（自动合成 PDF）
• 统一指标字典：146 个原始指标名归一化到 116 个标准指标，跨年份/跨医院统一表达
• 历年趋势比对：异常判定（当年报告自带参考范围）、显著变化（≥20% 或≥参考宽度 30%）、趋好/趋坏标注
• 权威医学解读：默沙东诊疗手册 / 丁香医生 / 中国临床指南，分层建议（生活方式/饮食/运动/就医指征）
• 双交付物：结构化 Markdown 报告 + 离线 HTML 工作台（SVG 折线图+参考范围带，无外部依赖）
• 隐私保护：全程本地处理，自动生成脱敏数据集（仅指标数值+年份）
• 动态扩展：新增年度报告重跑流水线即可，趋势聚焦近三年（可配置）

快速开始

# 1. 设置环境变量
export REPORT_DIR=/path/to/体检报告目录      # 报告存放目录
export WORK_DIR=/path/to/工作数据目录        # 数据产物目录
export PY=python3                            # 建议用带依赖的 python

# 2. 解析（按输入形态选对应脚本）
$PY scripts/parse_reports.py                 # 电子版 PDF
$PY scripts/make_year_pdfs.py                # 照片 JPG → 合成 PDF（可选）
$PY scripts/extract_2022.py                  # 扫描件 OCR 提取（可选）

# 3. 归一化 + 趋势 + 交付
$PY scripts/build_dataset.py
$PY scripts/trend_analysis.py
$PY scripts/report_generator.py
$PY scripts/build_dashboard.py

依赖

• Python 3.8+
• pymupdf（PDF 文本层解析）
• Pillow（照片合成 PDF）
• macOS Vision framework via pyobjc-framework-Vision（扫描件/照片 OCR，仅 macOS）

目录结构

health-report-trend-analysis/
├── SKILL.md                      # 技能行为规范
├── scripts/                      # 可执行脚本（10 个）
├── references/                   # 解析口径 / OCR 方法学 / 新报告接入 / 降本纪律
└── data/、output/                # 运行时自动生成（数据产物 / 交付物）

免责声明

本系统为健康管理参考工具，依据公开医学权威来源整理指标解读建议，不构成诊疗意见。OCR 提取的指标准确率有限，趋势参考为主。如指标持续异常或伴不适症状，请及时就医。

License

MIT