快速开始
前置条件
- Python 3.11+
- Node.js 20+
- npm
一键开发环境
在仓库根目录运行：
powershell
.\scripts\dev.ps1默认端口：
| 服务 | 地址 |
|---|---|
| API | http://127.0.0.1:8010 |
| 前端 | http://127.0.0.1:3010 |
| 文档 Hub | http://127.0.0.1:5173（见下方） |
后端
powershell
python -m pip install -r requirements.txt
python scripts/run_api.py前端
powershell
cd frontend
npm install
Copy-Item .env.example .env.local
npm run dev打开 http://127.0.0.1:3010/projects 创建第一个项目。
文档 Hub
powershell
cd docs-site
npm install
npm run dev构建前同步状态表（推荐）：
powershell
python scripts/docs/sync_doc_status.py
cd docs-site
npm run build环境变量
常用配置：
LATENTFLOW_PROJECT_STORE— 项目存储目录，默认var/projectsGEMINI_API_KEY/OPENAI_API_KEY/DEEPSEEK_API_KEY— PM 需求解析（可选）FREECADCMD— FreeCAD 可执行路径，用于 STEP/FCStd 导出
验证
powershell
$env:PYTHONPATH="$PWD\src"
python -m unittest tests.test_api_project_workflow