# 云酒馆 - SillyTavern Cloud

现代化的 AI 角色对话平台，采用前后端分离架构。

## 项目结构

```
st-ui/
├── web-app/          # 前端应用 (React + TypeScript + Tailwind)
├── server/           # 后端服务 (Node.js + Express)
├── docs/             # 项目文档
├── .claude/          # Claude AI 配置
└── README.md         # 项目说明
```

## 快速开始

### 前端开发

```bash
cd web-app
npm install
npm run dev
```

前端将运行在 `http://localhost:5174`

### 后端开发

```bash
cd server
npm install
cp .env.example .env  # 配置环境变量
npm run dev
```

后端将运行在 `http://localhost:3000`

## 功能特性

### 前端功能
- 🎨 现代化 Glassmorphism 设计
- 🌙 深色主题 (OLED 优化)
- 💬 实时聊天界面
- 👤 角色卡管理（支持 PNG/JSON 导入导出）
- ⚙️ 预设管理（支持多种格式）
- 🔐 用户认证系统
- 📱 响应式设计

### 后端功能
- 🔒 JWT 身份认证
- 📦 角色卡存储和管理
- 💾 对话历史持久化
- 🤖 AI API 集成
- 📤 文件上传处理

## 技术栈

### 前端
- React 18
- TypeScript
- Tailwind CSS
- Vite
- React Router
- Lucide Icons

### 后端
- Node.js
- Express
- MongoDB
- JWT
- Multer

## 开发指南

详细的开发文档请查看 [docs](./docs/) 目录。

## 设计系统

项目采用统一的设计系统，详见 [design-system](./docs/design-system/)。

- 主色调: #7C3AED (紫色)
- 次要色: #A78BFA (淡紫色)
- 强调色: #F97316 (橙色)
- 字体: Inter

## 贡献

欢迎提交 Issue 和 Pull Request。

## 许可证

MIT