LifeValue/HealthWallet.me
GitHub: LifeValue/HealthWallet.me
一款开源、患者控制的健康记录应用，通过设备端AI和离线优先架构安全聚合与管理医疗数据。
Stars: 62 | Forks: 2
# HealthWallet.me
### 您的病历记录。存于手机。由您掌控。
**一款内置设备端AI、开源且离线优先的健康管理器。**
通过 FHIR R4 连接超过 **52,000 家美国医疗服务提供商**。
使用本地 LLM 扫描纸质文件 —— **您的数据永不离开您的设备。**
[](https://apps.apple.com/app/healthwallet-me/id6748325588)
[](https://play.google.com/store/apps/details?id=com.techstackapps.healthwallet)
[](changelog.md) [](LICENSE.md) [](https://flutter.dev) [](https://hl7.org/fhir/R4/) []() [](https://github.com/lifevalue) [](https://www.youtube.com/@TechStackAppsCo) [](https://www.facebook.com/techstackapps/) [](https://www.linkedin.com/company/lifevalue/) [](https://x.com/techstackapps)
## 关于
**HealthWallet.me** 是一个**以患者为中心**、**社区驱动**的健康记录平台，可将来自多个医疗服务提供商的医疗数据整合到一个易于访问的应用中。
**以患者为中心** | **隐私至上** | **符合 FHIR 规范** | **支持离线使用**
**其独特之处在于：**
- **设备端 AI** —— 扫描纸质文件，内置的 LLM 在本地提取结构化 FHIR 资源。无云存储。无数据上传。无数据泄露。
- **52,000+ 家服务提供商** —— 通过自托管的 [FastenHealth](https://github.com/fastenhealth/fasten-onprem) 后端，使用 FHIR R4 API 连接美国医疗系统。
- **真正离线** —— 无需互联网即可完全访问您的所有记录。在您准备好时进行同步。
- **近距离分享** —— 通过类 AirDrop 的方式面对面分享记录。无需中间服务器。
- **国际患者摘要 (IPS)** —— 导出全球通用的健康摘要，用于旅行或紧急情况。
- **紧急钱包卡** —— 将您的关键健康信息添加到 Apple Wallet 或 Google Wallet。
## 功能
| 功能 | 描述 |
|---------|-------------|
| **AI 扫描** | 拍照或导入医疗文件；设备端的 LLM 将患者信息、就诊记录、用药、过敏史和实验室结果提取为结构化的 FHIR 记录 |
| **聚合** | 通过 FHIR R4 API 同步来自 52,000+ 家医院、诊所和实验室的记录 |
| **组织** | 在一个地方浏览所有记录 —— 病况、用药、免疫接种、实验室结果、临床笔记 |
| **分享** | **跨平台**近距离分享 —— 在 **iOS 和 Android** 设备间传输记录，无需互联网。接收方数据为**只读** —— 不存储，**禁止截屏** |
| **导出** | 生成 **国际患者摘要** PDF 或将紧急信息添加到 **Apple/Google Wallet** |
| **安全** | Face ID / 指纹锁，本地 SQLite 存储，无强制云端依赖 |
## 快速开始
### 安装应用
## 设备端 AI —— 工作原理
HealthWallet 使用 [llama.cpp](https://github.com/ggerganov/llama.cpp) 直接在您的手机上运行量化 LLM。无 API 调用，无云端处理 —— 模型在 iOS 上使用 Metal 加速本地运行，在 Android 上使用 CPU 推理。
### 可用模型
| 模型 | 大小 | 最佳用途 |
|-------|------|----------|
| **标准版** ([Qwen3-VL-2B](https://huggingface.co/Qwen/Qwen3-VL-2B-Instruct-GGUF)) | 约 1.1 GB | 快速、轻量，适用于大多数设备 |
| **高级版** ([MedGemma-4B](https://huggingface.co/SandLogicTechnologies/MedGemma-4B-IT-GGUF)) | 约 2.5 GB | 对于复杂的医疗文件具有更高的准确度 |
**深度扫描**（可选的视觉投影器）让 AI 可以直接从照片读取，而非 OCR 文本。一次性下载：约 445 MB（标准版）或约 851 MB（高级版）。
## 架构
基于 **Flutter/Dart** 采用**整洁架构**和基于功能的模块构建。
| 层 | 技术 |
|-------|-----------|
| **状态管理** | BLoC (flutter_bloc) |
| **依赖注入** | GetIt + Injectable |
| **导航** | AutoRoute (类型安全) |
| **本地数据库** | Drift (SQLite) |
| **网络** | Dio |
| **代码生成** | Freezed, JSON Serializable |
| **医疗标准** | FHIR R4 |
| **设备端 AI** | llama.cpp via llamadart |
| **本地化** | Flutter Intl (EN, ES, DE) |
## 开发设置
**前置条件：** Flutter 3.38+ (通过 [FVM](https://fvm.app/) 管理)
```
dart pub global activate fvm
fvm install && fvm use
flutter pub get
dart run build_runner build --delete-conflicting-outputs
flutter test
```
## 路线图
### 已完成的功能
- 基础健康记录管理
- 认证与安全
- 跨平台支持
- 文件导入与应用内查看
- 智能文件扫描（AI 读取并组织您的病历）
- 将 IPS（国际患者摘要）添加到 Google / Apple Wallet
- **跨平台**近距离分享 —— 可在 **iOS 和 Android** 设备间使用，接收方为只读，不保存数据，禁止截屏
### 进行中
- 支持备份同步和文档处理卸载的桌面应用
### 未来计划
- 响应式 UI
- 可穿戴设备与健康服务提供商集成
- AI 健康洞察
- AI 处方记录
- 家庭管理
- 二维码分享（SMART 健康卡）
## 贡献
我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解准则。
```
# Fork → Branch → Code → PR
git checkout -b feature/your-feature
# 进行更改
git push origin feature/your-feature
# 提交 Pull Request
```
## 赞助商
**HealthWallet.me** 是一个致力于改善医疗可及性和患者数据管理的开源项目。
对**企业赞助**或**合作机会**感兴趣？我们提供：
- **企业功能**和定制集成
- 面向医疗组织的**白标解决方案**
- 医疗科技领域的**战略合作伙伴关系**
- **优先支持**和专用资源
[**联系我们**](https://lifevalue.com/company/contact)
## 作者
- **Alex Szilagyi** — [@alexszilagyi](https://github.com/alexszilagyi)
- **Jason Kulatunga** — [@AnalogJ](https://github.com/AnalogJ)
## 许可证
[GPL-3.0](LICENSE.md) — © Copyright 2026, Life Value
### 您的病历记录。存于手机。由您掌控。
**一款内置设备端AI、开源且离线优先的健康管理器。**
通过 FHIR R4 连接超过 **52,000 家美国医疗服务提供商**。
使用本地 LLM 扫描纸质文件 —— **您的数据永不离开您的设备。**
[](https://apps.apple.com/app/healthwallet-me/id6748325588)
[](https://play.google.com/store/apps/details?id=com.techstackapps.healthwallet)
[](changelog.md) [](LICENSE.md) [](https://flutter.dev) [](https://hl7.org/fhir/R4/) []() [](https://github.com/lifevalue) [](https://www.youtube.com/@TechStackAppsCo) [](https://www.facebook.com/techstackapps/) [](https://www.linkedin.com/company/lifevalue/) [](https://x.com/techstackapps)
[](https://apps.apple.com/app/healthwallet-me/id6748325588)
[](https://play.google.com/store/apps/details?id=com.techstackapps.healthwallet)
### 设置您的自托管后端
后端 ([FastenHealth](https://github.com/fastenhealth/fasten-onprem)) 从医疗服务提供商处聚合医疗记录并同步到您的手机。
**前置条件：** [Docker](https://docs.docker.com/get-docker/)
```
curl https://raw.githubusercontent.com/fastenhealth/fasten-onprem/refs/heads/main/docker-compose-prod.yml -o docker-compose.yml && \
curl https://raw.githubusercontent.com/fastenhealth/fasten-onprem/refs/heads/main/set_env.sh -o set_env.sh && \
chmod +x ./set_env.sh && \
./set_env.sh && \
docker compose up -d
```
然后打开 `http://localhost:9090`，创建一个账户，即可准备就绪。
### 将应用连接到您的后端
1. 在您的 FastenHealth 仪表板中生成访问令牌
2. 使用 HealthWallet 扫描二维码
3. 您的记录将自动同步
设备要求
| 设备 | 内存 | 能力 | |--------|-----|------------| | **iPhone Pro/Pro Max** | 6 GB+ | 完整扫描（两种模型） | | **iPhone 13/14/15** | 4-6 GB | 仅标准版模型 | | **Android** | 12 GB+ | 完整扫描（两种模型） | | **Android** | 10-11 GB | 仅标准版模型 |项目结构
``` lib/ ├── app/ # App configuration and initialization ├── core/ # Shared infrastructure │ ├── config/ # App configuration and constants │ ├── data/ # Local database (Drift/SQLite) │ ├── di/ # Dependency injection setup │ ├── l10n/ # Localization │ ├── navigation/ # Router and route definitions │ ├── services/ # Shared services │ ├── theme/ # Colors, text styles, spacing │ ├── utils/ # Utility functions │ └── widgets/ # Reusable UI components ├── features/ │ ├── dashboard/ # Main tab navigation │ ├── home/ # Health overview with reorderable grid │ ├── records/ # Health records management + IPS export │ ├── scan/ # AI document scanning (llama.cpp) │ ├── sync/ # QR-based backend sync │ ├── share_records/ # Proximity sharing (AirDrop-style) │ ├── wallet_pass/ # Apple/Google Wallet emergency card │ ├── user/ # Profile & patient management │ ├── onboarding/ # First-launch flow │ └── notifications/ # In-app notifications └── gen/ # Generated code ```分支策略
| 分支 | 用途 | CI/CD | |--------|---------|-------| | `master` | 生产环境 | 部署到 App Store + Play Store | | `develop` | 预发布环境 | 部署到内部测试渠道 | | `feature/*` | 新功能 | 分析 + 测试 | | `fix/*` | 缺陷修复 | 分析 + 测试 | | `release/*` | 版本稳定化 | 完整测试套件 | | `hotfix/*` | 紧急修复 | 分析 + 测试 |