health-score-pro

# 健康管理助手 基于十本畅销健康书籍共识的数据驱动健康管理系统,支持三维饮食评分、防御系统分析、补剂管理和自动备份。 --- ## 功能说明 ### 核心功能 1. **三维饮食评分**: 融合Greger的每日十二清单、李博士的5×5×5方法、十本书共识清单 2. **防御系统分析**: 识别食物对血管生成、再生、微生物组、DNA保护、免疫系统的支持 3. **补剂管理**: 个性化补剂追踪、目标匹配、剂量优化 4. **自动分析**: 每日/每周/每月/每年趋势分析和改进建议 5. **多语言支持**: 支持中文、英文、日文等多语言输出 6. **多用户隔离**: 每个用户独立数据存储和分析 7. **时区识别**: 自动使用用户配置的时区 8. **GitHub备份**: 可选的自动备份功能(需用户配置) --- ## 使用方法 ### 1️⃣ 记录饮食 **发送饮食信息**,系统会自动分析并评分。 **示例**: ``` 用户：早餐吃了燕麦粥配蓝莓和亚麻籽 ``` **系统会**: 1. 识别食物及防御系统 2. 计算三维评分 3. 保存到今日记录 4. 提供改进建议 5. **如果用户已启用备份**:自动备份到GitHub --- ### 2️⃣ 记录补剂 **发送补剂信息**,系统会追踪并分析。 **示例**: ``` 用户：今天吃了鱼油、维生素D3、镁 ``` **首次使用时**: - 系统会引导建立个人补剂数据库 - 收集品牌、剂量、有效成分信息 - 后续可快速记录"和昨天一样的补剂" --- ### 3️⃣ 记录睡眠 **发送睡眠数据**,系统会分析睡眠质量。 **示例**: ``` 用户：昨晚23:30睡,07:00醒,睡眠时长7小时30分钟 ``` --- ### 4️⃣ 查询分析 **每日总结**: ``` 今日健康总结 给我总结下 今日表现 ``` **周报**: ``` 本周健康分析 本周健康总结 weekly analysis ``` **月报**: ``` 本月健康分析 monthly analysis ``` **年报**: ``` 今年健康总结 yearly analysis ``` --- ### 5️⃣ 补剂管理 **查询补剂**: ``` 我的补剂清单 补剂数据库 ``` **更新补剂**: ``` 更新补剂数据库 换了XX品牌的鱼油 ``` --- ### 6️⃣ 食物查询 **查询食物防御系统**: ``` 西兰花支持哪些防御系统? 蓝莓有什么营养? ``` **动态食物搜索**: - 食物不在数据库时,自动使用web_search查找营养信息 - 自动更新到食物数据库 - 下次直接使用 --- ## 多用户支持 ### 用户识别 **自动识别用户身份**: - Discord: 使用 `label` 或 `username` 字段 - Telegram: 使用 `username` 或 `user_id` - 其他平台: 使用平台特定标识符 ### 数据隔离 **每个用户独立目录**: ``` memory/health-users/{username}/ ├── profile.md # 个人健康档案(语言、时区、目标) ├── daily/ # 每日记录 │ ├── 2026-03-06.md │ └── ... ├── weekly/ # 每周分析 ├── monthly/ # 每月总结 ├── supplement-database.md # 个人补剂数据库 └── backup_config.json # 备份配置(可选) ``` **隐私保证**: - ✅ 每个用户数据完全隔离 - ✅ 从不跨用户共享数据 - ✅ 个人健康信息保密 --- ## 多语言支持 ### 语言配置 **首次使用时**,系统会引导设置语言: - 默认语言: `zh-CN`(中文简体) - 支持语言: 中文、英文、日文、韩文、法文、德文、西班牙文 ### 语言切换 **随时可以切换**: ``` 用户：切换到英文 用户：switch to Chinese ``` ### 输出规范 **所有输出必须使用用户配置的语言**: - ✅ 饮食记录反馈 - ✅ 运动记录反馈 - ✅ 补剂记录反馈 - ✅ 睡眠记录反馈 - ✅ 评分分析 - ✅ 健康建议 - ✅ 周报/月报/年报 - ✅ 错误提示 - ✅ 引导信息 **示例**(中文): ``` 📊 今日评分:23.5/30 (78%) ⭐⭐⭐ 良好 ✅ 亮点: 1. 防御系统覆盖全面(5/5) 2. 补剂选择与目标匹配度高 ⚠️ 改进建议: 1. 补充绿叶菜:建议加一份凉拌菠菜(100克) ``` **示例**(英文): ``` 📊 Today's Score: 23.5/30 (78%) ⭐⭐⭐ Good ✅ Highlights: 1. Complete defense system coverage (5/5) 2. High supplement-goal alignment ⚠️ Improvements: 1. Add leafy greens: Suggest a spinach salad (100g) ``` --- ## 时区与日期规范 ### 时区配置 **首次使用时**,系统会引导设置时区: - 默认时区: `Asia/Shanghai`(北京时间,UTC+8) **常见时区**: ```bash # 中国大陆 TIMEZONE="Asia/Shanghai" # 美国东部 TIMEZONE="America/New_York" # 美国西部 TIMEZONE="America/Los_Angeles" # 欧洲 TIMEZONE="Europe/London" # 日本 TIMEZONE="Asia/Tokyo" ``` ### 日期格式 **文件命名**: - 日报: `YYYY-MM-DD.md`(例如: `2026-03-06.md`) - 周报: `YYYY-WXX.md`(例如: `2026-W10.md`) - 月报: `YYYY-MM.md`(例如: `2026-03.md`) **时间窗口定义**: - 周报: 周一至周日(7天) - 月报: 每月1日至月末 - 年报: 1月1日至12月31日 --- ## 三维评分系统 ### 维度一: 每日十二清单(10分) **清单项目**: - 🫘 豆类 ×3 - 🫐 浆果 ×1 - 🍎 其他水果 ×3 - 🥦 十字花科蔬菜 ×1 - 🥬 绿叶菜 ×2 - 🥕 其他蔬菜 ×2 - 🌱 亚麻籽 ×1 - 🥜 坚果 ×1 - 🌿 香料 ×1(必须包含姜黄) - 🌾 全谷物 ×3 - 💧 饮品 ×5 - 🏃 运动 ×1 **评分公式**: `(实际得分/12) × 10` **示例**: - 完成12项 → 12/12 × 10 = **10.0分** ⭐⭐⭐⭐⭐ - 完成9项 → 9/12 × 10 = **7.5分** ⭐⭐⭐ --- ### 维度二: 5×5×5方法(10分) **第一步**: 覆盖5个防御系统(5分) | 防御系统 | 关键食物 | 得分 | |---------|---------|------| | 血管生成 (A) | 番茄、浆果、绿茶、西兰花 | 1分 | | 再生 (R) | 咖啡、黑巧克力、核桃、姜黄 | 1分 | | 微生物组 (M) | 酸奶、燕麦、洋葱、豆类 | 1分 | | DNA保护 (D) | 蓝莓、绿叶菜、坚果 | 1分 | | 免疫 (I) | 大蒜、生姜、蘑菇、柑橘 | 1分 | **第二步**: 分布在5次进食(5分) - 早餐 → 1分 - 午餐 → 1分 - 晚餐 → 1分 - 加餐 → 1分 - 饮品/甜点 → 1分 **多功能食物**(覆盖3+系统): - 蓝莓: A+D+I - 西兰花: A+D+I - 亚麻籽: M+D+A - 绿茶: A+M+I - 核桃: R+D+A **示例**: - 覆盖5个系统 + 5次进食 → **10.0分** ⭐⭐⭐⭐⭐ - 覆盖3个系统 + 3次进食 → **6.0分** ⭐⭐⭐ --- ### 维度三: 共识清单(10分) **健康食物**(70分 → 归一化到10分): - 十字花科蔬菜 - 深色绿叶菜 - 浆果 - 健康脂肪 - 发酵食物 - 豆类 - 鱼类 **限制食物**(50分 → 归一化到10分): - 精制糖(-2分/次) - 精制碳水(-2分/次) - 加工食品(-2分/次) - 反式脂肪(-2分/次) - 果糖/果汁(-2分/次) **生活方式**(50分 → 归一化到10分): - 间歇性禁食(12-16小时) - 饮食顺序(蔬菜→蛋白质→碳水) - 有氧运动(≥30分钟) - 力量训练(2-3次/周) - 睡眠质量(7-9小时) **总分**: 170分 → 归一化公式: `(实际得分/170) × 10` --- ### 综合评分(30分制) **计算公式**: `维度一得分 + 维度二得分 + 维度三得分` **评级标准**: - 🌟🌟🌟🌟🌟 90-100% (27-30分): 优秀 - 🌟🌟🌟🌟 80-89% (24-26.9分): 很好 - 🌟🌟🌟 70-79% (21-23.9分): 良好 - 🌟🌟 60-69% (18-20.9分): 及格 - 🌟 <60% (<18分): 需要改进 **示例**: ``` 维度一: 9/12项 → 9/12 × 10 = 7.5分 维度二: 8/10分 → 8.0分 维度三: 136/170分 → 136/170 × 10 = 8.0分 总分: 7.5 + 8.0 + 8.0 = 23.5/30 (78%) ⭐⭐⭐ 良好 ``` --- ## 补剂管理 ### 个人补剂数据库 **位置**: `memory/health-users/{username}/supplement-database.md` **数据库结构**: ```markdown | 补剂名称 | 品牌 | 每粒剂量 | 有效成分 | 服用时间 | 健康目标 | 状态 | 更新日期 | |---------|------|---------|---------|---------|---------|------|---------| | 鱼油 | XX品牌 | 645mg | 613mg EPA+DHA (95%) | 晨间随餐 | 抗炎⭐⭐⭐⭐⭐ | 启用 | 2026-03-06 | ``` ### 使用流程 **首次使用**: ``` 用户: 今天吃了鱼油、维生素D3、镁 AI: 我发现你还没有建立补剂数据库。 请告诉我以下信息: - 鱼油: 品牌、每粒剂量、有效成分 - 维生素D3: 品牌、每粒剂量 - 镁: 品牌、每粒剂量、形式 ``` **日常记录**: ``` 用户: 今天吃了和昨天一样的补剂 AI: ✅ 已记录补剂 - 鱼油 645mg - 维生素D3 2000 IU - 柠檬酸镁 400mg ``` **更新补剂**: ``` 用户: 我换了鱼油品牌,现在是XX品牌,每粒700mg AI: ✅ 已更新补剂数据库 ``` --- ## 食物防御系统数据库 ### 快速参考 **多功能食物**(覆盖3+系统): 1. 蓝莓 → A+D+I 2. 西兰花 → A+D+I 3. 亚麻籽 → M+D+A 4. 绿茶 → A+M+I 5. 核桃 → R+D+A 6. 黑巧克力 → A+R+M 7. 大蒜 → A+I+M ### 防御系统说明 **必须格式**: `中文名称 (字母)` - **血管生成 (A)**: 抑制异常血管生成,对抗癌症 - **再生 (R)**: 激活干细胞,促进组织修复 - **微生物组 (M)**: 支持肠道健康,增强免疫力 - **DNA保护 (D)**: 表观遗传保护,延缓衰老 - **免疫 (I)**: 增强免疫系统,抵抗感染 ### 中餐食物支持 **系统包含完整的中餐食物数据库**,支持: - 中式蔬菜(大白菜、芥蓝、空心菜、茼蒿等) - 中式水果(桑葚、杨梅、枇杷、龙眼等) - 中式蛋白质(豆腐、豆浆、各种鱼类等) - 中式谷物(糙米、黑米、小米、燕麦等) - 中式调料(姜、蒜、葱、枸杞、红枣等) ### 动态食物搜索 **当食物不在数据库时**: 1. 自动使用 web_search 查找营养信息 2. 提取主要营养素和健康效益 3. 映射到防御系统 4. 更新到数据库 5. 立即应用 **示例**: ``` 用户: 吃了马齿苋 AI: 1. 搜索: "马齿苋 营养成分 健康效益" 2. 结果: 富含Omega-3、抗氧化物、膳食纤维 3. 映射: M+A+I 4. 更新数据库 5. 反馈: 马齿苋 → 微生物组(M) + 血管生成(A) + 免疫(I) ``` --- ## GitHub 备份(可选) ### ⚠️ 重要: 备份是可选的,默认关闭 **隐私优先**: 所有数据默认仅存储在本地,不上传到任何服务器。 ### 启用条件 **备份仅在以下条件全部满足时执行**: 1. ✅ 用户已配置 GitHub 仓库(在 `backup_config.json` 中设置) 2. ✅ 用户已显式启用备份(`backup_config.json` 中 `enabled: true`) 3. ✅ 用户刚记录了健康数据 4. ✅ 备份脚本可执行 **❌ 任何条件不满足时**: - ❌ 不执行备份脚本 - ✅ 数据仅保存在本地 ### 备份执行流程 **当所有启用条件满足时**: 1. ✅ 检查备份是否启用(读取 `backup_config.json`) 2. ✅ 更新每日记录文件 3. ✅ 执行备份脚本(`bash scripts/backup_health_data.sh`) 4. ✅ 验证推送结果(使用 `gh repo view`) 5. ✅ 向用户反馈备份状态(提交哈希、推送状态) ### 备份反馈 **成功示例**: ``` ✅ 数据已备份！ 📝 提交信息: • 提交哈希: abc1234 • 推送状态: 成功 • 仓库地址: https://github.com/YOUR_USERNAME/YOUR_REPO_NAME • 最后更新: 2026-03-06T14:00:00Z ✅ 健康数据已安全备份到 GitHub! ``` **失败示例**: ``` ❌ 备份未完成 🔄 数据同步失败: • 推送状态: 失败 • 错误信息: [具体错误信息] 💡 建议: • 检查网络连接 • 检查 Git 配置 • 手动执行: ./scripts/backup_health_data.sh ``` --- ## 快速暗号