核心用法
health-checkup-recommender 是一款面向健康场景的循证体检推荐引擎，通过多维度信息采集（年龄、性别、症状、家族史）生成个性化检查方案。执行流程遵循严格的标准化路径：信息收集 → 风险评估（查询 risk_logic_table.json）→ 症状匹配（查询 symptom_mapping.json）→ 项目验证（强制调用 verify_items.js）→ 价格计算（强制调用 calculate_prices.js）→ 循证解读 → 二维码生成（可选）。
数据层完全本地化，核心文件包括 checkup_items.json（唯一可信项目来源）、evidence_mappings_2025.json（国家卫健委2025版指引）、risk_logic_table.json（BMJ 2023/JAMA 2021/国家癌症中心数据）。所有价格计算和项目验证必须通过本地脚本执行，禁止 LLM 手动推算。
显著优点
1. 权威循证背书：风险评估直接引用 BMJ、JAMA、国家癌症中心及国家卫健委2025版指南，具备医学可信度
2. 隐私架构严谨：二维码仅含脱敏 welfareid/ruleid，不传输任何 PII；网络请求仅 sync_items.js 一处，且请求体仅为项目 ID 数组
3. 零部署成本：基于 OceanBus 黄页服务，npm install 即可运行，支持 220+ 城市机构预约
4. 智能降级保障：二维码生成脚本内置接口失败降级机制，确保 100% 可用性
5. OceanBus 生态集成：支持 register.js/serve.js 注册为可发现服务，其他 Agent 可通过标准 JSON 协议调用
潜在缺点与局限性
1. 最低消费门槛：合作机构不接低于 600 元订单，低价需求需强制补充项目，可能与用户预期冲突
2. 网络依赖单一：sync_items.js 为唯一外部依赖，若 pe.ihaola.com.cn 故障则无法生成本地二维码
3. 年龄分段较粗：仅 18-35/36-49/50-64/65+ 四档，边缘年龄精准度受限
4. 无实时库存感知：无法查询具体机构当日可约时段，需用户扫码后自行确认
5. 人工转接链路长：ocean-desk 转接需预配置环境变量，中小团队接入成本较高
适合人群
- 企业员工体检福利采购决策者
- 家庭健康管理用户（尤其有心血管病/糖尿病家族史者）
- 保险代理人/健康管理师等需快速生成专业方案的中介角色
- 对循证医学数据可信度有要求的理性消费者
常规风险
1. 医疗建议边界：输出仅为筛查建议，非诊断结论，需话术明确免责声明
2. 二维码授权管理：consent_required 为 true，但必须确保前端实现强制弹窗确认，避免合规风险
3. 依赖版本锁定：npm ci 基于 package-lock.json，若上游 qrcode 包出现安全漏洞需手动同步修复
4. 症状模糊匹配局限：symptom_mapping.json 的同义词覆盖依赖人工维护，生僻表述可能漏匹配