# time-travel

**Repository Path**: wang-yipan/time-travel

## Basic Information

- **Project Name**: time-travel
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-19
- **Last Updated**: 2025-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Time Album - 时光相册

一个现代化的登录注册应用，集成了 AI 视频生成功能，支持使用阿里云通义万象服务生成动态视频。

## 功能特点

- 用户登录/注册系统，支持邮箱和手机号注册
- 弹出式验证码验证
- AI 视频生成功能，支持图片上传和描述输入
- 集成阿里云通义万象 API，生成高质量动态视频
- 视频播放、下载和删除功能
- 响应式设计，支持中英文切换

## 安装和运行

### 前置要求

- Node.js (v14 或更高版本)
- npm 或 yarn

### 安装依赖

```bash
npm install
```

### 运行应用

#### 开发模式（推荐）

使用 concurrently 同时运行前端和后端服务器：

```bash
npm run dev
```

这将同时启动：

- React 前端服务器 (http://localhost:3000)
- Express 后端代理服务器 (http://localhost:3001)

**重要**: 必须同时运行前端和后端服务器，API 请求才能正常工作。后端服务器处理阿里云 API 调用，解决 CORS 问题。

#### Python 后端模式（推荐用于阿里云 DashScope）

由于阿里云 DashScope 主要支持 Python SDK，我们提供了 Python 后端服务器：

```bash
npm run dev:python
```

这将同时启动：

- React 前端服务器 (http://localhost:3000)
- Python Flask 后端代理服务器 (http://localhost:3002)

Python 后端使用官方 DashScope API，提供更稳定的视频生成服务。

#### 单独运行 Python 后端

如果你希望单独运行 Python 后端：

1. 安装 Python 依赖（如果尚未安装）：

```bash
pip install -r requirements.txt
```

2. 启动 Python 后端服务器：

```bash
npm run server:python
```

或者使用自动启动脚本（会自动检查并安装依赖）：

```bash
python3 start-python-backend.py
```

3. 在另一个终端窗口启动前端：

```bash
npm start
```

#### 分别运行 Node.js 后端

如果你希望分别运行前端和 Node.js 后端：

1. 启动 Node.js 后端服务器（在一个终端窗口中）：

```bash
npm run server
```

2. 启动前端（在另一个终端窗口中）：

```bash
npm start
```

**注意**:

- Node.js 后端服务器运行在 3001 端口
- Python 后端服务器运行在 3002 端口
- 前端会自动尝试连接两个端口，优先使用 3001 端口

#### 故障排除

如果遇到 "ERR_CONNECTION_REFUSED" 错误：

1. 确保后端服务器正在运行（Node.js 在 3001 端口或 Python 在 3002 端口）
2. 检查是否有其他应用占用了 3001 或 3002 端口
3. 尝试直接运行后端服务器：
   - Node.js: `npm run server:direct`
   - Python: `python3 start-python-backend.py`
4. 查看后端服务器日志，确认是否有错误信息

如果 Node.js 后端服务器无法启动，请确保已安装所有依赖：

```bash
npm install
```

如果 Python 后端服务器无法启动，请确保已安装 Python 依赖：

```bash
pip install -r requirements.txt
```

#### 后端服务器选择建议

- **Node.js 后端**：适用于一般 API 集成，易于开发和调试
- **Python 后端**：推荐用于阿里云 DashScope API，提供更好的兼容性和稳定性
- **自动切换**：前端会自动尝试连接两个后端，如果第一个失败会尝试第二个

### 生产环境构建

```bash
npm run build
```

## AI 视频生成配置

1. 在应用中导航到"AI 视频"页面
2. 点击配置按钮，设置阿里云通义万象的 API 密钥
3. 上传图片并输入描述
4. 点击"生成视频"按钮

## API 密钥获取

1. 访问 [阿里云 DashScope 控制台](https://dashscope.console.aliyun.com/)
2. 创建 API 密钥
3. 在应用配置中输入密钥

## 项目结构

```
├── public/                 # 静态资源
├── src/                   # React源代码
│   ├── components/        # React组件
│   ├── services/          # API服务
│   ├── utils/             # 工具函数
│   └── i18n/              # 国际化文件
├── server.js              # Express后端服务器
├── backend.py             # Python Flask后端服务器
├── requirements.txt       # Python依赖
├── start-python-backend.py # Python后端启动脚本
└── package.json           # 项目配置
```

## 技术栈

- React 18
- React Router
- Express.js
- 阿里云 DashScope API
- i18next (国际化)

## 注意事项

- 后端代理服务器用于解决 CORS 问题，确保阿里云 API 调用正常
- API 密钥仅存储在本地浏览器中，不会上传到服务器
- 视频生成可能需要一些时间，请耐心等待
- 推荐使用 Python 后端以获得更好的阿里云 API 支持
- 前端会自动尝试连接两个后端端口（3001 和 3002），优先使用 3001 端口

## 许可证

MIT