# AI工具集

**Repository Path**: crawfordxx/AI-minitools

## Basic Information

- **Project Name**: AI工具集
- **Description**: 本项目为AI小工具集
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-08
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Tools Service

<div align="center">
  <h2>🤖 AI Tools Service - 统一AI服务平台</h2>
  <p>集成作文批改和视频生成的一站式AI服务解决方案</p>
</div>

## 📋 项目简介

AI Tools Service 是一个集成了两个强大AI服务的统一平台：

1. **📝 作文批改服务** - 基于阿里云通义千问的智能作文批改和OCR识别
2. **📹 视频生成服务** - 基于MoneyPrinterTurbo的自动化视频创作工具

## ✨ 主要特性

### 作文批改服务
- 🖼️ **图片OCR识别** - 支持多种格式的图片文字识别
- 📄 **文档解析** - 支持PDF、Word、TXT文档解析
- ✍️ **智能批改** - AI驱动的作文评分和建议
- 📊 **批量处理** - 支持批量作文批改
- 🌐 **实时反馈** - Server-Sent Events流式响应

### 视频生成服务
- 🎬 **自动化创作** - 从主题到完整视频的7阶段流水线
- 🤖 **多LLM支持** - 集成12+种AI模型提供商
- 🎭 **多语言支持** - 中文、英文等多种语言
- 🎵 **丰富素材** - 无版权视频素材和背景音乐
- 🎨 **自定义样式** - 字幕、字体、颜色等可配置

## 🚀 快速开始

### 方式一：Docker部署（推荐）

```bash
# 克隆项目
git clone <repository-url>
cd AI-tools-service

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入你的API密钥

# 一键部署
./scripts/deploy.sh
```

部署完成后，访问：
- 🏠 **主页**: http://localhost
- 📝 **作文批改**: http://essay-correction.localhost
- 📹 **视频生成**: http://video-webui.localhost
- 🔧 **API文档**: http://video-api.localhost/docs

### 方式二：开发模式

```bash
# 安装依赖
./scripts/dev.sh install

# 启动所有服务
./scripts/dev.sh start

# 或单独启动服务
./scripts/dev.sh essay          # 仅启动作文批改服务
./scripts/dev.sh video-api      # 仅启动视频生成API
./scripts/dev.sh video-webui    # 仅启动视频生成Web界面

systemctl restart ai-tools-essay.service ai-tools-video-api.service ai-tools-video-webui.service
```

## 📁 项目结构

```
AI-tools-service/
├── 📁 services/                  # 服务目录
│   ├── 📁 essay-correction/       # 作文批改服务
│   │   ├── 🐍 app.py              # Flask应用入口
│   │   ├── 📄 essay_correction_service.py
│   │   ├── 📄 ocr_service.py
│   │   ├── 📄 document_parser.py
│   │   ├── 📄 tutor_service.py
│   │   └── 🐳 Dockerfile
│   └── 📁 video-generation/       # 视频生成服务
│       ├── 🐍 main.py             # FastAPI入口
│       ├── 📁 webui/              # Streamlit界面
│       ├── 📁 app/                # 应用核心
│       ├── 📁 services/           # 业务逻辑
│       ├── 📁 resource/           # 静态资源
│       ├── 📄 config.example.toml
│       ├── 🐳 Dockerfile
│       └── 🐳 Dockerfile.webui
├── 📁 config/                     # 统一配置
│   ├── 📄 settings.py             # 配置管理
│   └── 📄 __init__.py
├── 📁 scripts/                    # 脚本工具
│   ├── 📄 deploy.sh               # 部署脚本
│   └── 📄 dev.sh                  # 开发脚本
├── 📁 nginx/                      # Nginx配置
│   ├── 📄 nginx.conf
│   └── 📁 conf.d/
├── 📄 requirements.txt            # Python依赖
├── 📄 docker-compose.yml          # Docker编排
├── 📄 .env.example               # 环境变量模板
└── 📄 README.md
```

## ⚙️ 配置说明

### 环境变量配置

复制 `.env.example` 到 `.env` 并配置以下关键参数：

