p

📸 Screenshots

文本转3D	图片转3D
Fusion 360 运行效果	脚本管理

✨ Features

• 🎨 文本转3D — 用自然语言描述你想要的3D模型，AI自动生成Fusion 360 Python脚本
• 🖼️ 图像转3D — 上传参考图片，视觉模型分析 → LLM生成脚本（两步流程）
• 🔍 AI提示词优化 — 一键将简单描述扩展为详细的CAD建模提示词
• 🩹 AI智能修复 — 粘贴Fusion 360报错信息，AI分析原因并原地修复脚本
• 🧠 错误知识库 — 自动收集历史错误模式，注入系统提示词避免重复犯错
• 🔄 自动重试 — AST验证失败时自动修复一次，提高成功率
• 🎭 多种艺术风格 — 写实 / 卡通 / 雕塑 / 动漫 / 体素，自由切换
• 🌌 概念渲染图 — 生成前可选AI预览概念图
• 📋 日志面板 — 底部可折叠日志，自动捕获所有API请求
• 📁 脚本管理 — 查看、复制、下载、删除已生成的所有脚本
• ⚙️ 可视化设置 — 下拉选择AI模型，支持自定义模型名

🏗️ Architecture

┌─────────────┐      ┌──────────────────┐      ┌──────────────────┐
│  Vue 3 +    │ HTTP │  FastAPI         │ API  │  Alibaba Cloud   │
│  Naive UI   │◀────▶│  Backend         │◀────▶│  DashScope       │
│  Frontend   │      │                  │      │                  │
└─────────────┘      └──────────────────┘      │  • wan2.7-image  │
                              │                │    (图像生成)      │
                              ▼                │  • qwen3.6-plus  │
                     ┌──────────────────┐      │    (脚本生成)      │
                     │  output_scripts/ │      │  • qwen3-vl-plus │
                     │  (F360 Scripts)  │      │    (视觉分析)      │
                     └──────────────────┘      └──────────────────┘
                              │
                              ▼
                     ┌──────────────────┐
                     │  Fusion 360      │
                     │  (Run Scripts)   │
                     └──────────────────┘

AI调用流程

文本转3D：
1. （可选）wan2.7-image → 生成概念渲染图
2. qwen3.6-plus → 根据描述(+图片)生成Python脚本
3. AST验证 → 失败则自动修复重试

图像转3D（两步流程）：
1. qwen3-vl-plus → 视觉模型分析图片3D特征
2. qwen3.6-plus → 根据分析结果生成Python脚本

AI修复：
1. qwen3.6-plus → 分析错误原因 + 输出修复报告 + 修复后脚本
2. 自动记录错误模式到知识库

🚀 Quick Start

Prerequisites

• Python 3.10+
• Node.js 18+
• 阿里云百炼 API Key
• Fusion 360（用于运行生成的脚本）

一键启动

git clone https://github.com/heiweilu/Fusion3D-Forge.git
cd Fusion3D-Forge

# 配置API Key
cp backend/.env.example backend/.env
# 编辑 backend/.env，填入你的 DASHSCOPE_API_KEY

# Windows一键启动
start.bat

或手动启动：

# 后端
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# 前端（另一个终端）
cd frontend
npm install
npm run dev

浏览器访问 http://localhost:5173

📖 Usage

文本转3D

1. 在输入框描述你想要的3D模型（如"一个手机支架，有两个支撑臂"）
2. （可选）点击 ✨ AI优化 扩展提示词
3. 选择艺术风格
4. 点击 开始生成
5. AI生成概念渲染图 + Fusion 360 Python脚本
6. 下载脚本，在Fusion 360中运行

图像转3D

1. 上传参考图片（JPG/PNG/WEBP，最大10MB）
2. 可选添加文字补充描述
3. 点击 开始生成
4. Step 1: 视觉模型分析图片 → Step 2: LLM生成脚本

AI修复

1. 在Fusion 360中运行脚本
2. 如果报错，复制错误信息
3. 粘贴到修复面板，点击 修复
4. AI分析错误原因，在原脚本上修复，显示修复报告

在Fusion 360中运行脚本

1. 打开Fusion 360
2. 点击 工具 → 脚本和加载项（或按 Shift+S）
3. 点击 + 添加脚本目录指向 output_scripts/ 下的脚本文件夹
4. 选择脚本，点击 运行

🛠️ Tech Stack

📁 Project Structure

Fusion3D-Forge/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI 入口
│   │   ├── config.py            # 配置管理 (模型/路径)
│   │   ├── routers/
│   │   │   ├── text_to_3d.py    # 文本转3D + 预览图 + 提示词优化
│   │   │   ├── image_to_3d.py   # 图像转3D (两步流程)
│   │   │   ├── scripts.py       # 脚本管理 + AI修复 + 错误统计
│   │   │   └── settings.py      # 设置 CRUD
│   │   ├── services/
│   │   │   ├── qwen_omni.py     # 所有AI调用 (LLM/Vision/修复)
│   │   │   ├── qwen_image.py    # 图像生成 (wan2.7-image)
│   │   │   ├── fusion_script.py # 脚本提取/验证/保存/更新
│   │   │   └── error_knowledge.py # 错误知识库自动收集
│   │   ├── models/schemas.py    # Pydantic 数据模型
│   │   └── prompts/
│   │       └── fusion360_system.py  # 系统提示词 (15条规则+完整示例)
│   ├── requirements.txt
│   └── .env.example
├── frontend/
│   ├── src/
│   │   ├── views/
│   │   │   ├── TextTo3D.vue     # 文本转3D页面
│   │   │   ├── ImageTo3D.vue    # 图像转3D页面
│   │   │   ├── ScriptViewer.vue # 脚本管理页面
│   │   │   └── Settings.vue     # 设置页面 (模型下拉选择)
│   │   ├── components/
│   │   │   ├── ScriptPanel.vue  # 代码展示+AI修复面板
│   │   │   ├── PreviewPanel.vue # 渲染图预览
│   │   │   └── LogPanel.vue     # 底部日志面板
│   │   ├── api/index.js         # API封装 + 日志拦截器
│   │   ├── stores/logStore.js   # 全局日志状态
│   │   └── router/index.js      # 路由配置
│   └── package.json
├── output_scripts/              # 生成的脚本输出
├── start.bat                    # Windows一键启动
├── start.ps1                    # PowerShell启动脚本
└── README.md

⚙️ Configuration

通过 设置页面 或 backend/.env 文件配置：

支持在设置页面下拉选择或手动输入自定义模型名。

🧠 错误知识库

系统会自动从每次修复中学习：

1. 自动记录：AI修复脚本时，自动提取错误类型和修复方案
2. 模式识别：统计高频错误类型（如 face invalidation、profile not found）
3. 智能注入：生成新脚本时，将历史错误模式注入系统提示词
4. 规则沉淀：系统提示词内置15条 Fusion 360 API 常见错误避免规则

错误统计 API：GET /api/scripts/error-stats

📝 License

MIT License

开源连接：
github