# 本機語音（llama.cpp）

> 用 llama.cpp 的語音工具在這台電腦上朗讀文字，離線執行且不佔用你的額度：在 NVIDIA、AMD、Intel 或 Apple GPU 或 CPU 上產生語音台詞、旁白與暫代對白。Kokoro、Chatterbox Turbo 等模型是另外的套件。

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

## 安裝

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

```bash
gamedev pkg add aigd.llamacpp
```

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

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 說明

````markdown
# 本機語音（`aigd.llamacpp`）

AI Game Dev 的本機語音執行環境：它用 [llama.cpp](https://github.com/ggml-org/llama.cpp) 的語音工具（`llama-tts`）在這台電腦上朗讀文字。一切都在你的電腦上離線完成，不會用到任何 AI Game Dev 額度。它適合想要語音台詞、旁白與暫代對白，又不想把文字送到雲端的遊戲開發者。語音模型本身，例如 [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro) 與 [Chatterbox Turbo](https://ai-game.dev/packages/aigd.tts-chatterbox-turbo)，則是另外的套件。

## 你可以做什麼

- 在自己的電腦上為 NPC 對白、短促呼喊、教學語音與旁白配音。
- 離線替原型的每一句台詞草擬語音，想跑幾次就幾次，完全不佔用額度。
- 在 NVIDIA、AMD 或 Intel GPU、Apple 晶片上，或 CPU 上執行語音。

## 範例請求

- 「用我電腦上的 Kokoro 朗讀這五句守衛台詞，並存到專案裡。」
- 「用 Chatterbox Turbo 在本機替教學腳本配音。」
- 「用本機語音模型替所有村民產生暫代對白。」

## 運作方式

這個套件只有資料（`aigd-package.json`，沒有程式碼）。它告訴 AI Game Dev 該為你的電腦下載哪一個 llama.cpp 發行版。它的語音模型和其他本機語音模型一樣，透過工作階段的 **Audio** 工具使用。應用程式會自行下載、檢查並執行該程式：每句語音執行一次 `llama-tts`，離線進行，因此兩次生成之間記憶體不會殘留任何東西。

設定（依機器而定）：

| 設定 | 作用 |
|---|---|
| `backend` | 當「自動」不適合你的電腦時，選擇 CUDA（NVIDIA）、Vulkan（大多數 GPU）、Metal（Mac）或 CPU。預設：自動。 |
| `newModelsDefault` | 往後你下載的此執行環境語音模型，代理是否可以使用（預設 `allowed`，或 `blocked`）。你已經下載的模型會保留各自的設定。 |

## 模型是另外的套件

這個套件不含任何模型。每個語音模型套件（[`tts-kokoro`](https://ai-game.dev/packages/aigd.tts-kokoro)、[`tts-chatterbox-turbo`](https://ai-game.dev/packages/aigd.tts-chatterbox-turbo)）都會列出它的兩個檔案：模型本身與其音訊投影器。未經你確認不會下載任何東西，而且你會先看到大小與模型的授權。

不使用 eSpeak：llama.cpp 是借助模型檔案內附的發音字典來讀出 Kokoro 的英文文字。這個套件不隨附 eSpeak-ng，也從不呼叫它。

## 會下載哪些東西

上游發行版，以標籤固定版本並以 sha256 檢查：`ggml-org/llama.cpp` [`b12556`](https://github.com/ggml-org/llama.cpp/releases/tag/b12556)（提交 `50518b64c6f2191a116d2760042f106c4b3387d7`）。應用程式會為你的電腦挑選一種變體。

| 變體 | 電腦 | 下載 |
|---|---|---|
| `win-x64-cuda12` | Windows，NVIDIA GPU（驅動程式 551.61 或更新） | 756 MB（程式 + NVIDIA CUDA 12.4 執行環境） |
| `win-x64-vulkan` | Windows，AMD / Intel / 其他 GPU | 39 MB |
| `win-x64-cpu` | Windows，沒有支援的 GPU | 25 MB |
| `darwin-arm64-metal` | Apple 晶片的 Mac，macOS 13.3 或更新 | 16 MB |
| `linux-x64-vulkan` | Linux x64，具備 Vulkan GPU、glibc 2.34 與 libstdc++ GLIBCXX_3.4.30 或更新（Ubuntu 22.04+、Debian 12+）。需要 `libgomp.so.1`、OpenSSL 3（`libssl.so.3`、`libcrypto.so.3`）與 `libvulkan.so.1` | 37 MB |
| `linux-x64-cpu` | Linux x64，glibc 2.34 與 GLIBCXX_3.4.30 或更新。需要 `libgomp.so.1` 與 OpenSSL 3 | 23 MB |

**Linux 是預覽版。** llama.cpp 的 Linux CUDA 組建會把 CUDA 執行環境放在程式不會去查看的個別資料夾，因此在配備 NVIDIA GPU 的 Linux 上會改跑 Vulkan 變體。

## 需求

- Windows 組建需要 Microsoft Visual C++ 2015–2022 執行環境（`MSVCP140.dll`、`VCRUNTIME140_1.dll`），大多數 Windows 電腦已經有；壓縮檔本身並未隨附。
- Kokoro 夠小，在 CPU 上也能跑得不錯。
- 應用程式從不安裝驅動程式或系統函式庫。若有缺少，它會告訴你要安裝什麼。
- AI Game Dev 0.32.0-beta.6 或更新。

## 授權

- llama.cpp 與 ggml — MIT，© 2023-2026 The ggml authors（[授權](https://github.com/ggml-org/llama.cpp/blob/b12556/LICENSE)）。
- LLVM OpenMP 執行環境（`libomp.dll`），位於 Windows 變體中 — Apache-2.0 with LLVM exception（[授權](https://github.com/llvm/llvm-project/blob/main/openmp/LICENSE.TXT)）；壓縮檔內含 `LICENSE-LLVM-OpenMP`。
- NVIDIA CUDA 執行環境（cudart、cuBLAS、cuBLASLt），僅位於 Windows CUDA 變體中 — 由上游依 [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) 轉散布。
- 這個套件 — MIT。每個模型套件各自聲明其授權；模型權重仍依其原始發行版的授權。

限制：除了分享檔案時保留這些聲明之外，沒有其他限制。

所有檔案都從上游 GitHub 發行版下載。AI Game Dev 不自行託管這些檔案。
````
