Health Management

SKILL.md

---
name: health-score-pro
version: 1.6.0
description: "健康管理助手 - 基于十本畅销健康书籍共识的数据驱动健康管理系统。**快速暗号**: 健康记录、饮食分析、健康评分、周报、月报。**自然触发**: 记录饮食、查询营养、分析健康状况、补剂管理。支持多语言、多用户、时区自动识别。"
metadata:
  openclaw:
    emoji: "🏥"
    thinking: "medium"
---

# 健康管理助手

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

---

## 功能说明

### 核心功能

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
```

---

## 快速暗号

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

---

## 自然触发

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

---

## 数据格式

### 每日记录格式

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

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

**参考模板**: [assets/daily-tracking-template.md](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 输出规范**:
- ✅ "苹果醋不含果糖(发酵过程已消耗)"
- ✅ "苹果醋有助于降低血糖峰值"
- ❌ "苹果醋含果糖"(绝对禁止)

---

## 重要注意事项

### 文件操作安全

**❌ 绝对禁止的危险操作**:
```bash
# ❌ 错误 - 会导致无限循环,文件爆炸式增长
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](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/principles.md)
- **食物数据库**: [references/food-database.md](references/food-database.md)
- **中餐食物数据库**: [references/chinese-food-database.md](references/chinese-food-database.md)
- **补剂数据库**: [references/supplement-database.md](references/supplement-database.md)
- **分析指南**: [references/analysis-guide.md](references/analysis-guide.md)

---

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