# 健康助手

**Repository Path**: CCTears/healthAI

## Basic Information

- **Project Name**: 健康助手
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HealthAI

健康日记与医疗初诊应用，支持 **Windows、Android、macOS、Linux** 等多平台（Flutter 实现）。包含用户系统、日记记录、身体报告与 AI 引导式初诊对话。

## 项目结构

- **flutter_app/**：Flutter 客户端（多平台：Windows、Android、macOS、Linux；鸿蒙需单独适配）
- **backend_java/**：Java 后端（Spring Boot，用户认证 + 大模型 API 代理）
- **backend/**：Node.js 后端（可选，与 backend_java 二选一）

## 功能概览

1. **用户系统**：注册、登录、登出、修改密码
2. **日记**：按时间倒序分页列表、按时间搜索、写日记、查看/编辑详情
3. **身体报告**：按时间倒序分页列表、按时间搜索、查看报告详情
4. **医疗初诊**：与 AI 多轮对话描述症状，生成初诊报告并保存到报告列表

## 后端运行（推荐：Java）

```bash
cd backend_java
# 设置环境变量（可选）：JWT_SECRET、LLM_API_KEY、LLM_BASE_URL、PORT
mvn spring-boot:run
```

默认端口 3000。配置说明见 `backend_java/README.md`。

若使用 Node.js 后端：

```bash
cd backend
npm install && cp .env.example .env
# 编辑 .env 后
npm start
```

## Flutter 多平台运行

### 环境

- 安装 [Flutter SDK](https://flutter.dev/docs/get-started/install)，并启用目标平台：
  - Windows: `flutter config --enable-windows-desktop`
  - macOS: `flutter config --enable-macos-desktop`
  - Android: 默认支持

### 配置后端地址

在 `flutter_app/lib/config/api_config.dart` 中修改 `kBaseUrl`：

- 本机调试（Windows/macOS 桌面）：`http://localhost:3000/`
- Android 模拟器访问本机：`http://10.0.2.2:3000/`
- 真机/其他设备访问本机：`http://<本机局域网IP>:3000/`

### 生成各平台工程并运行

若 `flutter_app` 内还没有平台目录，先在该目录下执行：

```bash
cd flutter_app
flutter create . --platforms=windows,android,macos,linux
```

然后按需运行：

```bash
cd flutter_app
flutter pub get
flutter run -d windows    # Windows
flutter run -d macos      # macOS
flutter run -d linux      # Linux
flutter run               # 选择已连接的 Android 设备/模拟器
```

打包发布示例：

```bash
flutter build windows
flutter build apk         # Android APK
flutter build appbundle   # Android App Bundle
flutter build macos
```

## 鸿蒙（HarmonyOS）

当前 Flutter 官方尚未正式支持鸿蒙。若需上架鸿蒙，可关注 [OpenHarmony 对 Flutter 的适配](https://gitee.com/openharmony-sig/flutter_flutter) 或使用厂商提供的 Flutter 鸿蒙渠道，再在工程中增加鸿蒙平台与构建配置。

## 技术栈

- **Flutter**：Dart 3、Material 3、Provider、Dio、sqflite、shared_preferences
- **Backend**：Java 17、Spring Boot 3、Spring Data JPA、H2、JWT（jjwt）、bcrypt；或 Node.js（见 `backend/`）

## 免责声明

本应用中的“初诊报告”仅为 AI 辅助分析，仅供参考，不能替代线下就医与诊断。