快速启动指南
项目介绍 该项目采用 前后端分离架构,融合 Python 后端框架 FastAPI 和前端主流框架 Vue3 实现统一开发,提供了一站式开箱即用的体验 打造AI结合,支持AI生成用例生成,接口自动化,APP自动化,UI自动化,智能排版,LLM厂商自定义配置的一体化管理平台。
后端: FastAPI/ Uvicorn / Pydantic 2.0 前端: Vue3 / Vite / TypeScript/ElementPlus
- Python 3.11
- MySQL 8.0+
- Node.js 18+ (前端)
查看对于的docker详细配置文件
数据库名test_platform,编码选择utf8mb4,对应config.py下db配置为当前数据库信息即可
查看最大连接数 show variables like 'max_connections';
设置最大连接数 set global max_connections=16384;
cd backend # 激活虚拟环境 (Windows) .venv\Scripts\activate # 安装依赖 pip install -r requirements.txt
编辑 config.py 中的数据库配置:
tortoise_orm_conf = { 'connections': { 'default': { 'engine': 'tortoise.backends.mysql', 'credentials': { 'host': 'localhost', 'port': '3306', 'user': 'root', 'password': 'your_password', # 修改为你的密码 'database': 'test_platform' } } }, # ... }
这里直接执行目录下的sql文件手动执行
###初始化数据库表结构(项目根目录下依次执行下面命令):
如果是已经初始化过数据库了,改了数据模型,需要重新映射则执行以下步骤 对比变更、并映射到数据库: aerich migrate 把最新版本的数据结构同步到aerich表: aerich upgrade
准备浏览器驱动
根据要用来做自动化的浏览器的类型下载对应版本的驱动,详见:https://www.selenium.dev/documentation/zh-cn/webdriver/driver_requirements/
把下载的驱动放到项目外的 browser_drivers 路径下,项目启动时若没有则会自动创建,若项目未启动过,则需手动创建
给驱动加权限:chmod +x chromedriver
1.把main端口改为8024启动
2.把job端口改为8025启动
3.准备好前端包,并在nginx.location / 下指定前端包的路径
4.直接把项目下的nginx.conf文件替换nginx下的nginx.conf文件
5.nginx -s reload 重启nginx
本地开发:
运行测试平台主服务 main.py
运行定时任务/运行任务调度服务 job.py
生产环境:
项目根目录
1、给shell加执行权限: chmod 755 start.sh kill.sh
2、启动项目,执行启动shell: ./start.sh
3、关闭项目,执行启动shell: ./kill.sh
注:如果shell报错: -bash: ./kill.sh: /bin/bash^M: bad interpreter: No such file or directory
需在服务器上打开编辑脚本并保存一下
# 开发模式 python main.py # 或使用 uvicorn uvicorn main:app --host 0.0.0.0 --port 8018 --reload
服务器将在 http://localhost:8018 启动
打开浏览器访问:
- Swagger UI: http://localhost:8018/docs
- ReDoc: http://localhost:8018/redoc
cd frontend pip3 install -r requirements.txt ======= cd frontend npm install
npm run dev
前端dev将在 http://localhost:8016 启动
cd backend
python test_mcp_integration.py这个步骤可以忽略 cd backend python test_mcp_integration.py
预期输出:
🎉 所有测试通过!系统已准备就绪。
### 测试 API 端点
```bash
# 测试健康检查
curl http://localhost:8018/docs
# 测试项目列表 (需要登录)
curl http://localhost:8018/api/aitestrebort/projects
- 登录系统
- 进入 "aitestrebort" -> "MCP 配置"
- 点击 "新建配置"
- 填写表单:
- 配置名称: 测试 MCP 服务器
- 服务器 URL: http://localhost:8765
- 传输协议: streamable-http
- 认证头: (可选) X-API-Key: your-key
- 点击 "测试连接" 验证配置
- 点击 "创建" 保存配置
- 进入 "aitestrebort" -> "LLM 配置"
- 点击 "新建配置"
- 填写表单:
- 配置名称: OpenAI GPT-4
- 提供商: openai
- 模型名称: gpt-4
- API 密钥: sk-your-key
- 基础 URL: https://api.openai.com/v1
- 点击 "测试连接" 验证配置
- 点击 "创建" 保存配置
- 进入项目详情页
- 点击 "AI 生成测试用例"
- 输入需求描述
- 选择 LLM 配置
- 点击 "生成" 获取测试用例
错误: error while attempting to bind on address ('0.0.0.0', 8018)
解决:
# Windows netstat -ano | findstr :8018 taskkill /PID <进程ID> /F # Linux/Mac lsof -ti:8018 | xargs kill -9
错误: Can't connect to MySQL server
解决:
- 确认 MySQL 服务正在运行
- 检查
config.py中的数据库配置 - 确认数据库
test_platform已创建
错误: ConfigurationError: default_connection cannot be None
解决:
- 确保使用的是 Tortoise ORM 0.25.3+
- 检查
app/hooks/app_hook.py使用的是Tortoise.init而不是register_tortoise
错误: ModuleNotFoundError: No module named 'langchain_mcp_adapters'
解决:
pip install langchain-mcp-adapters>=0.2.0- 使用 Black 格式化 Python 代码
- 使用 ESLint + Prettier 格式化前端代码
- 遵循 PEP 8 编码规范
# 运行后端测试 pytest # 运行前端测试 npm run test
在 VS Code 中添加 .vscode/launch.json:
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: FastAPI",
"type": "python",
"request": "launch",
"module": "uvicorn",
"args": [
"main:app",
"--reload",
"--port",
"8018"
],
"jinja": true,
"justMyCode": false
}
]
}在浏览器中使用 Vue DevTools 扩展
gunicorn main:app -c gunicorn_config_main.py
# 构建镜像 docker build -t aitestrebort-api . # 运行容器 docker run -d -p 8018:8018 aitestrebort-api
server { listen 80; server_name your-domain.com; location / { proxy_pass http://localhost:8018; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }
如遇到问题,请:
- 查看日志文件
logs/ - 运行集成测试
python test_mcp_integration.py - 查看相关文档
- 提交 Issue
最后更新: 2026年01月04日 版本: 1.0.0