KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh-plugin #dsh #codex #developer-tools #ai-agents #claude-code #windows #deepseek-harness #desktop-app #typescript #rust #ai-agent

AI-Powered-Psychological-Helper

★ 31 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AI-Powered Psychological Helper 🧠💙

[![Android](https://img.shields.io/badge/Platform-Android-green.svg?style=flat)](https://www.android.com/)
[![Java](https://img.shields.io/badge/Language-Java-orange.svg)](https://www.java.com/)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/Vandbs/AI-Powered-Psychological-Helper/main/LICENSE)

[English](README_EN.md) | 简体中文

> 一款基于Android的校园心理健康咨询应用，融合AI智能咨询与人工预约服务，为学生提供便捷、专业的心理支持。

---

## 📖 项目简介

**AI-Powered Psychological Helper** 是一款专为校园环境设计的心理健康移动应用。它将传统的人工心理咨询与现代AI技术相结合，为学生提供多样化的心理健康服务。用户可以选择预约真人咨询师进行深度咨询，也可以随时与AI心理咨询师进行实时对话，获得即时的情绪支持和建议。

### ✨ 核心特性

#### 👥 双重咨询模式
- **人工咨询师预约**：支持浏览专业咨询师信息、查看可约时间、在线预约咨询服务
- **AI智能咨询**：集成OpenAI GPT模型，提供7×24小时实时AI心理咨询服务
- **专业化AI角色**：提供情绪疏导、学业压力管理、人际关系等多个专业方向的AI咨询师

#### 💬 实时聊天功能
- 支持与人工咨询师和AI咨询师的即时通讯
- 完整的聊天历史记录保存
- 流畅的对话体验和友好的用户界面

#### 👤 用户管理系统
- 用户注册与登录
- 双角色系统：普通用户 & 咨询师
- 个人信息管理（头像、用户名、密码修改）
- 预约记录查看与管理

#### 📝 反馈评价系统
- 用户可对咨询师进行反馈评价
- 咨询师可查看收到的反馈
- 用户可查看自己的历史反馈

#### 🎨 优质用户体验
- Material Design风格界面
- 底部导航栏快速切换
- ViewPager2轮播横幅
- RecyclerView高效列表展示

---

## 🛠️ 技术栈

### 开发环境
- **IDE**: Android Studio
- **编程语言**: Java (JDK 11)
- **最低SDK版本**: Android 8.0 (API 26)
- **目标SDK版本**: Android 14 (API 35)
- **构建工具**: Gradle

### 核心技术
| 技术 | 说明 |
|------|------|
| **Android SDK** | 原生Android应用开发 |
| **SQLite** | 本地数据库存储（用户、预约、消息、反馈） |
| **OkHttp3** | HTTP网络请求，与OpenAI API通信 |
| **Material Components** | Google Material Design组件库 |
| **ViewPager2** | 轮播图和页面切换 |
| **RecyclerView** | 高效的列表展示 |
| **BottomNavigationView** | 底部导航栏 |
| **OpenAI API** | GPT-4o模型提供AI心理咨询能力 |

### 主要依赖
```gradle
// AndroidX 核心库
implementation 'androidx.appcompat:appcompat'
implementation 'com.google.android.material:material'
implementation 'androidx.constraintlayout:constraintlayout'

// 网络请求
implementation 'com.squareup.okhttp3:okhttp:4.9.3'

// JSON解析
implementation 'org.json:json:20231013'
```

---

## 📱 功能模块

### 1️⃣ 用户端功能
- 📋 **首页**：查看咨询师列表、轮播横幅、快速预约
- 💬 **消息**：查看聊天列表、与咨询师/AI对话
- 👤 **我的**：个人信息管理、预约记录、反馈记录

### 2️⃣ 咨询师端功能
- 📊 **预约管理**：查看并处理用户预约请求
- 💬 **消息管理**：与用户进行咨询对话
- ⚙️ **信息编辑**：修改个人资料、专业领域、可约时间
- 📝 **反馈查看**：查看用户的评价反馈

### 3️⃣ AI咨询师
- 🤖 **智能对话**：基于GPT-4o的智能心理咨询
- 🎯 **专业化角色**：
  - `counselor1`：情绪疏导专家
  - `counselor2`：学业压力管理专家
  - `counselor3`：人际关系与社交支持专家
- 🔄 **上下文记忆**：保持对话连贯性

---

## 🚀 安装与运行

### 前置要求
- Android Studio Arctic Fox (2020.3.1) 或更高版本
- JDK 11
- Android SDK (API 26 - API 35)
- Gradle 8.0+

### 安装步骤

1. **克隆项目**
```bash
git clone https://github.com/Vandbs/AI-Powered-Psychological-Helper.git
cd AI-Powered-Psychological-Helper

```

2. **导入Android Studio**
   - 打开Android Studio
   - 选择 `File -> Open`
   - 选择项目根目录

3. **配置API密钥**（可选）
   
   如需使用AI咨询功能，请在 `OpenAIHelper.java` 中配置您的OpenAI API密钥：
   
   ```java
   // app/src/main/java/com/aaa/psychological/helpers/OpenAIHelper.java
   public static String OPENAI_API_KEY = "your-api-key-here";
   public static String OPENAI_API_BASE_URL = "https://api.openai.com/v1/chat/completions";
   public static String OPENAI_MODEL = "gpt-4o";
   ```

4. **同步Gradle**
   - Android Studio会自动同步依赖
   - 或手动点击 `Sync Project with Gradle Files`

5. **运行应用**
   - 连接Android设备或启动模拟器
   - 点击 `Run` 按钮或按 `Shift + F10`

---

## 📂 项目结构

```
app/src/main/java/com/aaa/psychological/
├── controllers/           # Activity控制器
│   ├── LoginActivity.java           # 登录界面
│   ├── RegisterActivity.java        # 注册界面
│   ├── NormalUserHomeActivity.java  # 普通用户主页
│   ├── CounselorHomeActivity.java   # 咨询师主页
│   ├── ChatActivity.java            # 聊天界面
│   ├── CounselorDetailActivity.java # 咨询师详情
│   ├── AppointmentRecordsActivity.java # 预约记录
│   ├── FeedbackActivity.java        # 反馈提交
│   ├── ViewFeedbacksActivity.java   # 查看反馈
│   └── ...
├── models/                # 数据模型
│   ├── Counselor.java     # 咨询师模型
│   ├── Appointment.java   # 预约模型
│   ├── Message.java       # 消息模型
│   ├── FeedbackItem.java  # 反馈模型
│   └── ...
├── helpers/               # 辅助工具类
│   ├── DatabaseHelper.java  # SQLite数据库管理
│   └── OpenAIHelper.java    # OpenAI API封装
└── adapters/              # RecyclerView适配器
    ├── CounselorAdapter.java
    ├── ChatListAdapter.java
    └── ...
```

---

## 💾 数据库设计

应用使用SQLite本地数据库，包含以下主要表：

| 表名 | 说明 |
|------|------|
| `users` | 用户信息（用户名、密码、角色、头像等） |
| `appointments` | 预约记录（用户、咨询师、状态、时间） |
| `messages` | 聊天消息记录 |
| `feedbacks` | 反馈评价记录 |

---

## 🎯 使用场景

### 学生端
1. 注册/登录账号
2. 浏览可用咨询师信息
3. 预约心仪的咨询师或选择AI咨询
4. 进行聊天咨询
5. 提交反馈评价

### 咨询师端
1. 登录咨询师账号
2. 查看预约请求并确认
3. 与学生进行咨询对话
4. 查看学生反馈
5. 编辑个人信息

---

## 🔐 安全说明

> ⚠️ **重要提示**：
> - 本项目的API密钥已被注释，开发者需自行申请OpenAI API密钥
> - 请勿将API密钥提交到公开仓库
> - 建议使用环境变量或配置文件管理敏感信息
> - 生产环境建议将API调用转移到后端服务器

---

## 👨‍💻 开发团队

**2025学年移动应用开发小组**

---

## 📄 开源协议

本项目采用 [MIT License](LICENSE) 开源协议。

<div align="center">
  <p>❤️ 用心守护每一位学生的心理健康 ❤️</p>
  <p>Made with ❤️ by Mobile App Development Team</p>
</div>

AI-Powered-Psychological-Helper

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README