# mediwise-health-suite

Adopt this skill: https://proskills.md/skills/other/juneyaooo-mediwise-health-suite

Page: https://proskills.md/skills/other/juneyaooo-mediwise-health-suite
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 14609
upstream: https://github.com/juneyaooo/mediwise-health-suite/blob/HEAD/SKILL.md

````text
---
name: mediwise-health-suite
description: "Private local health assistant for Skills-compatible AI agents. Use for personal or family health records, medical files, metrics, medications, reminders, diet, weight, exercise, sleep, static health cards, pre-visit summaries, backups, and Apple Health or Gadgetbridge imports. Local SQLite storage is the default; optional cloud features require explicit setup."
---

# MediWise Health Suite

面向支持 Skills 的 AI Agent 的个人本地健康助手：记录、整理和追踪本人及家人的健康数据。支持 Hermes、OpenClaw、Claude Code、Codex、WorkBuddy，以及其他能够加载 Skills、访问本地文件并执行脚本的 Agent 工具。

对用户统一使用产品全名 **MediWise Health Suite**，首次提及后可简称 **MediWise**。`mediwise-health-tracker`、`diet-tracker` 等仅是内部模块 ID，不得作为产品别名。普通健康数据生成“健康卡片”，家庭概览称“家庭健康卡片”；体重观察结果称“体重真相卡”。普通文字查询结果称为“文字健康摘要”。

## 核心能力

### ✅ 1. 健康档案 (`mediwise-health-tracker`)
- 成员信息管理：姓名、关系、性别、出生日期、血型
- 基础病史：既往史、过敏史、联系方式、紧急联系人
- 病程记录：门诊、住院、急诊、症状、诊断、检验、影像
- 用药信息：当前在用药、历史用药、停药原因
- 日常指标：血压、血糖、心率、血氧、体温、体重等
- 查询能力：文字健康摘要、时间线、在用药、全家概览
- **就医前摘要**：自动整理病情、既往史、在用药，生成文本/图片/PDF

### 健康卡片：记录概览与体重真相卡
- 个人卡片汇总已记录的指标、饮食运动、睡眠、医疗记录和用药；家庭卡片只展示每位成员的当前状态、在用药、服药或复查提醒和已记录的注意事项，不含时间轴
- 体重真相卡把同日多次测量折叠为中位数，用 Theil–Sen 稳健趋势区分单日波动与长期方向，并说明最新一次称重与趋势相差多少；记录不足以支撑趋势时只说明线索仍在积累
- 只陈述有记录日、次数、最新日期和数字方向；空白日期不补零，不把同期变化写成原因
- 记录卡片是本地自用产物，会显示成员姓名和真实日期；体重真相卡默认脱敏，可对外分享
- 卡片导出为自包含 HTML 和 PNG：记录卡片按内容自适应高度（宽度默认 1040，可传 `--width`），体重真相卡固定 1080×1440

调用边界：用户要近期整体健康概览或家庭概览时，走 `mediwise-health-tracker` 的 `generate-health-card`（兼容动作 `generate-report`）；用户点名体重趋势或体重真相卡时，走 `weight-manager` 的 `weight-truth` 和 `generate-weight-card`。

### ✅ 2. 饮食追踪 (diet-tracker)
- 每餐记录与食物条目管理
- 营养分析：热量、蛋白质、脂肪、碳水、膳食纤维
- 每日/每周营养摘要
- 热量趋势分析

### ✅ 3. 体重管理 (weight-manager)
- 目标设定：减重/增重/维持
- 体重翻译器：区分单日波动与稳健长期趋势
- 体重真相卡：区分单日波动与稳健长期方向，说明最新称重与趋势的偏差，生成默认脱敏的本地 HTML 和 1080×1440 PNG
- BMI/BMR/TDEE 计算
- 运动记录与消耗追踪
- 身体围度记录
- 热量收支分析
- 目标时间估算

