# Rock-Andrelia

**Repository Path**: KFCheems/Rock-Andrelia

## Basic Information

- **Project Name**: Rock-Andrelia
- **Description**: 我的第一个ai项目
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 Rock Andrelia - AI 对话应用

[English Documentation](./README.md)

一个基于 React 和 Express.js 构建的美观且功能丰富的 AI 对话应用。具有类似 ChatGPT 的界面，支持对话历史管理，通过 LM Studio 连接本地大语言模型。

![React](https://img.shields.io/badge/React-19.1.0-61DAFB?logo=react)
![Express](https://img.shields.io/badge/Express-5.1.0-000000?logo=express)
![SQLite](https://img.shields.io/badge/SQLite-3-003B57?logo=sqlite)
![License](https://img.shields.io/badge/License-MIT-green.svg)

## ✨ 功能特性

- 💬 **实时对话** - 流畅的 AI 对话体验
- 📝 **Markdown 支持** - 富文本渲染，包括代码块、列表等
- 💾 **持久化存储** - 使用 SQLite 数据库存储对话历史
- 🗂️ **会话管理** - 创建、切换和删除对话
- 📋 **一键复制** - 快速复制 AI 回复内容
- 🎨 **现代化界面** - 简洁美观的响应式设计
- 🔄 **自动滚动** - 自动滚动到最新消息
- ⏰ **时间戳显示** - 显示消息发送时间

## 🚀 快速开始

### 环境要求

- [Node.js](https://nodejs.org/) (v14 或更高版本)
- [LM Studio](https://lmstudio.ai/) (用于本地大语言模型推理)

### 安装步骤

1. **克隆仓库**
   ```bash
   git clone https://github.com/yourusername/Rock-Andrelia.git
   cd Rock-Andrelia
   ```

2. **安装前端依赖**
   ```bash
   npm install
   ```

3. **安装后端依赖**
   ```bash
   cd server
   npm install
   cd ..
   ```

### 运行应用

1. **启动 LM Studio**
   - 打开 LM Studio
   - 加载你喜欢的 AI 模型
   - 在端口 `1234` 启动本地服务器

2. **启动后端服务**
   ```bash
   cd server
   node server.js
   ```
   服务将运行在 `http://localhost:5000`

3. **启动前端应用**
   ```bash
   npm start
   ```
   应用将在 `http://localhost:3000` 打开

## 📁 项目结构

```
Rock-Andrelia/
├── public/                 # 静态文件
├── server/                 # 后端服务
│   ├── server.js          # Express 服务器
│   ├── package.json       # 后端依赖
│   └── chat_sessions.db   # SQLite 数据库（自动创建）
├── src/                    # 前端源码
│   ├── App.js             # 主应用组件
│   ├── App.css            # 样式文件
│   └── index.js           # 入口文件
├── package.json           # 前端依赖
└── Readme_cn.md           # 本文件
```

## 🔌 API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/conversations` | GET | 获取所有对话 |
| `/api/conversations/:id` | GET | 获取指定对话的消息 |
| `/api/conversations/:id` | DELETE | 删除对话 |
| `/api/chat` | POST | 发送消息并获取 AI 回复 |

## 🛠️ 技术栈

### 前端
- **React 19** - UI 库
- **React Markdown** - Markdown 渲染
- **CSS3** - 样式，使用自定义属性

### 后端
- **Express.js** - Web 框架
- **SQLite3** - 数据库
- **Axios** - HTTP 客户端
- **CORS** - 跨域资源共享

### AI 集成
- **LM Studio** - 本地大语言模型推理服务

## 📝 可用脚本

### 前端
```bash
npm start      # 启动开发服务器
npm run build  # 构建生产版本
npm test       # 运行测试
npm run eject  # 从 Create React App 弹出
```

## 🎨 自定义配置

### 修改 AI 角色
编辑 `server/server.js` 中的系统提示词：
```javascript
const systemPrompt = "You are a helpful and friendly conversational AI...";
```

### 修改界面样式
编辑 `src/App.css` 文件来自定义外观。

## 🤝 贡献指南

欢迎贡献代码！请随时提交 Pull Request。

1. Fork 本仓库
2. 创建你的功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 开源协议

本项目采用 MIT 协议开源。

## 🙏 致谢

- 使用 [Create React App](https://github.com/facebook/create-react-app) 构建
- 由 [LM Studio](https://lmstudio.ai/) 提供 AI 能力支持

## 📧 联系方式

如有任何问题或建议，欢迎提交 Issue。

---

⭐ 如果这个项目对你有帮助，请给它点个 Star！