3.6 KiB
3.6 KiB
灵心造物 · CADmind
前后端独立开发、独立启动。当前建模功能、任务协议、三维显示和导出流程保持原有实现。
CADmind/
├── frontend/ 前端项目(Node.js / Vite)
│ ├── index.html 工作台入口
│ ├── public/static/ 界面、交互、Three.js 和静态资源
│ ├── tests/ 前端与接口代理测试
│ ├── vite.config.js 开发与预览代理配置
│ └── package.json
└── backend/ 后端项目(Python / Flask)
├── run.py API 服务启动入口
├── web/ HTTP 接口、异步任务、响应文案
├── engine/ 模型调用、建模、核验和导出
├── capabilities/ 建模能力库
├── output/ 生成文件与历史任务(不提交)
├── .env API 密钥与后端配置(不提交)
├── .venv/ Python 环境(不提交)
├── tests/ Python 回归测试
└── requirements.txt
本地启动
分别打开两个终端。
终端一:后端
cd backend
# 新电脑首次运行:
# python3.12 -m venv .venv
# .venv/bin/python -m pip install -r requirements.txt
# cp .env.example .env # 再填写 OPENAI_API_KEY
.venv/bin/python run.py
后端:http://127.0.0.1:8080,健康检查:/api/health。后端不提供网页或前端静态文件。
终端二:前端(Node.js 20.19+,或 22.12+)
cd frontend
npm ci
npm run dev
浏览器访问 http://127.0.0.1:8093/。当前电脑的依赖和后端配置已保留。
页面通过 HTTP 调用后端。开发环境中,Vite 将 /api/* 和 /files/* 原路径转发至后端:包含任务创建/轮询/取消、历史删除/恢复、STL 加载和 STEP 下载,不需要修改原有响应结构。
前端可以单独启动、修改界面;使用建模和历史数据功能时需要后端在线。前端不导入 Python 代码,也不读取后端密钥。若后端在其他地址,复制 frontend/.env.example 为 frontend/.env,设置 BACKEND_URL 后重新启动前端。
验证
cd backend
.venv/bin/python -m unittest discover -s tests/quality
cd frontend
npm test
npm run build
npm run preview
构建产物在 frontend/dist/;本地构建预览地址为 http://127.0.0.1:8094,仍连接独立后端。
部署与后续拆仓库
- 前端部署
frontend/dist/,由静态 Web 服务器提供页面。 - 后端单独启动,入口为
web.app:app;保留其.env和output/。 - 正式 Web 服务器需将
/api/、/files/反向代理至后端,参考frontend/nginx.conf.example。npm run preview仅用于验证构建。 - 两个目录可分别放进独立仓库;只通过 HTTP 协议连接。示例、实验、命令行与技术资料收在后端,原命令在
backend/下运行。 - 新仓库不提交
.env、.venv、output、node_modules、dist或缓存。本次没有重新初始化 Git,也没有修改服务器部署。
前端双语为 CADmind 独立实现:frontend/public/static/i18n.js 当前固定使用英文,不读取浏览器语言;后续仍可通过独立运行时接入简体中文。不增加语言按钮、不持久化语言,也不向后端增加请求参数。CADmind 与 cad-world 不共享翻译文件、依赖或运行时。