### ✅ 4. 智能健康监测 (health-monitor) - 按需检查
- 多级阈值告警（info/warning/urgent/emergency）
- 趋势分析与异常检测
- 本地提醒记录：用药、复查、指标测量；到点主动通知依赖当前 Agent 的调度能力

### ✅ 5. 可穿戴数据导入 (wearable-sync)
- Apple Health `export.zip` / `export.xml`：已验证本地导入与去重
- Gadgetbridge SQLite：已验证本地导入与去重，实际指标取决于设备和表结构
- Garmin Connect：实验性，不作为普通用户默认流程
- Huawei、Zepp 云账号、OpenWearables：暂不可用

### ✅ 6. 睡眠追踪 (sleep-tracker)
- 睡眠时长与深睡、浅睡、REM、清醒分期记录
- 每日分析、周趋势与历史查询

## 快速开始

### 安装

不要求普通用户手动安装或运行代码。让具备终端权限的 AI 助手读取下面的安装文档并完成依赖、路径、个人本地模式与验收检查：

<https://github.com/JuneYaooo/mediwise-health-suite>

安装 Agent 进入仓库后必须先读取 `docs/INSTALL_AGENT.md`。

当前公开流程只支持个人本地使用：一个用户可以管理自己和多位家人的档案，不部署到群聊或多人共享服务。不同 Agent 按各自的 Skills 加载机制安装；OpenClaw 的完整适配说明见 `docs/AGENT_SETUP.md`。

### 基本使用

1. **添加家庭成员**
   ```
   "帮我添加一个家庭成员，叫张三，是我爸爸"
   ```

2. **记录健康指标**
   ```
   "帮我记录今天血压 130/85，心率 72"
   ```

3. **生成健康卡片**
   ```
   "帮我生成最近 7 天的健康卡片"
   ```

4. **饮食记录**
   ```
   "帮我记录今天早餐：牛奶一杯、面包两片、鸡蛋一个"
   ```

5. **体重管理**
   ```
   "帮我设定一个减重目标，从 70kg 减到 65kg"
   ```

6. **生成健康卡片或体重真相卡**
   ```
   "帮我生成最近 7 天的健康卡片"
   "生成一张体重真相卡，看看最近的波动是不是已经改了方向"
   ```

7. **就医前准备**
   ```
   "我准备去看医生，帮我整理一下最近的情况"
   ```

## 系统要求

- **Python**: 3.8+
- **Node.js**: 18+
- **SQLite**: 3.x
- **操作系统**: Linux / macOS / Windows
- **Agent**: 能够加载 Skills、访问本地文件并执行脚本
- **OpenClaw（如使用）**: 2026.3.0+
- **Chrome / Chromium**: 生成本地 PNG 健康卡片、体重真相卡或 PDF 时需要；HTML 和纯文字记录、查询不需要

## 数据隐私

- **默认本地存储**：所有数据存储在本地 SQLite 数据库，不上传云端
- **可选后端模式**：支持可选的后端 API 模式（需用户主动配置，默认关闭）
- **可选向量搜索**：支持智能查询功能（本地模型优先，可选 API，默认关闭）
- **个人本地使用**：一个用户管理自己和多位家人的独立档案

**重要**：所有云端功能均为可选，需用户主动配置启用。默认配置下，所有数据仅存储在本地。

## 可选环境变量

这些变量由具备本机权限的安装或配置 Agent 管理，不要求普通用户运行命令。公开流程固定使用个人本地模式；详细配置模板见根目录 `.env.example`。

### 多模态视觉模型（可选，用于复杂版面与图表理解）

当前 Agent 能直接读取用户上传的图片或 PDF 时，直接提取并让用户确认，不需要设置任何 `MEDIWISE_VISION_*` 变量。只有当前 Agent 无法读取附件时，才把下列视觉配置作为可选 fallback；本地 PaddleOCR 也可作为普通图片和扫描 PDF 的 fallback。

