用途:自动检测项目类型并运行应用,按固定流程完成依赖、环境变量、端口、数据库与启动步骤。
主要能力:
- 检测项目类型:依据根目录文件判断,package.json + next.config.js 为 Next.js;package.json(无 Next)为 Node.js;requirements.txt 或 pyproject.toml 为 Python;docker-compose.yml 为 Docker Compose;仅 Dockerfile 为 Docker。若存在 docker-compose.dev.yml,优先用 Docker 开发。
- 检查依赖:Node.js/Next.js 用 ls node_modules 2>/dev/null || npm install,并检查 node --version、npm --version;Python 创建虚拟环境并 pip install -r requirements.txt;Docker 检查 docker --version、docker-compose --version。
- 环境变量:若存在 .env.example 而无 .env,执行 cp .env.example .env,并提示用户配置 DATABASE_URL、API_KEY/SECRET_KEY、PORT 等。
- 端口检查:列出常见默认端口(Next.js/React 3000、Node.js 3000 或 8080、Django/FastAPI 8000、Flask 5000、PostgreSQL 5432、MySQL 3306、Redis 6379),用 netstat 或 lsof 检查占用。
- 启动数据库与迁移:用 docker-compose up -d db 启动数据库,或用 pg_isready、mysqladmin ping、mongosh 检查;迁移命令按工具区分,如 npx prisma migrate dev、python manage.py migrate、alembic upgrade head。
- 运行应用:Next.js 用 npm run dev 或 npm run build && npm start;Node.js 用 npm run dev/start;Django 用 python manage.py runserver;FastAPI 用 uvicorn main:app --reload;Flask 用 flask run;Docker Compose 用 docker-compose -f docker-compose.dev.yml up 或 docker-compose up -d。
使用方式:按步骤顺序执行,先检测类型,再依次验证依赖、环境变量、端口、数据库,最后启动。
适用场景:本地开发启动、快速排查启动失败、统一多类型项目运行流程。
限制:资料未提供收费、平台支持范围、效果保证等信息;命令与端口为通用示例,实际以项目配置为准。