img2threejs / Three.js Object Sculptor：把物件照片轉成 code-only、可動畫的程序化 Three.js 模型 | Allen 知識庫 | Allen 知識庫
AI / DevTools / 3D
img2threejs / Three.js Object Sculptor：把物件照片轉成 code-only、可動畫的程序化 Three.js 模型 img2threejs / Three.js Object Sculptor 是把物件參考圖重建成 code-only、可動畫的程序化 Three.js 模型的 agent workflow。2026-07-24 補充查證 hoainho/img2threejs：Apache-2.0、約 3.7k stars、agent-agnostic skill，含 quality contract、pass lock、render-vs-reference review 與 self-correction loop。適合 Web 3D prototype、遊戲/互動素材與 Athena/Hermes agent 架構研究；不等於 photogrammetry 或單張圖精準 3D 掃描。
2026年7月13日 6 分鐘閱讀 👁 16
Codex Plugin × Three.js × Image-to-3D × Procedural Modeling
Three.js Object Sculptor：把物件照片轉成 code-only、可動畫的程序化 Three.js 3D 模型
這篇 Threads 討論的是 Three.js Object Sculptor ：一個 Codex plugin，讓 Codex 根據物件圖片，逐步生成可在瀏覽器執行、可版本控制、可繼續修改的程序化 Three.js 物件工廠。它不是 3D 掃描，也不是從單張圖抽出精準 mesh，而是把 AI 變成「有檢查點的程序化雕塑師」。
Kate 判斷： 這個工具值得放進 Allen 的「AI 生成互動素材 / 遊戲原型 / browser demo」工具箱觀察。它的價值不是取代 Blender 或 photogrammetry，而是把「可互動、可動畫、可重構的 3D web asset」變成程式碼 artifact；對小遊戲、產品展示、教育互動、Three.js demo 特別有用。
項目 結果 判讀 Repo vinhhien112/Three.js-Object-Sculptor-Codex-PluginThreads link preview 指向同一 repo。 Description Codex plugin that turns attached object images into code-only, animation-ready procedural Three.js models.
閱讀資訊
閱讀時間 6 分鐘
段落層級 12
瀏覽 16
日期 2026年7月13日 定位明確：Codex plugin，不是獨立 SaaS。
Created 2026-07-09 非常新，仍屬早期工具。
Updated / pushed Updated 2026-07-13；pushed 2026-07-11 近期活躍。
Stars / forks 查證時約 825 stars / 98 forks 社群關注很快，但不能直接等同成熟度。
Language Python plugin/helper scripts 層為主；輸出目標是 Three.js/TypeScript code。
License MIT License 相對寬鬆；商用整合仍需自己審查依賴與輸出素材權利。
README 對工具的描述很清楚：它不是把圖片「掃描」成 3D，也不是下載現成 art pack；它是引導 Codex 走一套程序化建模流程：
Validate image： 先判斷圖片是否適合做程序化 3D 重建。Describe object： 描述物件類型、輪廓、比例、結構與辨識特徵。ObjectSculptSpec： 生成物件規格，包含 component hierarchy、materials、lighting、pivots、sockets、animation anchors、destruction anchors、quality targets。Staged build： 從 blockout、structure、form refinement、material、surface、lighting、interaction 到 optimization 逐步建構。Action-ready hierarchy： 不是單純長得像，而是讓後續動畫、變形、物理、破壞效果有真實 pivot / attachment point 可用。Vision review： 把 reference / render screenshot 包成 comparison sheet，交給 AI vision reviewer 做自我修正評分。
重要限制： README 明確說它 Not for photogrammetry, exact mesh extraction, scanned assets, downloaded art packs, or guaranteed production-perfect geometry from one image 。也就是：不要期待它從單張照片生成 CAD 級或商業遊戲最終品質 asset。
比較 一般 image-to-3D / mesh generation Three.js Object Sculptor 輸出型態 mesh / glTF / OBJ / 3D asset Three.js 程式碼與 procedural object factory 可編輯性 通常要進 Blender 或 3D DCC 修改 可直接在 code 裡拆 component、改材質、改 hierarchy 版本控制 binary asset diff 困難 code artifact 可 git diff / review / refactor 動畫/互動 需額外 rig / pivot / collider 流程中預先規劃 pivots、sockets、animation anchors 精準度 可能追求形狀相似 mesh 追求可用的 procedural approximation，不保證掃描級精準
遊戲原型
Browser demo
產品展示
AI coding workflow
精準 CAD / 工業建模： 尺寸、曲面、公差、拓撲都不應期待它直接可靠。商業遊戲最終 asset： 可作 prototype，最終品質仍需要 artist / technical artist 修。品牌/角色 IP 直接仿作： 即使程式碼是 MIT，參考圖與輸出結果仍可能涉及著作權 / 商標 / 肖像權。需要 photo-real mesh 的 pipeline： 這不是 photogrammetry，也不保證單張圖重建背面或不可見細節。
休閒遊戲 MVP： Allen 偏好的手機網頁小遊戲，如果需要快速生成「可互動物件」，這類 code-only asset pipeline 很有用。AI 生成內容產品： 不是只產圖片，而是產「可執行、可互動、可版本控制」的 artifact，產品價值更高。Agent workflow 設計： 它把 AI 生成拆成 spec、staged passes、vision quality gate，這個模式也能用在 UI、簡報、遊戲關卡、工程圖審查等生成流程。可商用 caveat： MIT 是 plugin license；但 Codex、Three.js project dependencies、reference image rights、生成物的 IP 風險仍要分開處理。
git clone https://github.com/vinhhien112/Three.js-Object-Sculptor-Codex-Plugin ~/plugins/threejs-object-sculptor
# 依 README 把 plugin 加到 Codex local marketplace
# 準備一個 Three.js 專案 + 一張自己有權利使用的物件參考圖
# 先測低風險物件：杯子、玩具車、無品牌道具、簡單機械零件
# 看輸出是否真的有 component hierarchy / pivots / material passes / render review
安全與權利檢查： 只用自己拍攝或有授權的參考圖；不要拿品牌商品、角色、受保護設計直接生成可商用 asset。若要放進客戶專案，先固定工具版本、保存 prompt/spec、記錄來源權利與人工修正紀錄。
這篇真正的重點不是「照片變 3D」這個 buzzword，而是：
AI 生成的下一步，是把輸出從不可控的 media blob，變成可 review、可 version、可 refactor、可執行的 code artifact。
Three.js Object Sculptor 目前很新，但方向對。它適合拿來做 prototype pipeline，特別是 Allen 之前提過的手機網頁遊戲、互動式 demo、視覺化產品展示。不要把它當 Blender 替代品；把它當「Codex 生成 Three.js procedural props 的 workflow template」會比較準。
2026-07-24 補充：img2threejs 版本已變成更完整的 agent skill / pipeline
新增來源： 極端工程師 Sun 在 Threads 補充分享
hoainho/img2threejs 。這個 repo 延續「圖片 → procedural Three.js code」概念，但文件已整理成更完整的 agent-agnostic skill：支援 Claude Code、Codex、OpenCode 等 host，並把 quality gate、render review、self-correction loop 寫得更明確。
項目 hoainho/img2threejs 查證結果 對原文的補充 定位 README 描述為「code-only, procedural, quality-gated, animation-ready Three.js model」。 更明確地把它框成 reconstruction-by-code，不是 photogrammetry、mesh extraction 或下載 art packs。 授權 GitHub metadata 與 repo 內 LICENSE 顯示 Apache License 2.0。 與早期 MIT 版本不同；商用評估時以實際採用 repo / commit 的 LICENSE 為準。 Repo metadata 建立於 2026-07-15；查證時約 3.7k stars、279 forks；主要語言 Python；homepage 指向 demo gallery 。 社群關注度快速上升，但 repo 很新，採用前應 pin commit 並自行跑測。 Pipeline 文件列出 blockout → structural-pass → form-refinement → material-pass → surface-pass → lighting-pass → interaction-pass → optimization-pass。 這比「單次生成模型」更像一套 agent 任務狀態機，適合拿來研究 Athena / Hermes 的 quality gate 設計。 限制 CONTRIBUTING 明確寫出強項是 hard-surface objects、props、stylized / low-poly assets；photoreal specific person、animal、landscape from a single image 仍超出當前範圍。 不要把它賣成「單張圖精準 3D 掃描」。它更適合互動 prototype、web prop、可維護 3D artifact。
對 Allen / Athena 的架構啟發
把產物變成可 diff 的 artifact： 輸出 Three.js/TypeScript code，而不是黑箱 binary mesh；這讓 agent 可以局部修改、review、回歸測試。先定義 quality contract 再生成： 先要求 component hierarchy、materials、sockets、identity-defining details，再進 build pass，可避免 agent 一次亂做。腳本負責硬 gate，視覺判斷負責語意： repo 裡的 forge/ scripts 做 metadata / validation / deterministic review；agent vision 做是否像參考圖的判斷。這種分工很適合 Athena agent 架構。單圖限制要顯式化： hidden side、exact geometry、商標/肖像/角色權利都不能假裝自動解決；輸出應標註 approximate / stylized / low-poly。 Kate 判斷：這次補充讓這篇文章從「有趣的 Codex plugin」升級成「值得拆解的 agent workflow 範例」。對 BigIntTech 來說，它不一定要直接進 production toolchain，但很值得把 SKILL.md、forge/、grimoire/ 的架構拆來看，尤其是 quality contract、pass lock、render-vs-reference review 與 self-correction loop。