```bash
# 作文批改服务配置
ACCESS_KEY_ID=your_alibaba_access_key          # 阿里云AccessKey
ACCESS_KEY_SECRET=your_alibaba_secret          # 阿里云Secret
DASHSCOPE_API_KEY=your_dashscope_key           # 通义千问API Key

# 视频生成服务配置
LLM_PROVIDER=openai                           # LLM提供商
OPENAI_API_KEY=sk-your-openai-key             # OpenAI API Key
PEXELS_API_KEYS=["your_pexels_key"]           # Pexels API Keys
SUBTITLE_PROVIDER=edge                        # 字幕生成方式
```

### 服务端口配置

- 作文批改服务: `5002`
- 视频生成API: `8080`
- 视频生成Web界面: `8501`
- Nginx代理: `80`

## 🔧 开发指南

### 本地开发环境

1. **环境要求**
   - Python 3.11+
   - FFmpeg
   - ImageMagick

2. **启动开发服务**
   ```bash
   # 开发模式启动所有服务
   ./scripts/dev.sh start

   # 查看服务状态
   ./scripts/dev.sh status

   # 停止所有服务
   ./scripts/dev.sh stop
   ```

3. **日志查看**
   ```bash
   # Docker部署日志
   docker-compose logs -f

   # 开发模式日志
   # 各服务日志输出到终端
   ```

### API文档

#### 作文批改API
- **健康检查**: `GET /health`
- **图片OCR**: `POST /api/ocr`
- **文档解析**: `POST /api/parse-document`
- **作文批改**: `POST /api/correct-essay`
- **批量批改**: `POST /api/correct-essay-batch`

#### 视频生成API
- **视频生成**: `POST /api/v1/video/generate`
- **任务查询**: `GET /api/v1/tasks/{task_id}`
- **任务列表**: `GET /api/v1/tasks`

详细API文档请访问：http://video-api.localhost/docs

## 🐳 Docker部署详解

### 服务组件

- **essay-correction**: 作文批改服务容器
- **video-generation-api**: 视频生成API容器
- **video-generation-webui**: 视频生成Web界面容器
- **redis**: Redis缓存容器
- **nginx**: 反向代理容器

### 常用Docker命令

```bash
# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f [service_name]

# 停止服务
docker-compose down

# 重新构建镜像
docker-compose build

# 重启特定服务
docker-compose restart [service_name]
```

## 🔒 安全注意事项

1. **API密钥管理**
   - 不要将API密钥提交到版本控制
   - 使用环境变量或密钥管理服务
   - 定期轮换API密钥

2. **网络安全**
   - 生产环境中使用HTTPS
   - 配置防火墙规则
   - 限制API访问频率

3. **文件安全**
   - 验证上传文件类型和大小
   - 定期清理临时文件
   - 设置适当的文件权限

## 🚨 故障排查

### 常见问题

1. **服务启动失败**
   ```bash
   # 检查端口占用
   netstat -tlnp | grep :5002

   # 检查Docker状态
   docker-compose ps

   # 查看错误日志
   docker-compose logs [service_name]
   ```

2. **API调用失败**
   ```bash
   # 检查API密钥配置
   cat .env

   # 测试网络连接
   curl http://localhost:5002/health
   ```

3. **视频生成失败**
   ```bash
   # 检查FFmpeg安装
   ffmpeg -version

   # 检查磁盘空间
   df -h

   # 检查Redis连接
   docker-compose exec redis redis-cli ping
   ```

### 日志位置

- **Docker部署**: `docker-compose logs`
- **开发模式**: 终端输出
- **Nginx日志**: `logs/nginx/`
- **应用日志**: `logs/`

## 🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目仅供学习和研究使用。请遵守相关AI服务的使用条款。

## 🙏 致谢

- [通义千问](https://tongyi.aliyun.com/qianwen/) - 作文批改AI模型
- [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo) - 视频生成基础框架
- [Pexels](https://www.pexels.com/) - 免费视频素材
- [Pixabay](https://pixabay.com/) - 免费视频素材

## 📞 支持

如有问题或建议，请提交Issue或联系维护者。