# 本地语音（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-hans/packages/aigd.llamacpp

## 安装

使用 gamedev CLI，在项目文件夹中运行：

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

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.llamacpp`，然后点击 **Add to Project**。更多：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` | 当 Auto 不适合你的电脑时，选择 CUDA（NVIDIA）、Vulkan（大多数 GPU）、Metal（Mac）或 CPU。默认：Auto。 |
| `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，也从不调用它。

## 会下载什么

上游发布版本，按 tag 固定并用 sha256 校验：`ggml-org/llama.cpp` [`b12556`](https://github.com/ggml-org/llama.cpp/releases/tag/b12556)（commit `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 不托管它们。
````
