Files
2026-09-24 10:40:57 +08:00

3.6 KiB
Raw Permalink Blame History

灵心造物 · 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 不共享翻译文件、依赖或运行时。