chenpei d0dc94e36d feat: 将弹幕功能替换为AI聊天助手

新功能:
- 创建AI聊天助手组件（AIChatWidget）
- 支持文字+图片多模态对话
- 集成Gemini AI API
- 支持图片编辑和内容生成
- 实时对话历史管理
- 优雅的UI设计，支持黑夜模式

技术实现:
- 后端API代理Gemini API（/api/ai-chat）
- 支持最多5张图片上传
- 流式响应处理
- 对话历史管理
- Base64图片处理

配置:
- 在.env中添加Gemini API配置
- GEMINI_API_KEY
- GEMINI_API_BASE_URL
- GEMINI_MODEL

替换原弹幕功能，提供更强大的AI助手体验！

2025-10-27 17:45:37 +08:00

5.0 KiB

Executable File

Raw Blame History

环境配置与部署指南

本文档提供图片背景处理工具的环境配置和部署步骤。

开发环境配置

系统要求

Node.js v12.0.0 或更高版本
MongoDB v4.0.0 或更高版本
MinIO 对象存储服务
Git

步骤一：克隆代码库

git clone https://github.com/your-username/xiaogongju.git
cd xiaogongju

步骤二：安装依赖

npm install

步骤三：配置环境变量

复制环境变量示例文件：

cp .env.example .env

编辑 .env 文件，配置以下必要参数：

# 服务器配置
PORT=3000
NODE_ENV=development

# 用户认证相关配置
JWT_SECRET=your_jwt_secret_key_here

# 数据库配置
MONGODB_URI=mongodb://localhost:27017/xiaogongju

# MinIO配置
MINIO_ENDPOINT=localhost
MINIO_PORT=9000
MINIO_USE_SSL=false
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET_NAME=xiaogongju

# API密钥
REMOVE_BG_API_KEY=your_remove_bg_api_key
GENERATE_BG_API_KEY=your_generate_bg_api_key
REPAINT_API_KEY=your_repaint_api_key

步骤四：设置 MongoDB

如果您尚未安装 MongoDB，可以使用我们提供的脚本进行安装：

bash setup-mongodb.sh

或者手动安装 MongoDB 并创建数据库：

# MacOS (使用Homebrew)
brew tap mongodb/brew
brew install mongodb-community
brew services start mongodb-community

# Ubuntu
sudo apt update
sudo apt install -y mongodb
sudo systemctl start mongodb

步骤五：初始化数据库

运行初始化脚本创建默认管理员账户：

node init-db.js

步骤六：启动开发服务器

npm run dev

服务器将在 http://localhost:3000 启动。

生产环境部署

方法一：使用 PM2 和 Nginx

步骤一：准备服务器

确保服务器已安装以下组件：

Node.js v12.0.0+
MongoDB v4.0.0+
MinIO 服务
Nginx
PM2

步骤二：部署代码

克隆代码库到服务器：

git clone https://github.com/your-username/xiaogongju.git
cd xiaogongju

安装依赖：

npm install --production

配置环境变量：

cp .env.example .env
# 编辑.env文件，设置生产环境配置

初始化数据库：

node init-db.js

步骤三：使用 PM2 管理应用

安装 PM2（如果尚未安装）：

npm install -g pm2

启动应用：

pm2 start ecosystem.config.js --env production

设置开机自启：

pm2 startup
pm2 save

步骤四：配置 Nginx

复制 Nginx 配置文件：

sudo cp config/nginx.conf /etc/nginx/sites-available/xiaogongju

创建符号链接到已启用站点：

sudo ln -s /etc/nginx/sites-available/xiaogongju /etc/nginx/sites-enabled/

测试配置并重启 Nginx：

sudo nginx -t
sudo systemctl restart nginx

方法二：使用 Docker (可选)

步骤一：准备 Docker 环境

确保服务器已安装 Docker 和 Docker Compose。

步骤二：构建 Docker 镜像

docker build -t xiaogongju .

步骤三：启动容器

docker-compose up -d

MinIO 配置

步骤一：安装 MinIO

# MacOS
brew install minio/stable/minio

# Ubuntu
wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
sudo mv minio /usr/local/bin/

步骤二：启动 MinIO 服务

minio server /path/to/data

步骤三：创建存储桶

访问 MinIO 控制台（默认地址: http://localhost:9000）
使用默认凭据登录（minioadmin/minioadmin）
创建名为 xiaogongju 的存储桶

外部 API 配置

Remove.bg API

注册 Remove.bg 账户
获取 API 密钥
将 API 密钥填入 .env 文件的 REMOVE_BG_API_KEY 字段

阿里云智能 API

注册阿里云账户
开通智能API服务
获取 API 密钥并填入相应的环境变量

Tripo3D API

注册 Tripo3D 账户
获取 API 密钥
将 API 密钥填入 .env 文件的 TRIPO3D_API_KEY 字段

故障排除

数据库连接问题

如果遇到数据库连接错误，请检查：

MongoDB 服务是否正在运行
.env 文件中的 MONGODB_URI 是否正确
网络连接是否畅通

运行数据库连接测试脚本：

node test-db-connection.js

MinIO 存储问题

如果遇到文件上传或访问错误，请检查：

MinIO 服务是否正在运行
.env 文件中的 MinIO 配置是否正确
存储桶权限是否配置正确

API 调用失败

如果外部 API 调用失败，请检查：

API 密钥是否有效
账户余额或配额是否足够
网络连接是否畅通
请求参数是否正确

性能优化建议

增加服务器内存，特别是处理大型图片时
配置 Nginx 缓存静态资源
使用 CDN 加速图片传输
考虑使用集群部署，增加系统吞吐量
定期清理临时文件和过期数据
对 MongoDB 添加适当的索引优化查询性能

5.0 KiB Executable File Raw Blame History Unescape Escape