st-react/README.md

云酒馆 - SillyTavern Cloud

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

项目结构

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

快速开始

前端开发

cd web-app
npm install
npm run dev

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

后端开发

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 目录。

设计系统

项目采用统一的设计系统，详见 design-system。

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

贡献

欢迎提交 Issue 和 Pull Request。

许可证

MIT