# 本機圖像與影片生成

> 使用 stable-diffusion.cpp 在這台電腦上生成圖像、材質與短影片：NVIDIA（CUDA）、AMD 與 Intel（Vulkan）、Apple 晶片（Metal）或處理器。新增「圖像生成」與「影片」工具。模型是獨立套件（Z-Image Turbo、FLUX、SDXL、Qwen-Image、LTX-2.5、Wan 2.2 等）。

- ID: `aigd.sdcpp`
- 來源: 官方 (第一方 `aigd.*`)
- 分類: 執行環境
- 發佈者: AI Game Dev (`aigd`), 已驗證
- 最新版本: 1.3.1 (發佈於 2026-11-22)
- 授權條款: MIT
- 需要 AI Game Dev 應用程式: `>=0.20.0`
- 原生程式碼: 否
- 評分: 尚無評分
- HTML 頁面: https://ai-game.dev/zh-hant/packages/aigd.sdcpp

## 安裝

在專案資料夾中，使用 gamedev CLI：

```bash
gamedev pkg add aigd.sdcpp
```

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.sdcpp`，然後點 **加入專案**。更多資訊：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 1.3.1 | 2026-11-22 | `>=0.20.0` | 最新 |
| 1.3.0 | 2026-11-21 | `>=0.20.0` | - |
| 1.2.0 | 2026-11-18 | `>=0.20.0` | - |
| 1.1.3 | 2026-11-06 | `>=0.20.0` | - |
| 1.1.2 | 2026-10-13 | `>=0.20.0` | - |
| 1.1.1 | 2026-10-12 | `>=0.20.0` | - |
| 1.1.0 | 2026-10-12 | `>=0.20.0` | - |
| 1.0.1 | 2026-10-11 | `>=0.20.0` | - |
| 1.0.0 | 2026-10-05 | `>=0.20.0` | - |

## 說明

````markdown
# 本機圖像與影片生成（`aigd.sdcpp`）

讓 AI Game Dev 在這台電腦上，用你自己的 GPU（或是對在處理器上實測的模型，改用它的處理器），透過 [stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp) 生成圖像、材質與短影片的執行環境。一切都在你的電腦上製作，而且完全不花錢。它是下方每個本機圖像與影片模型套件背後的引擎：安裝一次，之後再加入適合你的電腦與遊戲的模型。

這個套件只有資料（`aigd-package.json`，沒有程式碼）。它告訴 AI Game Dev 要為你的電腦下載哪一個 stable-diffusion.cpp 版本，並在工作階段的工具列加入兩個開關：**圖像生成**與**影片**。兩者在工作階段中都要由你開啟才會啟用。應用程式會自行下載、檢查並執行這支程式。

## 功能

- 為你的電腦下載正確的 stable-diffusion.cpp 組建（NVIDIA CUDA、適用於 AMD / Intel / 其他 GPU 的 Vulkan、Apple 晶片 Mac 上的 Metal，或處理器），並以 sha256 檢查。
- 讓代理用你安裝的模型套件製作圖像（文字轉圖像、圖像轉圖像、編輯）與短片（文字轉影片、圖像轉影片）。
- 當你沒有指定模型時，挑選已下載且最適合你這台電腦的模型（**預設模型**與**預設影片模型**設定可覆寫此選擇）。
- 為圖像與短片執行同一個共用佇列（見下文），並可選擇設定生成時間上限與 GPU 記憶體預算。

## 模型是獨立套件

這個套件不含任何模型。請從套件瀏覽器安裝模型套件（例如 `aigd.image-z-image-turbo`，短片則例如 `aigd.video-ltx25` / `aigd.video-wan22-ti2v-5b`），然後在模型面板下載它的檔案。未經你確認不會下載任何東西，而且你會先看到大小——代理要求模型時也一樣。

### 圖像模型

| 套件 | 最適合 | 電腦 |
|---|---|---|
| [Z-Image Turbo](https://ai-game.dev/packages/aigd.image-z-image-turbo) | 快速的擬真與插畫圖像、短文字 | NVIDIA 4 GB+，其他 GPU 8 GB+，整合式 GPU（較慢） |
| [FLUX.1 schnell](https://ai-game.dev/packages/aigd.image-flux1-schnell) | 以 4 步生成插畫、照片、圖示、Sprite | NVIDIA 8 GB+ |
| [FLUX.2 klein 4B](https://ai-game.dev/packages/aigd.image-flux2-klein-4b) | 插畫、圖示、Sprite | Apple 晶片 Mac |
| [SDXL 1.0](https://ai-game.dev/packages/aigd.image-sdxl-base) | 一般插畫、概念美術、照片 | NVIDIA 8 GB+ |
| [Animagine XL 4.0](https://ai-game.dev/packages/aigd.image-animagine-xl-4) | 動漫角色與插畫 | NVIDIA 8 GB+ |
| [Juggernaut XL v9](https://ai-game.dev/packages/aigd.image-juggernaut-xl-v9) | 電影感的擬真圖像 | NVIDIA 8 GB+ |
| [RealVisXL V5.0](https://ai-game.dev/packages/aigd.image-realvisxl-v5) | 擬真的人物、場景、產品 | NVIDIA 8 GB+ |
| [Qwen-Image](https://ai-game.dev/packages/aigd.image-qwen-image) | 文字呈現、UI  mockup、海報 | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2512](https://ai-game.dev/packages/aigd.image-qwen-image-2512) | 文字呈現與提示詞遵循，20 步 | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2512 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-2512-lightning) | 同樣內容，4 步完成 | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-Edit-2511](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511) | 依指示編輯圖像，20 步 | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-Edit-2511 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511-lightning) | 同樣內容，4 步完成 | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2.1 Turbo Q3](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q3) | 透明背景（非商業用途） | NVIDIA 6–8 GB, 16 GB RAM |
| [Qwen-Image-2.1 Turbo](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo) | 透明背景（非商業用途） | NVIDIA 8 GB+，16 GB RAM；或 Windows PC 的處理器 |
| [Qwen-Image-2.1 Turbo Q8](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q8) | 透明背景（非商業用途） | NVIDIA 12 GB+, 24 GB RAM |

### 影片模型

| 套件 | 最適合 | 電腦 |
|---|---|---|
| [LTX-2.5](https://ai-game.dev/packages/aigd.video-ltx25) | 含同步音效、文字或起始畫面的短片 | NVIDIA 16 GB+, 48 GB RAM |
| [Wan 2.2 TI2V 5B](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b) | 無音效的短片，開放授權 | NVIDIA 12 GB+, 16 GB RAM |

每個模型套件都會註明自己的授權條款，以及實測所在的電腦。

## 範例指令

- 「開啟圖像生成，做一個銀色鑰匙的道具欄圖示。」
- 「用本機圖像模型畫一張沙漠峽谷的概念圖。」
- 「做一段 5 秒的標題畫面場景短片，有風聲和遠處的雷聲。」

## 一個佇列，一顆 GPU

圖像與短片共用同一個佇列和一顆 GPU，同一時間只會載入一個模型。載入模型需要一段時間，所以只要已載入的模型還有工作等著，它就會繼續佔用 GPU，圖像和短片都一樣。等到已載入的模型沒有事情可做，或另一個模型的工作已等待至少 5 分鐘，才輪到另一個模型。接著由工作等待最久的模型取得下一次機會。切換模型絕不會中斷已在執行的圖像或短片：它會先完成。只有在你停止它、達到你設定的生成時間上限，或代理取消短片時，它才會提早停止。

## 會下載哪些東西

上游發行版，以標籤釘住並以 sha256 檢查：`leejet/stable-diffusion.cpp` [`master-1106-532d2c1`](https://github.com/leejet/stable-diffusion.cpp/releases/tag/master-1106-532d2c1)。Linux 版本則維持在 [`master-929-3f8527a`](https://github.com/leejet/stable-diffusion.cpp/releases/tag/master-929-3f8527a)：上游自該版本起在 Ubuntu 26.04 上建置 Linux，而那些執行檔需要 glibc 2.43。應用程式會為你的電腦挑選一種版本。你可以用 `backend` 設定變更它。

| 版本 | 電腦 | 下載 |
|---|---|---|
| `win-x64-cuda12` | Windows，NVIDIA GPU（驅動程式 572.61 或更新，compute capability 6.1 或更新） | 976 MB（程式 + NVIDIA CUDA runtime） |
| `win-x64-vulkan` | Windows，AMD / Intel / 其他 GPU | 30 MB |
| `win-x64-cpu` | 沒有可用 GPU 的 Windows：處理器。速度慢（在快速桌機上每張 512 px 圖像約一分鐘，筆電上則要數分鐘），且僅適用於在該環境實測過的模型（Qwen-Image-2.1 Turbo） | 18 MB |
| `darwin-arm64-metal` | Apple 晶片 Mac，**macOS 26 或更新版本** | 38 MB |
| `linux-x64-vulkan` | Linux x64 搭配 Vulkan GPU，**glibc 2.38 或更新版本**（Ubuntu 24.04+、Debian 13+）。需要安裝 `libgomp.so.1` 與 `libvulkan.so.1` | 37 MB |

只要 GPU 版本能執行，就絕不會選用 CPU 版本；若仍要使用，請在模型面板把後端選為 **CPU**。

**文字編碼器。** 模型中用來讀取提示詞的部分，可以跑在 GPU 或處理器上（`textEncoder` 設定，模型面板中的 **Text encoder**）。**Auto** 會保留各模型實測時的設定：Qwen-Image-2.1 Turbo Q3 與 Wan 2.2 把它放在處理器上，以配合其顯示卡的容量。**CPU** 可釋出約 2 GB 顯示記憶體，代價是每張圖像多一、兩秒；**GPU** 在顯示卡還有空間時稍快一些，但對於實測時放在處理器上的模型，可能會記憶體不足。

**Linux 為預覽版。** Linux 組建尚未在真實的 Linux GPU 上測試過。它可以被選取，並標示為「預覽」。

應用程式絕不會安裝驅動程式或系統函式庫。如果有缺少的東西，它會告訴你要安裝什麼。

## 授權條款

- stable-diffusion.cpp — MIT，© leejet（[授權條款](https://github.com/leejet/stable-diffusion.cpp/blob/master/LICENSE)）。
- ggml — MIT（上游提供的是 [ggml-org/ggml](https://github.com/ggml-org/ggml) 的分支 [leejet/ggml](https://github.com/leejet/ggml)）。
- NVIDIA CUDA runtime（cudart、cuBLAS），僅含於 Windows CUDA 版本 — 由上游依 [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) 再散布。
- NVIDIA CUTLASS，僅含於 Windows CUDA 版本 — BSD-3-Clause（[授權條款](https://github.com/NVIDIA/cutlass/blob/main/LICENSE.txt)）。
- 本套件 — MIT。每個模型套件都會註明自己的授權條款。

所有檔案都從上游的 GitHub 發行版下載。AI Game Dev 不代為托管。
````
