# 策展 · X (Twitter) 🔥🔥🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：ゆずき (@uzuki425) · 平台：X (Twitter) · 日期：2026-07-09

> 原始來源：https://x.com/uzuki425/status/2074678870138302537

## 中文摘要

@uzuki425 發布 Image-3D 將圖片轉為 3D 檔案。

**核心功能與架構**
「Image-3D」提供了一套端到端的 3D 生成管線，支援從單一圖片或多視角圖片（正面、背面、左側、右側）生成 3D 模型。該專案目前整合了多種生成引擎，並具備以下關鍵特性：
- **生成引擎支援**：預設使用 mock 生成器做開發測試，並可透過環境變數 `IMAGE3D_GENERATOR` 切換至「Hunyuan3D-2」或「Pixal3D」（MIT 授權）。
- **4 色列印支援**：針對 Bambu Lab AMS 或 Prusa MMU 等多色 3D 列印機，提供 `color_mode=color4` 模式，可將模型依顏色分割為最多 4 個物件的 3MF 檔案。
- **自動化處理**：內建角色設定表（Character Sheet）自動分割功能，能從單張多視角圖片中自動偵測並分配各個視角面板。
- **除錯與預覽**：提供懸垂（overhang）熱圖功能，可在瀏覽器中即時檢視模型的支撐需求。

**技術要求與安裝**
該應用程式建議在 Linux、macOS 或 WSL2 環境下執行，並針對 GPU 運算需求設定了明確的 VRAM 門檻：
1. **環境準備**：需安裝 Python 3.12，若要使用實體模型生成，需具備 NVIDIA GPU 與 CUDA 12.8 驅動。
2. **安裝步驟**：
   ```bash
   python3 -m venv .venv
   .venv/bin/pip install --upgrade pip
   .venv/bin/pip install -r requirements.txt
   ```
3. **啟動服務**：執行 `./run.sh` 即可在 `http://127.0.0.1:8000` 存取 Web UI。

**開發者觀點**
作者透過此專案整合了多項 AI 3D 生成技術，並特別針對「Pixal3D」提供了隔離的 `.venv-pixal3d` 環境以解決依賴衝突。專案強調了對 3D 列印工作流的支援，例如透過 `meshproc` 進行 watertight 處理，確保生成模型在切片軟體（slicer）中的可用性。使用者可透過 `docs/SPEC.md` 查閱詳細 API 規格，或利用 `tests/` 目錄下的測試腳本驗證各項功能。

## 標籤

開源專案, 新產品, 其他, Hunyuan3D, Pixal3D, Bambu Lab