94 lines
1.6 KiB
Markdown
94 lines
1.6 KiB
Markdown
# 云酒馆 - 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
|