ljwx-qwen-test/docs/01-getting-started/quickstart.md

title, doc_id, version, status, owner, last_updated, related

title	doc_id	version	status	owner	last_updated	related
快速上手指南	GETTING-STARTED-QUICKSTART	1.0	Draft	Project Team	2026-02-09	dev-env.md, project-structure.md

快速上手指南

DocID: GETTING-STARTED-QUICKSTART Version: 1.0 Status: Draft Owner: Project Team Last Updated: 2026-02-09

环境准备

系统要求

• 操作系统：Linux/macOS/Windows 10+
• 内存：≥ 8GB RAM
• 存储：≥ 50GB 可用空间
• 网络：稳定的互联网连接

依赖软件

# Git
git --version

# Node.js (v16+)
node --version

# Python (v3.8+)
python --version

# Docker (可选)
docker --version

项目获取

# 克隆项目仓库
git clone http://192.168.1.83:33000/gao/ljwx-qwen-test.git
cd ljwx-qwen-test

# 查看项目结构
ls -la

本地运行

前端启动

cd frontend
npm install
npm run dev

后端启动

cd backend
pip install -r requirements.txt
python app.py

Docker启动（推荐）

# 构建并启动所有服务
docker-compose up --build

# 后台运行
docker-compose up -d

访问系统

• 前端界面：http://localhost:3000
• API文档：http://localhost:8080/api/docs
• 管理后台：http://localhost:3000/admin

验证安装

访问系统后，尝试以下操作验证安装成功：

1. 登录页面正常显示
2. API接口返回正常数据
3. 数据库连接正常
4. AI模型服务正常响应

常见问题

端口冲突

如果端口已被占用，请修改配置文件中的端口号。

依赖安装失败

检查网络连接，或使用国内镜像源。

权限问题

确保有足够的文件系统权限。