Amagine3D完全指南一句话需求参考图生成可编辑硬件外壳的开源AI 3D设计平台【免费下载链接】Amagine3DAmagine3D: From hardware requirements to editable 3D designs项目地址: https://gitcode.com/gh_mirrors/am/Amagine3DAmagine3D 是一款开源的 AI 3D 设计平台主打从硬件需求到可编辑 3D 设计输入产品描述、参考图和关键尺寸它就能围绕内部器件设计出完整的硬件外壳与装配结构并输出可继续编辑的源码按需导出 STEP、STL、3MF 文件。适合想快速验证硬件外壳创意的开发者、创客和普通用户。一、Amagine3D 是什么AI 驱动的硬件外壳生成工具简单说Amagine3D 把做外壳这件事从复杂的 CAD 操作变成了对话式设计输入门槛低自然语言需求 参考图 尺寸无需桌面 CAD 软件输出可编辑每次生成都保留完整的 Python 与 build123d 源码关键尺寸直接在工作台调整并回写源码无需重新调用模型面向真实制造单色设计导出 STEP / STL多色设计生成带颜色的 3MF 与分区 STL并检查装配干涉、运动路径与可打印性。在背后3D-native Agent 会先把需求整理成设计简报再在浏览器几何运行时中真正构建模型读取模型的实际尺寸和质检结果决定继续修改还是接受当前版本。它依据的是真实几何测量值而不是模型对结果的文字想象。二、核心功能亮点1. 一句话需求 参考图生成参数化 CAD 外壳设计过程从内部元器件出发先安排安装位和接口再完成外壳、控制件与散热结构。需要分件时盖体、铰链或卡扣会连同装配间隙和打印公差一起进入设计铰链、滑盖这类刚性结构还可以沿设定运动路径检查碰撞与运行间隙。这套流程定义在 skills/text-a3d/SKILL.md 中多色版本见 skills/text-a3d-color/SKILL.md。2. 参数即设计关键尺寸随时可调生成的模型中决定外观与装配的关键尺寸都会以参数形式出现在工作台。改动参数会回写源码并重建几何整个结果随项目保存——这就是可编辑的含义而不是一次性生成一个死模型。3. 多色设计与 3MF 导出多色设计支持生成带颜色信息的 3MF 文件并为每个颜色区域输出单独的 STL。仓库内置了一个只读的多色番茄钟示例项目其配色与零件清单见 bundled-projects/amagine3d-pomodoro/manifest.json可在工作台中直接查看效果。4. 3D-native Agent生成 → 检查 → 修订的自动闭环Agent 的每一轮迭代都会读取零件间空间关系 → 修改源码 → 在真实几何环境构建 → 测量并检查连接、干涉、运动与导出文件 → 按具体测量值定位问题进入下一轮。只有当候选设计通过检查才会被提交为新版本出问题时会保留上一版结果必要时要求用户确认。三、案例BUSY Bar 桌面设备外壳下面这张图展示的是 Amagine3D 参考公开产品信息生成的一套桌面设备外壳正面留出显示区顶部布置实体控制件内部按器件与接口安排空间并且是可直接拆分的多部件结构。Agent 先根据参考图确定显示区和控制件的位置再围绕内部器件完成外壳分件。这次生成产出了完整的 build123d 源码、STEP、STL 和检查报告决定外观与装配的关键尺寸都保留为可编辑参数生成后仍可继续调整。四、快速上手一键安装与启动步骤环境要求依赖版本Node.js20.19Python3.10 – 3.13npm随 Node.js 附带浏览器现代桌面浏览器已验证 Chrome / Edge模型网关兼容 Amagine3D Agent 运行时协议初始化脚本会在仓库内自动创建.venv并安装锁定版本的 build123d、OCP、trimesh 与 lib3mf不需要安装桌面 CAD 软件。安装并运行git clone https://gitcode.com/gh_mirrors/am/Amagine3D cd Amagine3D npm install cp .env.example .env npm run dev配置好.env后打开http://127.0.0.1:6160本地 API 默认监听http://127.0.0.1:6161。首次启动会准备 Python 环境之后依赖无变化时直接复用。服务端 .env 配置要点LLM_API_KEY... LLM_MODELopenai/gpt-5.5 LLM_BASE_URLhttps://gateway.example.com/v1 LLM_API_TYPEopenai-responses TAVILY_API_KEY... # 可选启用联网参考开关 PORT6161 WEB_PORT6160 AGENT_RUN_TIMEOUT_MS1800000这些配置只由本地 Express 服务端读取模型凭据不会暴露给浏览器。配置TAVILY_API_KEY后输入区会出现联网参考开关开启后 Agent 必须先联网检索尺寸与规格来源再执行 CAD 生成并尽力向多模态模型提供最多三张参考图相关逻辑见 server/web-search.ts。五、工作台使用流程打开页面后工作台由五个面板组成源码在 src/components/cad-workbench/对话面板输入需求、上传参考图控制联网参考开关文件面板查看本次会话生成的源码、模型与报告支持打包、归档与回收站预览面板基于 Three.js 的 3D 查看器src/components/CadViewer.tsx支持旋转、选择与测量参数面板直接调整关键尺寸回写源码并重建几何存储抽屉管理项目产物与存储。每个 Agent 会话都使用独立工作区CAD 脚本由服务端管理的 Python 环境执行会话产物保存在workspace/sessions/sessionId/下互不干扰。六、项目结构速览目录说明src/React/Vite 界面工作台面板、3D 查看器、流式 API 客户端server/Express APIAgent 对话流、产物管理、上传与视觉检查packages/a3d-runtime/src/3D-native Agent 的模型/会话适配、Skill 加载与写入限制skills/单色text-a3d与多色text-a3d-colorCAD 生成与质检流程bundled-projects/工作台内置的只读示例项目scripts/Python 环境安装与许可证检查脚本tests/服务端、运行时与 UI 逻辑测试安全设计会话隔离、路径限制、凭据边界详见 docs/threat-model.zh-CN.md。七、适用场景与当前边界适合的场景智能硬件外壳的概念验证、桌面小设备分件结构设计、多色 3D 打印外壳3MF AMS 分色、从参考图快速复刻产品外形。需要注意的边界当前公开版本聚焦智能硬件外壳的单色 / 多色参数化 CAD属于项目的第一阶段完整工作流建议在桌面 Chrome / Edge 中使用项目仍在积极迭代后续会扩展到 mesh、扫描、点云输入以及几何修复、壁厚、打印方向等制造环节。八、小结Amagine3D 把AI 生成 3D从一次性出图推进到了可编辑、可检查、可制造的工程流程一句话需求加参考图得到的是保留完整源码的参数化硬件外壳而不是一个无法修改的静态模型。如果你正在寻找一个免费的开源 AI 3D 设计平台来快速生成外壳设计并直接打印验证它目前正是参数化 CAD 方向上值得关注的选择。更多细节可阅读官方中文文档 docs/README.zh-CN.md参与贡献规范见 docs/CONTRIBUTING.zh-CN.md。【免费下载链接】Amagine3DAmagine3D: From hardware requirements to editable 3D designs项目地址: https://gitcode.com/gh_mirrors/am/Amagine3D创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考