| 变量名 | 说明 | 推荐值 |
|--------|------|--------|
| `MEDIWISE_VISION_API_KEY` | 视觉模型 API Key（设置即自动启用） | 见下方推荐方案 |
| `MEDIWISE_VISION_PROVIDER` | 提供商名称 | `siliconflow` / `openai` / `ollama` |
| `MEDIWISE_VISION_MODEL` | 模型名称 | 见下方推荐方案 |
| `MEDIWISE_VISION_BASE_URL` | API 地址（OpenAI 兼容接口） | 见下方推荐方案 |

**推荐方案：**

| 方案 | 适用场景 | PROVIDER | MODEL | BASE_URL |
|------|---------|----------|-------|----------|
| 硅基流动 Qwen3.6（**国内首选**） | 国内部署；配置时确认模型支持图片输入，[注册链接](https://cloud.siliconflow.cn/i/MOlLXTYM) | `siliconflow` | `Qwen/Qwen3.6-35B-A3B` | `https://api.siliconflow.cn/v1` |
| 硅基流动 GLM-4.5V | 国内视觉理解备选；配置时确认服务商仍提供该模型 | `siliconflow` | `zai-org/GLM-4.5V` | `https://api.siliconflow.cn/v1` |
| Google Gemini 3.1 Pro（**海外首选**） | 多模态效果强 | `openai` | `gemini-3.1-pro-preview` | `https://generativelanguage.googleapis.com/v1beta/openai` |
| OpenAI GPT-4o | 通用，效果稳定 | `openai` | `gpt-4o` | `https://api.openai.com/v1` |
| 阶跃星辰 Step-1V | 国内备选 | `openai` | `step-1v-32k` | `https://api.stepfun.com/v1` |
| 本地 Ollama | 完全离线，模型标签以本机模型库为准 | `ollama` | `qwen3-vl:8b` | `http://localhost:11434/v1` |

配置 fallback 前必须取得用户明确同意。配置 Agent 应使用项目的 setup 能力保存到 `config.json`，并通过安全的本地凭据输入机制接收 API Key；不得让用户把 Key 发送到聊天中，也不得要求普通用户复制配置命令。不得因附件读取失败而静默启用新的云端服务。

### 纯文本 LLM（可选）

用于结构化提取、快速录入解析。**不设置时自动复用视觉模型**，无需单独配置。

| 变量名 | 说明 |
|--------|------|
| `MEDIWISE_LLM_API_KEY` | 文本模型 API Key |
| `MEDIWISE_LLM_PROVIDER` | 提供商 |
| `MEDIWISE_LLM_MODEL` | 模型名称 |
| `MEDIWISE_LLM_BASE_URL` | API 地址 |

### 其他可选变量

| 变量名 | 用途 | 默认行为 |
|--------|------|----------|
| `MEDIWISE_SINGLE_USER` | 个人本地 Agent 运行模式，由安装 Agent 在实际运行 MediWise 的环境中配置 | 公开安装流程设为 `1` |
| `USDA_API_KEY` | USDA FoodData Central API Key，用于国际食材查询。免费注册：https://api.data.gov/signup/ | 未设置且未安装获授权的本地数据包时，食物查询会明确返回数据源不可用 |
| `OPENFOODFACTS_ENABLED` | 启用 Open Food Facts 包装/品牌食品搜索（ODbL 1.0） | 默认关闭；设为 `1` 才启用 |
| `OPENFOODFACTS_SEARCH_URL` | Open Food Facts 官方 Search-a-licious 查询地址 | `https://search.openfoodfacts.org/search` |
| `MEDIWISE_FOOD_ONLINE_ENABLED` | 在线食物查询总开关 | 未设置时仅使用已显式配置的来源；设为 `0` 强制全部关闭 |
| `MEDIWISE_DATA_DIR` | 覆盖 SQLite 数据库存储目录 | 默认 OS 用户数据目录（Linux: `~/.local/share/mediwise`） |
| `MEDIWISE_MEDICAL_DB_PATH` | 覆盖医疗数据库（medical.db）路径 | 存储在 `MEDIWISE_DATA_DIR` 下 |
| `MEDIWISE_LIFESTYLE_DB_PATH` | 覆盖生活方式数据库（lifestyle.db）路径 | 存储在 `MEDIWISE_DATA_DIR` 下 |

## 安全说明

### 运行时环境

本 skill 同时使用 **Python 3.8+**（业务脚本）和 **Node.js 18+**（action 路由层），两者均需已安装。

### 个人本地使用

- 当前公开版本只面向个人/家庭单机使用，所有成员档案由同一个本地用户管理。
- 安装 Agent 负责启用并验证个人模式，普通用户不需要配置身份参数。
- 不把同一数据目录部署到群聊机器人或多人共享服务。

### 第三方凭据处理

- **凭据绝不经过聊天传递**：API Key、密码等敏感信息只能通过客户端提供的安全本地输入机制进入配置；如果当前客户端没有这种能力，就停止配置。
- **Garmin Connect 密码**：Garmin 当前为实验性接入，不要求普通用户运行认证命令，也不允许在聊天中粘贴密码。
- **视觉/LLM API Key**：配置 Agent 优先写入操作系统 keyring；keyring 不可用时才以 `0600` 权限保存到本机 `config.json` 并输出警告。
- **所有凭据**均保存在本机，不上传到任何远程服务器。

### 可选外部访问（默认关闭）

默认完全离线，以下网络请求仅在用户明确要求、且配置 Agent 完成对应设置后才会发生：

| 显式启用的能力 | 外部主机 | 发送内容 |
|---|---|---|
| 视觉模型 | `api.siliconflow.cn` / Google / OpenAI 等 | 完整图片/PDF 页面内容（base64）+ 提示词；原文件中可能包含姓名、身份证号等 PII |
| USDA | `api.nal.usda.gov` | 食物名称搜索词 |
| Open Food Facts | `search.openfoodfacts.org` | 食物名称搜索词、语言和分页参数；不发送成员、餐次或健康数据 |
| 远程向量搜索 | 用户选择的 Embedding 端点 | 检索文本片段 |
| 后端 API | 用户自配置的端点 | **完整健康记录** — 仅在自托管可信端点使用，不建议指向第三方服务 |

> **set-backend 风险说明**：启用后端 API 后，所有健康记录（病历、指标、用药等）将发送至配置的端点。请仅在完全信任该端点的情况下启用，且优先使用本地或自托管服务。

### 备份文件

`setup.py backup` 会将所有数据库打包为 `.tar.gz`，**包含完整的健康档案**，请妥善保管，不要分享给未授权人员。

新备份使用一致性 SQLite 快照和 SHA-256 manifest，归档权限为 `0600`；恢复前会校验成员白名单、哈希和数据库完整性。输出路径不得与任何源数据库/配置重合；恢复会把归档中的数据库路径规范化到当前数据目录。同一数据目录不允许两个恢复进程并发执行；文件替换、Schema 升级或升级后的完整性检查失败时，会恢复原有配置、数据库及 SQLite sidecar。恢复期间仍须停止服务、定时同步和其他 SQLite 客户端。旧版无 manifest 的官方备份仍可恢复，但无法进行哈希校验。manifest 未签名，能发现损坏或未同步修改，不能抵御攻击者同时重写数据和 manifest。

## 技术架构

- **数据库**: SQLite（`medical.db` 与 `lifestyle.db` 分域存储，兼容旧版 `health.db`）
- **脚本语言**: Python 3.8+
- **Skill 框架**: 支持 Skills 的 AI Agent；OpenClaw 另有 action 路由适配
- **模块化设计**: 6 个 skills（健康档案、饮食、体重、睡眠、监测、可穿戴）
- **可选功能**: 后端 API、向量搜索（默认关闭）

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 免责声明

本工具只提供健康信息的记录、整理、查询、展示、趋势汇总和提醒，不提供诊断、治疗建议、用药建议、营养治疗建议、临床判断或其他医疗指导。只能转述档案中已有的诊断、处方、报告标记和用户设定的阈值；不得根据数据自行给出处理方案。如需医学判断，请咨询专业医疗人员。

---

**关键词**: 健康管理、医疗记录、家庭健康、健康卡片、体重真相卡、饮食追踪、体重管理、health management, medical records, family health, health cards, weight truth card, diet tracking, weight management
````

## File: README.md
upstream: https://github.com/juneyaooo/mediwise-health-suite/blob/HEAD/README.md

````text
# MediWise Health Suite

中文 | [English](README_EN.md)

<div align="center">

**面向支持 Skills 的 AI Agent 的个人本地健康助手**

拍照、发文件或直接聊天，就能记录饮食运动、整理医疗资料、追踪健康设备数据，并把本人和家人的健康信息留在自己的设备上。

[![Version](https://img.shields.io/badge/version-v2.0.9-2f6feb.svg)](https://github.com/JuneYaooo/mediwise-health-suite/releases/tag/v2.0.9)
[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-2f6feb.svg)](SKILL.md)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-compatible-7c3aed.svg)](https://openclaw.ai)
[![GitHub stars](https://img.shields.io/github/stars/JuneYaooo/mediwise-health-suite?style=flat)](https://github.com/JuneYaooo/mediwise-health-suite/stargazers)

[一张图看懂](#一张图看懂-mediwise) · [常用场景](#三个常用场景) · [健康卡片](#健康卡片) · [5 分钟上手](#5-分钟上手) · [功能全览](#功能全览) · [隐私与安全](#隐私与安全) · [文档中心](docs/README.md)

</div>

---

MediWise Health Suite（简称 **MediWise**）可以运行在 **Hermes、OpenClaw、Claude Code、Codex、WorkBuddy**，以及其他能够加载 Skills、访问本地文件并执行脚本的 AI Agent 工具中。它适合长期管理本人和家人的健康信息，默认数据保存在本地，换设备时也可以备份和迁移。

不同工具的 Skill 安装位置和聊天入口可能不同。OpenClaw（龙虾）目前另有完整的自动安装、飞书或微信私聊接入与验收说明；使用其他 Agent 时，按该工具自己的 Skills 加载方式安装即可。

> MediWise 只提供健康信息的记录、整理、查询、展示和提醒，不提供诊断、治疗建议、用药建议、营养治疗建议、临床判断或其他医疗指导。

## 一张图看懂 MediWise

![从生活片段到本地健康记录：MediWise 使用流程与产品边界](docs/images/architecture.svg)

你只需要通过聊天、照片、PDF 或设备文件提供信息。MediWise 会按成员整理成本地健康档案，并在需要时帮你查询记录、查看健康卡片和管理用药或复查待办；当前 Agent 已配置调度能力时，还可以到点主动通知。

## 三个常用场景

### 1. 拍照记录饮食，聊天记录运动

吃饭前拍一张照片，MediWise 可以识别食物、询问分量，并整理成一餐记录；运动后发一句话或上传运动截图，就能记录项目、时长、距离和消耗。连续使用后，可以查看每日汇总、周趋势和体重目标进度。

你可以直接说：

```text
[上传午餐照片] 帮我识别这顿饭，确认后记录热量和营养。
记录今天运动：快走 45 分钟，3.8 公里。
[上传运动截图] 把这次运动记录到我的档案。
帮我看看最近 7 天的饮食、运动和体重变化。
```

<p align="center">
  <img src="docs/images/meal-photo-example.jpg" width="420" alt="在聊天中拍照识别一餐食物并给出热量区间">
</p>

<p align="center"><sub>拍照识别食物的实际对话示例。图片识别和热量结果用于辅助记录，保存前应确认食物、分量和包装信息。</sub></p>

食物识别可以使用当前 Agent 已有的图片理解能力；热量和营养数值必须来自可核验的数据源。仓库默认不捆绑食物数据库，也不会用模型记忆直接估算后写库。未配置 USDA、Open Food Facts 或已授权的本地数据包时，需要用户提供包装营养标签，或由配置 Agent 在取得同意后启用数据源。

营养值查不到时，**餐次照常记录，但不会写 0**——吃了什么才是记录的核心，丢掉这条等于没记。此时营养字段存为 `NULL`（未知），条目 `note` 标注 `[未解析营养]`，响应返回 `nutrition_status: "unresolved"`，并通过 `action_required` 明确要求 Agent 向用户索取营养标签或说明数据源配置方式。`0` 只表示「确为零」（如水、黑咖啡）。汇总口径同步：未解析的日期作为「未解析」单独报告，不计入任何平均值，因此不会凭空生成一份热量收支。

### 2. 上传医疗资料，建立本地档案和用药提醒

把体检报告、化验单、处方或就诊资料拍照上传，MediWise 会提取关键信息，请你确认后再写入本地档案。**每个成员各一份档案**：本人和其他人都可以分别建档，说清姓名就记到对应的人名下，互不混合。之后可以随时查历史记录、管理在用药、设置服药或复查提醒，并在就医前快速整理近期情况。

提醒默认保存为本地待办记录。当前 Agent 支持并已经配置定时任务时，可以进一步实现到点主动通知；MediWise 本身不包含后台守护进程、短信或电话推送。

你可以直接说：

```text
[上传体检报告] 提取关键指标，先让我确认，再记到我的档案。
我从今天开始服用这个药，每天早晚各一次，提醒我按时服药。
下周三提醒我复查血常规。
我准备去看医生，帮我整理近期症状、指标和在用药。
```

#### 案例走查：本地病例管理

> 教学模拟病例：医院「青竹市第一虚构医院」，患者「熊猫」（男，89 岁），7 张图片每张都盖有「教学模拟病例｜非医疗凭证」章。下面的每个数字都来自这 7 张图，图片就是原图。
>
> 这里示范的是一位患者。多个人按同一套规则分别存储：每个人一份独立档案，互不混合，流程完全一样。

##### 输入：7 张照片

两次住院的单据。点开任意一张看大图。

<table>
  <tr>
    <td width="25%" align="center"><a href="docs/images/case-01-admission-20260908.jpg"><img src="docs/images/case-01-admission-20260908.jpg" alt="住院病历（入院记录）2026-09-08"></a></td>
    <td width="25%" align="center"><a href="docs/images/case-02-lab-20260908.jpg"><img src="docs/images/case-02-lab-20260908.jpg" alt="检验报告单 2026-09-08"></a></td>
    <td width="25%" align="center"><a href="docs/images/case-03-ct-20260909.jpg"><img src="docs/images/case-03-ct-20260909.jpg" alt="医学影像检查报告单 胸部CT平扫 2026-09-09"></a></td>
    <td width="25%" align="center"><a href="docs/images/case-04-readmission-20261020.jpg"><img src="docs/images/case-04-readmission-20261020.jpg" alt="住院病历（再次入院记录）2026-10-20"></a></td>
  </tr>
  <tr>
    <td align="center"><sub>① 入院记录 · 2026-09-08<br>诊断 3 项</sub></td>
    <td align="center"><sub>② 检验报告单 · 2026-09-08<br>13 项，6 项带 H/L</sub></td>
    <td align="center"><sub>③ 胸部 CT 平扫 · 2026-09-09<br>影像诊断 4 条</sub></td>
    <td align="center"><sub>④ 再次入院记录 · 2026-10-20<br>诊断 4 项</sub></td>
  </tr>
  <tr>
    <td width="25%" align="center"><a href="docs/images/case-05-lab-20261020.jpg"><img src="docs/images/case-05-lab-20261020.jpg" alt="检验报告单 2026-10-20"></a></td>
    <td width="25%" align="center"><a href="docs/images/case-06-carotid-ultrasound-20261021.jpg"><img src="docs/images/case-06-carotid-ultrasound-20261021.jpg" alt="超声检查报告单 双侧颈动脉 2026-10-21"></a></td>
    <td width="25%" align="center"><a href="docs/images/case-07-discharge-20261023.jpg"><img src="docs/images/case-07-discharge-20261023.jpg" alt="出院记录及随访建议 2026-10-23"></a></td>
    <td width="25%"></td>
  </tr>
  <tr>
    <td align="center"><sub>⑤ 检验报告单 · 2026-10-20<br>11 项，5 项带 H/L</sub></td>
    <td align="center"><sub>⑥ 双侧颈动脉彩超 · 2026-10-21<br>粥样硬化伴斑块形成</sub></td>
    <td align="center"><sub>⑦ 出院记录 · 2026-10-23<br>出院诊断 4 项、随访建议 5 条</sub></td>
    <td></td>
  </tr>
</table>

##### 怎么做：一句话交给 AI

**你说：**

```text
帮我建一份档案：熊猫，男，89 岁。把这 7 张资料记进去，记之前先让我看一遍。
```

**AI 先把读到的东西列清楚再问你要不要写**：两次住院的时间、诊断、两次入院查体的血压血糖心率体温、两份化验单各有几项带 H/L、两份影像的结论，以及出院记录里的随访建议。你回一句「确认，写进去吧」才落库。

原件上没有的，它不补：资料里没有药名和剂量，就不编用药记录；「呼吸 18 次/分」不在卡片支持的指标类型里，就留在查体原文，不塞进指标表；两次住院对同一条诊断的写法不同（极高危 / 很高危），各自按原文保存。

##### 结果一：档案里有什么

| 记录 | 内容 |
|---|---|
| 就诊记录 | 2 次住院；第 7 页的出院记录回写到第二次住院，出院诊断 4 项成为这次就诊的诊断 |
| 症状 | 6 条（头晕、口渴、多饮、乏力、夜尿增多，头晕两次住院各一条） |
| 检验报告 | 2 份共 24 项，其中 11 项带原件印出的 H/L |
| 影像报告 | 2 份：胸部 CT、颈动脉彩超 |
| 指标读数 | 10 条：两次入院查体各 4 条 + 出院记录的血压和空腹血糖 |
| 原始照片 | 7 张，逐张挂到对应记录上，从记录能点回原图 |
| 用药 | 0 条（资料里没有药名和剂量，不编） |
| 提醒 | 1 条：2026-11-06 09:00 复诊，来自出院记录的随访建议 |

##### 结果二：一张健康卡片

**你说「帮我生成熊猫最近 90 天的健康卡片」**，得到一张卡片，同时导出一份同内容的 HTML。

<p align="center">
  <img src="docs/images/case-health-card.png" width="720" alt="教学病例熊猫的个人健康卡片：病情速览、个人健康时间轴、指标趋势">
</p>

卡片上每一块都来自上面的记录：诊断和异常项来自两次就诊与两份化验单的 H/L，趋势图来自那 10 条指标读数，时间轴是 2 次住院 + 2 份化验 + 2 份影像。图上的异常只有两个来源——原件印出的 H/L，和你自己配置的阈值；不画参考范围带，也不按数值给点上色。

*这张卡片生成于 2026-09-13，而病例的第二次住院在 2026-10：卡片不会因为记录日期比生成当天晚就丢掉它，所以表头日期和图上「2026-09-08 至 2026-10-23」会同时出现。真实使用时记录日期不会晚于当天。*

##### 结果三：接着追问

同样一份档案，直接问就行：

**你：** 熊猫现在有哪些诊断？哪些化验项被报告标了异常？

> **AI：** 最近一次是 2026-10-20 至 10-23 的住院，出院诊断 4 项：原发性高血压（3级，很高危）、2型糖尿病、血脂异常、双侧颈动脉粥样硬化伴斑块；目前没有在用药记录。两份化验单里原件印了 H/L 的共 11 项（6 项 + 5 项），集中在血糖、糖化血红蛋白、肾功能、血脂和尿蛋白。这些标记是化验单上本来就有的，我只照抄。

**你：** 两次住院之间血压和血糖怎么变的？

> **AI：** 各有 3 条记录：血压 178/96（09-08）→ 166/92（10-20）→ 148/84（10-23），血糖 13.8（09-08 随机）→ 11.2（10-20 随机）→ 7.6（10-23 空腹）。血糖最后一条是空腹、前两条是随机，场景不一样。我只列数值、日期和场景，好不好要问医生。

**你：** 下次复诊是什么时候？

> **AI：** 2026-11-06 09:00 有一次复诊提醒：「复诊：老年医学科或内分泌科门诊」，来自出院记录的随访建议原文。

**你：** 熊猫这一年都发生了什么？

> **AI：** 6 个事件：两次住院（各带诊断与入院查体数据）、两份检验、两份影像（胸部 CT 的慢性支气管改变与纤维灶、颈动脉粥样硬化伴斑块）。这是提取出来的关键事件和结果，完整原文（现病史、查体、处理计划、随访建议）也都在档案里，随时能调出来。

**每条回答都只转写档案里已有的字段。** 异常只有两个来源：原件印出的 H/L，和你自己配置的阈值；除此之外不做医学判断。

### 3. 接入健康设备，查看趋势和健康提醒

把 Apple Health 或 Gadgetbridge 导出的数据交给 MediWise，就能把步数、心率、睡眠、体重等记录汇总到同一份档案中，用自然语言查看趋势，并为需要关注的指标设置提醒。

你可以直接说：

```text
[上传 Apple 健康导出包] 导入我的档案，并告诉我新增了哪些指标。
帮我看最近 30 天的静息心率和睡眠趋势。
如果我的血压超过设定范围，请在健康摘要里提醒我。
帮我生成最近 7 天的健康卡片。
```

目前 Apple Health 和 Gadgetbridge 文件导入已经验证可用；Garmin Connect 仍为实验性接入。其他设备的最新状态和导出方法见 [可穿戴数据导入指南](docs/WEARABLES.md)。

## 健康卡片

**把已有记录整理成一段看得懂、愿意保存的近况。**

MediWise 生成两种卡片：

- **个人 / 家庭健康卡片**：从已记录的指标、饮食运动、睡眠、医疗记录和用药整理出近期概览。个人卡片把有两条以上记录的指标画成趋势图，只有一条记录的指标保留一行最新值。家庭卡片只展示每位成员的当前状态、在用药、服药或复查提醒，以及已记录的注意事项，不展示时间轴。
- **体重真相卡**：把同一天的多次测量折叠为中位数，用 Theil–Sen 稳健趋势区分“今天的波动”和“一段时间的方向”，并说明最新一次称重与稳健趋势相差多少。记录不足以支撑趋势时，卡片只说明线索仍在积累，不会给出一条凭空的拟合线。

两种卡片都只复述实际记录、空白和同期变化，不给出医学判断，也不把相关性写成原因：先陈述这一段记录呈现的形状，再列出天数、次数和最新日期。

记录卡片是给你自己看的本地产物，会显示成员姓名和真实日期，分享出去前请自行确认内容。体重真相卡默认脱敏：隐藏姓名、绝对体重、目标体重和精确日期，可以直接分享。记录卡片导出为自包含 HTML 和高度自适应的 PNG，体重真相卡固定 1080×1440，渲染需要本机有 Chrome/Chromium。

```text
帮我生成最近 7 天的健康卡片。
生成一张体重真相卡，看看最近的波动是不是已经改了方向。
生成一张可以分享的体重真相卡，只保留趋势和波动。
```

卡片长什么样、每一块读的是哪些记录，见上面的[案例走查：本地病例管理](#案例走查本地病例管理)。

## 5 分钟上手

### 1. 让 AI 完成安装

把下面这段话发给 Hermes、OpenClaw、Claude Code、Codex、WorkBuddy，或其他具备本机终端与网络权限的 AI 助手：

```text
请帮我安装并配置 MediWise Health Suite：
https://github.com/JuneYaooo/mediwise-health-suite
完成后帮我检查 Skill 是否已正确加载并可以正常使用。
```

普通用户不需要手动运行脚本或修改配置。安装助手会完成环境检查、安装和基础验收。

### 2. 创建第一个档案

安装并让当前 Agen
````
