健康管理助手

基于十本畅销健康书籍共识的数据驱动健康管理系统,支持三维饮食评分、防御系统分析、补剂管理和自动备份。

功能说明

核心功能

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)

常见时区:

# 中国大陆
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分)

第二步: 分布在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

数据库结构:

| 补剂名称 | 品牌 | 每粒剂量 | 有效成分 | 服用时间 | 健康目标 | 状态 | 更新日期 |
|---------|------|---------|---------|---------|---------|------|---------|
| 鱼油 | 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

快速暗号

• 健康记录 - 记录今日饮食
• 饮食分析 - 分析今日营养
• 健康评分 - 查看今日得分
• 周报 / 月报 - 查看周期报告
• 补剂记录 - 记录补剂
• 睡眠记录 - 记录睡眠
• 备份数据 - 手动触发备份

自然触发

• 记录饮食/早餐/午餐/晚餐
• 查询营养/健康建议
• 分析健康状况
• 补剂管理/查询
• 睡眠分析
• 周期报告(周/月/年)

数据格式

每日记录格式

文件位置: memory/health-users/{username}/daily/YYYY-MM-DD.md

必需内容:

1. 📊 三餐量化评估(含表格)
2. 🛡️ 防御系统覆盖评估(含表格)
3. 📈 三维度评分总览(含表格)
4. 💡 改进建议(亮点、改进空间、明日目标)
5. 📋 记录时间和数据来源

参考模板: assets/daily-tracking-template.md

评分输出规范

每次输出必须包含:

1. 评分说明(一句话):

📋 评分说明: 总分30分(3维度×10分) | 维度二(防御系统)单餐可满分

2. 防御系统显示(中文名称 (字母)格式):

- ✅ **血管生成 (A)**: 番茄、浆果
- ✅ **再生 (R)**: 咖啡、核桃

3. 星级评价:

| 维度 | 得分 | 评价 |
|------|------|------|
| **维度一: 每日十二** | 7.5/10 | ⭐⭐⭐ |
| **总分** | **23.5/30** | **78%** ⭐⭐⭐ |

发酵食品知识

⚠️ 重要: 发酵食品不含糖分

发酵过程会消耗糖分:

1. 第一步: 糖分 → 酒精(酵母发酵)
2. 第二步: 酒精 → 醋酸(醋酸菌发酵)
3. 结果: 发酵完成后,几乎不含糖分 ✅

苹果醋(Apple Cider Vinegar)

制作过程:

新鲜苹果汁 → 酒精发酵 → 醋酸发酵 → 苹果醋
(含果糖)   (糖→酒精)  (酒精→醋酸)  (不含果糖)

健康效益:

推荐用法:

• 餐前饮用: 1-2汤匙苹果醋 + 1杯水(餐前5-10分钟)
• 降低血糖峰值: 显著降低餐后血糖峰值20-30%
• 尿酸控制: 不含果糖,安全饮用

AI 输出规范:

• ✅ "苹果醋不含果糖(发酵过程已消耗)"
• ✅ "苹果醋有助于降低血糖峰值"
• ❌ "苹果醋含果糖"(绝对禁止)

重要注意事项

文件操作安全

❌ 绝对禁止的危险操作:

# ❌ 错误 - 会导致无限循环,文件爆炸式增长
cat file.md >> file.md
echo "内容" >> file.md >> file.md

✅ 正确的文件操作方法:

• 方法1: 使用 edit 工具(推荐)
• 方法2: 使用临时文件
• 方法3: 使用 write 工具(完全重写)

量化评估规则

⚠️ 必须根据实际摄入量评估,不能简单认为"吃了什么就达标"。

❌ 错误示例:

用户: 吃了2个猪肉白菜饺子
AI: ✅ 十字花科蔬菜达标!(错误!)

✅ 正确示例:

用户: 吃了2个猪肉白菜饺子
AI:
1. 估算实际摄入量: 2个饺子中白菜约10-15克
2. 对比目标: 十字花科蔬菜目标1份(80克)
3. 计算完成度: 10-15克 / 80克 = 13%-19%
4. 评估结果: ❌ 未达标(仅完成13%-19%)

语言输出强制检查

AI 每次回复前必须执行:

1. ✅ 读取用户语言配置
2. ✅ 使用用户语言输出所有内容
3. ✅ 验证语言一致性

❌ 绝对禁止:

• ❌ 忽略用户语言配置
• ❌ 部分内容使用用户语言,部分使用其他语言
• ❌ 不读取 profile.md 中的 Language 字段

使用示例

详细使用示例请参考: references/usage-examples.md

文件结构

health-management/
├── SKILL.md              # 本文件 - 技能说明
├── manifest.json         # 权限声明
├── PERMISSIONS.md        # 权限文档
├── README.md             # 项目说明
├── scripts/              # 脚本工具
│   ├── backup_health_data.sh       # 备份脚本
│   ├── check_git_config.sh         # Git检查
│   ├── configure_backup.sh         # 备份配置
│   ├── manage_backup.sh            # 备份管理
│   ├── language_utils.sh           # 语言工具
│   └── timezone_utils.sh           # 时区工具
├── references/           # 参考资料
│   ├── principles.md                # 十本书共识原则
│   ├── food-database.md            # 食物数据库
│   ├── chinese-food-database.md    # 中餐食物数据库
│   ├── supplement-database.md      # 补剂数据库
│   └── analysis-guide.md           # 分析指南
├── assets/               # 资源文件
│   ├── daily-tracking-template.md      # 每日记录模板
│   ├── weekly-analysis-template.md     # 周报模板
│   ├── monthly-summary-template.md     # 月报模板
│   ├── user-profile-template.md        # 用户档案模板
│   ├── supplement-tracking-template.md # 补剂记录模板
│   └── quick-log.md                    # 快速记录模板
└── templates/            # 其他模板
    └── onboarding-flow.md     # 新用户引导流程

参考资源

• 十本书共识原则: references/principles.md
• 食物数据库: references/food-database.md
• 中餐食物数据库: references/chinese-food-database.md
• 补剂数据库: references/supplement-database.md
• 分析指南: references/analysis-guide.md

Created by OpenClaw | Version 1.6.0 | 2026-03-22 Author: longerian