計(jì)平臺)
Amagine3D完全指南一句話需求參考圖生成可編輯硬件外殼的開源AI 3D設(shè)計(jì)平臺【免費(fèi)下載鏈接】Amagine3DAmagine3D: From hardware requirements to editable 3D designs項(xiàng)目地址: https://gitcode.com/gh_mirrors/am/Amagine3DAmagine3D 是一款開源的 AI 3D 設(shè)計(jì)平臺主打從硬件需求到可編輯 3D 設(shè)計(jì)輸入產(chǎn)品描述、參考圖和關(guān)鍵尺寸它就能圍繞內(nèi)部器件設(shè)計(jì)出完整的硬件外殼與裝配結(jié)構(gòu)并輸出可繼續(xù)編輯的源碼按需導(dǎo)出 STEP、STL、3MF 文件。適合想快速驗(yàn)證硬件外殼創(chuàng)意的開發(fā)者、創(chuàng)客和普通用戶。一、Amagine3D 是什么AI 驅(qū)動(dòng)的硬件外殼生成工具簡單說Amagine3D 把做外殼這件事從復(fù)雜的 CAD 操作變成了對話式設(shè)計(jì)輸入門檻低自然語言需求 參考圖 尺寸無需桌面 CAD 軟件輸出可編輯每次生成都保留完整的 Python 與 build123d 源碼關(guān)鍵尺寸直接在工作臺調(diào)整并回寫源碼無需重新調(diào)用模型面向真實(shí)制造單色設(shè)計(jì)導(dǎo)出 STEP / STL多色設(shè)計(jì)生成帶顏色的 3MF 與分區(qū) STL并檢查裝配干涉、運(yùn)動(dòng)路徑與可打印性。在背后3D-native Agent 會先把需求整理成設(shè)計(jì)簡報(bào)再在瀏覽器幾何運(yùn)行時(shí)中真正構(gòu)建模型讀取模型的實(shí)際尺寸和質(zhì)檢結(jié)果決定繼續(xù)修改還是接受當(dāng)前版本。它依據(jù)的是真實(shí)幾何測量值而不是模型對結(jié)果的文字想象。二、核心功能亮點(diǎn)1. 一句話需求 參考圖生成參數(shù)化 CAD 外殼設(shè)計(jì)過程從內(nèi)部元器件出發(fā)先安排安裝位和接口再完成外殼、控制件與散熱結(jié)構(gòu)。需要分件時(shí)蓋體、鉸鏈或卡扣會連同裝配間隙和打印公差一起進(jìn)入設(shè)計(jì)鉸鏈、滑蓋這類剛性結(jié)構(gòu)還可以沿設(shè)定運(yùn)動(dòng)路徑檢查碰撞與運(yùn)行間隙。這套流程定義在 skills/text-a3d/SKILL.md 中多色版本見 skills/text-a3d-color/SKILL.md。2. 參數(shù)即設(shè)計(jì)關(guān)鍵尺寸隨時(shí)可調(diào)生成的模型中決定外觀與裝配的關(guān)鍵尺寸都會以參數(shù)形式出現(xiàn)在工作臺。改動(dòng)參數(shù)會回寫源碼并重建幾何整個(gè)結(jié)果隨項(xiàng)目保存——這就是可編輯的含義而不是一次性生成一個(gè)死模型。3. 多色設(shè)計(jì)與 3MF 導(dǎo)出多色設(shè)計(jì)支持生成帶顏色信息的 3MF 文件并為每個(gè)顏色區(qū)域輸出單獨(dú)的 STL。倉庫內(nèi)置了一個(gè)只讀的多色番茄鐘示例項(xiàng)目其配色與零件清單見 bundled-projects/amagine3d-pomodoro/manifest.json可在工作臺中直接查看效果。4. 3D-native Agent生成 → 檢查 → 修訂的自動(dòng)閉環(huán)Agent 的每一輪迭代都會讀取零件間空間關(guān)系 → 修改源碼 → 在真實(shí)幾何環(huán)境構(gòu)建 → 測量并檢查連接、干涉、運(yùn)動(dòng)與導(dǎo)出文件 → 按具體測量值定位問題進(jìn)入下一輪。只有當(dāng)候選設(shè)計(jì)通過檢查才會被提交為新版本出問題時(shí)會保留上一版結(jié)果必要時(shí)要求用戶確認(rèn)。三、案例BUSY Bar 桌面設(shè)備外殼下面這張圖展示的是 Amagine3D 參考公開產(chǎn)品信息生成的一套桌面設(shè)備外殼正面留出顯示區(qū)頂部布置實(shí)體控制件內(nèi)部按器件與接口安排空間并且是可直接拆分的多部件結(jié)構(gòu)。Agent 先根據(jù)參考圖確定顯示區(qū)和控制件的位置再圍繞內(nèi)部器件完成外殼分件。這次生成產(chǎn)出了完整的 build123d 源碼、STEP、STL 和檢查報(bào)告決定外觀與裝配的關(guān)鍵尺寸都保留為可編輯參數(shù)生成后仍可繼續(xù)調(diào)整。四、快速上手一鍵安裝與啟動(dòng)步驟環(huán)境要求依賴版本Node.js20.19Python3.10 – 3.13npm隨 Node.js 附帶瀏覽器現(xiàn)代桌面瀏覽器已驗(yàn)證 Chrome / Edge模型網(wǎng)關(guān)兼容 Amagine3D Agent 運(yùn)行時(shí)協(xié)議初始化腳本會在倉庫內(nèi)自動(dòng)創(chuàng)建.venv并安裝鎖定版本的 build123d、OCP、trimesh 與 lib3mf不需要安裝桌面 CAD 軟件。安裝并運(yùn)行g(shù)it 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 默認(rèn)監(jiān)聽http://127.0.0.1:6161。首次啟動(dòng)會準(zhǔn)備 Python 環(huán)境之后依賴無變化時(shí)直接復(fù)用。服務(wù)端 .env 配置要點(diǎn)LLM_API_KEY... LLM_MODELopenai/gpt-5.5 LLM_BASE_URLhttps://gateway.example.com/v1 LLM_API_TYPEopenai-responses TAVILY_API_KEY... # 可選啟用聯(lián)網(wǎng)參考開關(guān) PORT6161 WEB_PORT6160 AGENT_RUN_TIMEOUT_MS1800000這些配置只由本地 Express 服務(wù)端讀取模型憑據(jù)不會暴露給瀏覽器。配置TAVILY_API_KEY后輸入?yún)^(qū)會出現(xiàn)聯(lián)網(wǎng)參考開關(guān)開啟后 Agent 必須先聯(lián)網(wǎng)檢索尺寸與規(guī)格來源再執(zhí)行 CAD 生成并盡力向多模態(tài)模型提供最多三張參考圖相關(guān)邏輯見 server/web-search.ts。五、工作臺使用流程打開頁面后工作臺由五個(gè)面板組成源碼在 src/components/cad-workbench/對話面板輸入需求、上傳參考圖控制聯(lián)網(wǎng)參考開關(guān)文件面板查看本次會話生成的源碼、模型與報(bào)告支持打包、歸檔與回收站預(yù)覽面板基于 Three.js 的 3D 查看器src/components/CadViewer.tsx支持旋轉(zhuǎn)、選擇與測量參數(shù)面板直接調(diào)整關(guān)鍵尺寸回寫源碼并重建幾何存儲抽屜管理項(xiàng)目產(chǎn)物與存儲。每個(gè) Agent 會話都使用獨(dú)立工作區(qū)CAD 腳本由服務(wù)端管理的 Python 環(huán)境執(zhí)行會話產(chǎn)物保存在workspace/sessions/sessionId/下互不干擾。六、項(xiàng)目結(jié)構(gòu)速覽目錄說明src/React/Vite 界面工作臺面板、3D 查看器、流式 API 客戶端server/Express APIAgent 對話流、產(chǎn)物管理、上傳與視覺檢查packages/a3d-runtime/src/3D-native Agent 的模型/會話適配、Skill 加載與寫入限制skills/單色text-a3d與多色text-a3d-colorCAD 生成與質(zhì)檢流程bundled-projects/工作臺內(nèi)置的只讀示例項(xiàng)目scripts/Python 環(huán)境安裝與許可證檢查腳本tests/服務(wù)端、運(yùn)行時(shí)與 UI 邏輯測試安全設(shè)計(jì)會話隔離、路徑限制、憑據(jù)邊界詳見 docs/threat-model.zh-CN.md。七、適用場景與當(dāng)前邊界適合的場景智能硬件外殼的概念驗(yàn)證、桌面小設(shè)備分件結(jié)構(gòu)設(shè)計(jì)、多色 3D 打印外殼3MF AMS 分色、從參考圖快速復(fù)刻產(chǎn)品外形。需要注意的邊界當(dāng)前公開版本聚焦智能硬件外殼的單色 / 多色參數(shù)化 CAD屬于項(xiàng)目的第一階段完整工作流建議在桌面 Chrome / Edge 中使用項(xiàng)目仍在積極迭代后續(xù)會擴(kuò)展到 mesh、掃描、點(diǎn)云輸入以及幾何修復(fù)、壁厚、打印方向等制造環(huán)節(jié)。八、小結(jié)Amagine3D 把AI 生成 3D從一次性出圖推進(jìn)到了可編輯、可檢查、可制造的工程流程一句話需求加參考圖得到的是保留完整源碼的參數(shù)化硬件外殼而不是一個(gè)無法修改的靜態(tài)模型。如果你正在尋找一個(gè)免費(fèi)的開源 AI 3D 設(shè)計(jì)平臺來快速生成外殼設(shè)計(jì)并直接打印驗(yàn)證它目前正是參數(shù)化 CAD 方向上值得關(guān)注的選擇。更多細(xì)節(jié)可閱讀官方中文文檔 docs/README.zh-CN.md參與貢獻(xiàn)規(guī)范見 docs/CONTRIBUTING.zh-CN.md?!久赓M(fèi)下載鏈接】Amagine3DAmagine3D: From hardware requirements to editable 3D designs項(xiàng)目地址: https://gitcode.com/gh_mirrors/am/Amagine3D創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考