https://github.com/JuneYaooo/mediwise-health-suite
Family health management skill for OpenClaw – health records, diet tracking 家庭健康管理助手 for OpenClaw | 健康档案、饮食追踪、体重管理、就医摘要 | 本地 SQLite 存储，隐私优先
https://github.com/JuneYaooo/mediwise-health-suite
diet-tracker family-health health-management health-tracker openclaw weight-tracker
Last synced: about 2 months ago
JSON representation
Family health management skill for OpenClaw – health records, diet tracking 家庭健康管理助手 for OpenClaw | 健康档案、饮食追踪、体重管理、就医摘要 | 本地 SQLite 存储，隐私优先
- Host: GitHub
- URL: https://github.com/JuneYaooo/mediwise-health-suite
- Owner: JuneYaooo
- License: apache-2.0
- Created: 2026-03-08T13:53:40.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T17:07:03.000Z (3 months ago)
- Last Synced: 2026-04-04T07:44:18.594Z (2 months ago)
- Topics: diet-tracker, family-health, health-management, health-tracker, openclaw, weight-tracker
- Language: Python
- Homepage: https://clawhub.ai/JuneYaooo/mediwise-health-suite
- Size: 667 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-medical-ai-skills-cn - mediwise-health-suite - health-suite?style=flat-square) | **家庭健康管理套件** — 健康档案、饮食追踪、体重管理、用药提醒、就医前摘要生成。支持多家庭成员隔离、图片识别化验单。本地 SQLite 存储，保护隐私。**中文原生**。 | (临床决策支持)
- awesome-medical-ai-skills - mediwise-health-suite - health-suite?style=flat-square) | Family health management suite — health records, diet tracking, weight management, medication reminders, pre-visit summaries. Multi-member support with data isolation. Local SQLite storage. Bilingual CN/EN. | (Clinical Skills & Knowledge Bases)
README
# MediWise Health Suite - 家庭健康管理套件
[](https://opensource.org/licenses/MIT)
[](https://openclaw.ai)
[](https://www.python.org/downloads/)
[]()
**家庭健康管理助手**
从日常记录到健康追踪的完整解决方案
[快速开始](#快速开始) • [功能介绍](#功能介绍) • [安装方法](#安装方法) • [使用示例](#使用示例)
---
## 📋 简介
MediWise Health Suite 是一个为 OpenClaw AI 设计的家庭健康管理助手。帮助你记录和管理健康数据，追踪饮食和体重，为家庭健康保驾护航。
**核心价值**：平时能记、能查、能追踪；数据本地存储，保护隐私。默认数据库拆分为医疗与生活方式两库，便于隔离与权限控制。
## 🏗 项目架构图（技术设计）
```text
┌──────────────────────────────────────────────────────────────────────────────┐
│ 用户 / 聊天入口（OpenClaw） │
└───────────────────────────────┬──────────────────────────────────────────────┘
│ action + params + owner_id
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ Node.js 技能路由层（各 skill 的 index.js） │
│ - 路由 action -> script(args) │
│ - 统一 subprocess 调 python3 │
│ - 注入 MEDIWISE_OWNER_ID 做多用户隔离 │
└───────────────┬───────────────────────────────────────────────┬──────────────┘
│ │
▼ ▼
┌─────────────────────────────┐ ┌─────────────────────────────┐
│ Health Tracker (Python) │ │ 其他领域技能 (Python) │
│ - member / medical_record │ │ - diet-tracker │
│ - health_metric / reminder │ │ - weight-manager │
│ - visit_lifecycle / notes │ │ - wearable-sync │
│ - checkup/doctor report │ │ - health-monitor │
└───────────────┬─────────────┘ └───────────────┬─────────────┘
│ │
└──────────────────────┬────────────────────────┘
▼
┌─────────────────────────────────┐
│ shared 公共层 │
│ - path_setup.py │
│ - metric_utils.py │
└─────────────────┬───────────────┘
▼
┌────────────────────────────────────────────────────┐
│ 数据访问层：health_db.py（SQLite） │
│ Domain 路由：medical / lifestyle │
│ 事务、审计、owner 校验 │
└───────────────┬──────────────────────┬─────────────┘
│ │
▼ ▼
┌──────────────────────┐ ┌──────────────────────┐
│ medical.db │ │ lifestyle.db │
│ members/visits/... │ │ diet/weight/wearable │
│ health_metrics/... │ │ sync_log/... │
└──────────────────────┘ └──────────────────────┘
外部集成（可选）：
- Wearable Provider: gadgetbridge / apple_health / garmin / huawei / zepp / openwearables
- 视觉识别模型：图片/PDF 走外部模型（通过 setup 配置）
- Backend API 模式（可切换）
```
## 🗺 项目使用图
```text
[用户发起请求]
│
▼
[确定 owner_id]
│
▼
[先列成员并确认“为哪位成员操作”]
│
├──────────────┐
│ │
▼ ▼
[文本录入] [图片/PDF录入]
(就诊/症状/用药/指标) (外部视觉模型识别后写入)
│ │
└───────┬──────┘
▼
[落库到 SQLite]
│
├───────────────────────────────┐
│ │
▼ ▼
[饮食/体重管理] [可穿戴同步]
- food_lookup先查再记餐 - 拉取设备数据
- 热量/营养统计 - 去重写入 health_metrics
- 自动触发 monitor 检查
│ │
└───────────────┬───────────────┘
▼
[监测与提醒/告警]
│
▼
[健康简报 / 就医前摘要 / 导出]
```
---
## ✨ 功能状态
### ✅ 已实现功能
#### 🏥 健康档案管理
- 家庭成员信息管理
- 病程记录（门诊、住院、急诊）
- 用药追踪与提醒
- 日常健康指标（血压、血糖、心率等）
- 图片识别（化验单、体检报告、处方）
- 就医前摘要生成（文本/图片/PDF）
#### 🍎 饮食追踪
- 饮食记录与营养分析
- 热量计算
- 营养素统计
#### ⚖ 体重管理
- 体重记录与趋势分析
- BMI/BMR/TDEE 计算
- 目标设定与进度追踪
### ⚠ 部分实现功能（待完善）
#### 📊 智能监测与提醒（待完善）
- 多级健康告警
- 趋势分析与异常检测
- 用药提醒、复查提醒
#### ⌚ 可穿戴设备同步
- ✅ **佳明（Garmin）**：Garmin Connect 账号直连，支持心率、睡眠分期、HRV、身体电量（Body Battery）、压力、步数、血氧、活动记录
- ✅ **Apple Watch / iPhone**：Health App 导出 export.xml/zip，支持心率、步数、血氧、睡眠、体重、血糖、血压等
- ✅ **小米手环 / Amazfit**：Gadgetbridge 本地 SQLite 导出，支持心率、步数、血氧、睡眠
- 🔜 华为手表、高驰（COROS）等（开发中）
---
## 🚀 快速开始
### 安装
**方式 1：从 GitHub 安装（推荐）**
```bash
git clone https://github.com/JuneYaooo/mediwise-health-suite.git \
~/.openclaw/skills/mediwise-health-suite
```
**方式 2：通过 ClawdHub 安装**
```bash
# 从 GitHub 直接安装
clawdhub install JuneYaooo/mediwise-health-suite
# 或从市场安装（审核通过后）
clawdhub install mediwise-health-suite
```
### 基本使用
安装后，直接与 OpenClaw 对话即可：
```
"帮我添加一个家庭成员，叫张三，是我爸爸"
"帮我记录今天血压 130/85，心率 72"
"帮我看看最近的健康情况"
"记录今天吃了一碗米饭和一份青菜"
"记录今天体重 65kg"
"我准备去看医生，帮我整理一下最近的情况"
```
---
## 💡 使用示例
### 添加家庭成员
```
用户："帮我添加一个家庭成员，叫张三，是我爸爸，65岁"
助手：好的，我来帮您添加...
```
### 记录健康指标
```
用户："帮我记录今天血压 130/85，心率 72"
助手：已为您记录今天的健康指标...
```
### 饮食追踪
```
用户："记录今天吃了一碗米饭和一份青菜"
助手：已为您记录今天的饮食...
```
### 体重管理
```
用户："记录今天体重 65kg"
助手：已记录体重，您的 BMI 是...
```
### 就医前准备
```
用户："我准备去看医生，帮我整理一下最近的情况"
助手：好的，我先为您生成一份就医前摘要...
```
### 绑定佳明手表
```
用户："帮我绑定佳明手表"
助手：好的，请问您的手表型号是？（如 Fenix 7、Forerunner 965 等）
用户："Fenix 7"
助手：需要您的 Garmin Connect 登录邮箱和密码，凭据仅保存在本地...
用户："邮箱 xxx@gmail.com 密码 xxx"
助手：正在连接 Garmin Connect，验证成功！正在同步近 7 天数据...
已同步：心率 1240 条、睡眠 7 条、身体电量 2016 条、HRV 7 条
```
---
## 👪 家庭共用场景
### 一家人在同一个群里使用
在 QQ 群、飞书群等群聊中，多个家庭成员可以共同使用同一个健康助手。系统通过发送者身份（如 QQ 号）自动隔离数据，**每个人只能看到和管理自己添加的记录**。
```
张三: @健康 帮我记录今天血压 135/88
助手: 已为您记录血压 135/88。
李四: @健康 帮我看看最近的健康情况
助手: [只显示李四自己的数据，看不到张三的]
```
### 为家人代管健康
每个用户可以为自己和家人创建独立的健康档案：
```
张三: @健康 帮我添加一个家庭成员，叫张爸爸，是我爸爸，65岁
助手: 好的，已添加家庭成员"张爸爸"
张三: @健康 帮张爸爸记录今天血压 150/95
助手: 已为张爸爸记录血压 150/95。收缩压偏高，建议关注。
```
### 隔离机制
| 场景 | 隔离方式 |
|------|---------|
| 不同用户在同一群里 | 自动按发送者身份隔离，互不可见 |
| 同一用户的多个家庭成员 | 通过成员管理区分，用户可切换查看 |
| 不同群聊 | 可配置为同一或不同 Agent，数据独立 |
详细配置方法参见 [Agent 配置指南](docs/AGENT_SETUP.md)。
---
## 📦 包含的功能模块
| 模块 | 状态 | 功能 |
|------|------|------|
| 健康档案 | ✅ 已实现 | 成员管理、病程记录、用药追踪、健康指标 |
| 饮食追踪 | ✅ 已实现 | 饮食记录、营养分析、热量计算 |
| 体重管理 | ✅ 已实现 | 体重记录、BMI/BMR/TDEE 计算、趋势分析 |
| 健康监测 | ⚠ 待完善 | 智能告警、趋势分析 |
| 可穿戴设备 | ✅ 已实现 | 佳明/Apple Watch/Gadgetbridge 数据同步；HRV、身体电量、睡眠分期 |
---
## 🔒 数据隐私
- ✅ **默认本地存储**：所有数据存储在本地 SQLite 数据库（`medical.db` 与 `lifestyle.db`）
- ✅ **不上传云端**：默认配置下，不上传任何个人健康信息
- ✅ **可选功能**：后端 API、向量搜索等高级功能需用户主动配置启用
- ✅ **多租户隔离**：支持共享实例场景的数据隔离
- ✅ **发布安全**：数据库、附件、导出文件默认被 `.gitignore` / `.clawdhubignore` 排除
**重要**：项目包含可选的后端 API 和向量搜索功能，但默认关闭。所有云端功能需用户主动配置才会启用。
---
## 📋 系统要求
- Python 3.8+
- SQLite 3.x
- OpenClaw 2026.3.0+
- 操作系统：Linux / macOS / Windows
---
## 📄 许可证
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
---
## ⚠ 免责声明
本工具仅供健康信息记录和参考，不构成医疗建议。任何健康问题请咨询专业医生。
---
**⭐ 如果这个项目对你有帮助，请给个 Star！**
Made with ❤ by MediWise Team