# 3DModelGen

**Repository Path**: ZX02/3-dmodel-gen

## Basic Information

- **Project Name**: 3DModelGen
- **Description**: # 3D STP 模型生成器（照片/零件图 → CadQuery 代码 → 一键生成 STEP/STL）
本项目提供一个本地 Web 工具：
- 上传同一零件的多张图片（侧视图/尺寸图/多视角）+ 补充文字说明
- （可选）通过 AI 推断生成可运行的 CadQuery 代码（自动回退策略，尽量不失败）
- 你可以在页面里直接编辑并保存 CadQuery 代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3D STP 模型生成器（照片/零件图 → CadQuery 代码 → 一键生成 STEP/STL）

本项目提供一个本地 Web 工具：
- 上传同一零件的多张图片（侧视图/尺寸图/多视角）+ 补充文字说明
- （可选）通过 AI 推断生成可运行的 CadQuery 代码（自动回退策略，尽量不失败）
- 你可以在页面里直接编辑并保存 CadQuery 代码
- 一键生成 3D 零件并导出 STEP/STL，页面可预览 STL
- 项目管理：创建/删除、查看上传图片、查看导出文件

## 运行

1) 安装依赖

```bash
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
```

2) 启动

```bash
.venv\Scripts\python -m app.main
```

打开：`http://127.0.0.1:8000/`

## AI 推断（可选）

默认不需要任何密钥：点“AI 推断”会返回一个可运行的 CadQuery 代码（用于快速开始）。

支持 OpenAI 兼容接口（含多模态）以及 DeepSeek：

- OpenAI 兼容（推荐用这一组）：
  - `AI_BASE_URL`（例如 `https://api.openai.com/v1` 或你的本地网关）
  - `AI_API_KEY`
  - `AI_MODEL`
- DeepSeek（也可直接用这一组）：
  - `DEEPSEEK_BASE_URL`（默认 `https://api.deepseek.com`）
  - `DEEPSEEK_API_KEY`
  - `DEEPSEEK_MODEL`（默认 `deepseek-chat`）

然后在页面里上传图片后点“AI 推断”，系统会把图片与提示词发送给模型，让模型输出用于本项目的结构化结果，并自动生成可运行 CadQuery 代码。

## 建模逻辑

当前以 CadQuery 代码作为最终建模输入；生成时会执行项目代码并导出：
- `outputs/model.step`
- `outputs/model.stl`

为兼容和兜底，系统内部仍保留“模板+参数”的结构化 spec，并可从 spec 自动生成一份可编辑的 CadQuery 代码骨架。

## 内置模板（用于兜底与快速生成）

当前内置：
- `box`：长方体（支持圆角/倒角/凹槽/孔阵列）
- `cylinder`：圆柱（支持圆角/倒角/中心孔）
- `plate_with_holes`：矩形板 + 多孔阵列（支持外轮廓圆角/沉孔/沉头）
- `l_bracket`：L 型支架（支持两条腿孔阵列、圆角/倒角）

你可以在 `app/services/cadquery_templates.py` 里继续扩展模板，并在前端参数里选择。

## 软件环境信息（本机已验证）

- 操作系统：Windows 10 22H2（10.0.19045）
- Python：3.13.13（64-bit, AMD64）
- 主要依赖版本：
  - FastAPI 0.136.1 / Starlette 1.0.0 / Uvicorn 0.46.0
  - Pydantic 2.13.4 / Jinja2 3.1.6 / python-multipart 0.0.28
  - CadQuery 2.7.0（cadquery-ocp 7.8.1.1.post1）
  - httpx 0.28.1

项目依赖声明见：`requirements.txt`