# SillyTavern Repalice - 快速启动指南

## 🚀 快速开始

### 前置要求

- 安装 [Docker](https://www.docker.com/products/docker-desktop/)
- 安装 [Docker Compose](https://docs.docker.com/compose/install/)

### 启动应用

```bash
# 克隆仓库
git clone <repository-url>
cd sillytavern-repalice

# 配置环境变量（可选）
cp .env.example .env
# 编辑 .env 文件，填入您的 API 密钥

# 启动应用
docker-compose up -d

# 查看日志
docker-compose logs -f
```

### 访问应用

- **前端**: http://localhost:23337
- **后端**: http://localhost:3000

### 停止应用

```bash
docker-compose down
```

## 📝 配置说明

### 环境变量

编辑 `.env` 文件：

```env
# LLM API 配置
OPENAI_API_KEY=your-api-key-here
ANTHROPIC_API_KEY=your-api-key-here

# 其他配置
NODE_ENV=production
PORT=3000
DATA_DIR=./data
```

### 数据持久化

所有数据存储在 `./data` 目录，包括：
- 角色卡
- 聊天记录
- 世界书
- 预设配置

## 🔧 常见问题

### Q: 端口被占用怎么办？

修改 `docker-compose.yml` 中的端口映射：

```yaml
ports:
  - "23338:80"  # 将前端改为 23338 端口
  - "8081:3000"  # 将后端改为 8081 端口
```

### Q: 如何更新到最新版本？

```bash
docker-compose pull
docker-compose up -d
```

### Q: 如何查看日志？

```bash
# 查看所有日志
docker-compose logs -f

# 只查看前端日志
docker-compose logs -f frontend

# 只查看后端日志
docker-compose logs -f backend
```

### Q: 如何备份数据？

```bash
# 备份 data 目录
tar -czf backup.tar.gz ./data

# 恢复数据
tar -xzf backup.tar.gz
```

## 📞 获取帮助

如有问题，请提交 Issue 或联系开发者。

---

**祝您使用愉快！** 🎉