# 本地音效与音乐（Stable Audio 3）

> 在 AI Game Dev 中本地生成音效与音乐的运行时，基于 sa3.cpp（Stable Audio 3 的 C++/ggml 移植版），可在 CUDA、Vulkan、Metal 或 CPU 上运行，无需 Python。它可运行 Stable Audio 3 Small SFX、Small Music 和 Medium 模型，这些模型是独立的包。

- ID: `aigd.sa3cpp`
- 来源: 官方 (第一方 `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.sa3cpp

## 安装

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

```bash
gamedev pkg add aigd.sa3cpp
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.sa3cpp`，然后点击 **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.sa3cpp`）

本地音效与音乐是一个运行时，让 AI Game Dev 应用借助 Stable Audio 3 模型在你自己的电脑上生成音效和器乐音乐。它使用 [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp)，这是 Stability AI 的 Stable Audio 3 的 C++/ggml 移植版，无需 Python。所有内容都在你的电脑上生成，生成过程不产生任何费用。它适合那些想要音效、拟音、UI 音效和背景音乐、又不想依赖云服务的游戏开发者。

## 功能

- 下载适合你电脑的 sa3.cpp 发行版（Windows、Apple 芯片的 Mac，以及作为预览的 Intel Mac 和 Linux；CUDA、Vulkan、Metal 或 CPU），用 sha256 校验后运行。
- 在会话的 Tools 栏中添加 **SFX & Music** 开关。除非你在会话中打开它，否则该开关一直处于关闭状态。
- 每个音效运行一次 `sa3-generate`，不保留常驻服务。

本包只包含数据（`aigd-package.json`，无代码）。它告诉 AI Game Dev 该为你的电脑下载哪个 sa3.cpp 发行版。程序本身由应用负责下载、校验和运行。

## 模型是独立的包

本包不含任何模型。先从 Packages 浏览器安装模型包，再到 Models 面板下载其文件：

| 包 | 生成内容 |
|---|---|
| [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx)（`aigd.audio-stable-audio-3-small-sfx`） | 音效与拟音，最长 60 秒 |
| [Stable Audio 3 Small Music](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-music)（`aigd.audio-stable-audio-3-small-music`） | 器乐音乐，最长 2 分钟 |
| [Stable Audio 3 Medium](https://ai-game.dev/packages/aigd.audio-stable-audio-3-medium)（`aigd.audio-stable-audio-3-medium`） | 器乐音乐，最长 6 分 20 秒 |

未经你确认，不会下载任何内容。你会先看到文件大小和模型许可证。Stable Audio 3 模型有自己的许可证，其中包含收入上限、注册义务和 "Powered by Stability AI" 声明。每个模型包的 README 都写明了这些条款。

其他本地音乐、音效和语音模型通过 [Local audio generation](https://ai-game.dev/packages/aigd.audiocpp)（`aigd.audiocpp`）运行。

## 示例请求

打开 **SFX & Music** 并安装好模型后，你就可以用大白话向智能体提要求：

- “给玩家的枪做一个简短的激光射击音效。”
- “生成踩在雪地上的脚步声，4 秒。”
- “为主菜单做一段 90 秒的轻松 lo-fi 器乐。”

## 下载内容

应用下载的是上游发行版，按 tag 固定并用 sha256 校验：`betweentwomidnights/sa3.cpp` [`v0.2.4`](https://github.com/betweentwomidnights/sa3.cpp/releases/tag/v0.2.4)（commit `3152253`）。上游将其标记为预发布版。应用会为你的电脑选择其中一个变体。

| 变体 | 电脑 | 下载 |
|---|---|---|
| `win-x64-cuda12` | Windows，NVIDIA GPU（驱动 572.61 或更高版本，计算能力 6.1 或更高） | 752 MB（程序 + NVIDIA CUDA 12.8 运行时） |
| `win-x64-vulkan` | Windows，AMD / Intel / 其他 GPU | 19 MB（核心 + Vulkan 后端） |
| `win-x64-cpu` | Windows，无可用 GPU（速度慢；Medium 需要 GPU） | 7 MB |
| `darwin-arm64-metal` | Apple 芯片 Mac，macOS 13.3 或更高版本 | 11 MB（由上游签名并公证） |
| `darwin-x64-cpu` | Intel Mac，macOS 13.3 或更高版本（仅 CPU） | 11 MB |
| `linux-x64-vulkan` | Linux x64，配有 Vulkan GPU，**glibc 2.38 或更高版本**（Ubuntu 24.04+、Debian 13+）。需要 `libgomp.so.1` 和 `libvulkan.so.1` | 22 MB |
| `linux-x64-cpu` | Linux x64，无可用 GPU，glibc 2.38 或更高版本。需要 `libgomp.so.1` | 12 MB |

Windows CUDA 变体使用上游的独立压缩包，它是唯一包含 CUDA 运行时的压缩包（`cudart64_12`、`cublas64_12`、`cublasLt64_12`）。拆分版 `cuda` 压缩包只包含 `ggml-cuda.dll`，并要求系统范围内安装 CUDA 12.8 运行时。

**预览版。** Linux 和 Intel Mac 变体尚未在真实硬件上测试，上游也未验证 CPU 生成。它们可以被选择，并标记为“预览”。

应用从不安装驱动或系统库。如果有缺失，它会告诉你需要安装什么。

## 许可证

- sa3.cpp — MIT，© 2026 betweentwomidnights（[许可证](https://github.com/betweentwomidnights/sa3.cpp/blob/3152253622d8b54deec14bfb0938371a5bd20439/LICENSE)）。
- ggml — MIT，© The ggml authors（[ggml-org/ggml](https://github.com/ggml-org/ggml)）。
- cpp-httplib（MIT，© yhirose）、yyjson（MIT，© YaoYuan）、Signalsmith Stretch 和 Signalsmith Linear（MIT，© Signalsmith Audio）。它们的许可证文件随压缩包一同分发。
- RoyalCities RC-stable-audio-tools 提示词引擎（MIT，© 2023 Stability AI），改编自 `sat-*` 工具（[源码](https://github.com/RoyalCities/RC-stable-audio-tools)）。AI Game Dev 不运行这些工具；许可证位于压缩包的 `THIRD_PARTY_NOTICES.md` 中。
- Microsoft Visual C++ 运行时（`msvcp140`、`vcruntime140`、`vcruntime140_1`、`vcomp140`），仅存在于 Windows 变体中。上游依据 Visual Studio 2022 可分发代码条款重新分发它。
- NVIDIA CUDA 运行时（cudart、cuBLAS），仅存在于 Windows CUDA 变体中。上游依据 [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) 重新分发它，`NVIDIA-CUDA-EULA.txt` 随压缩包一同提供。
- 本包 — MIT。运行时不含任何模型权重。每个模型包都声明自己的许可证。

所有文件均从上游 GitHub 发行版下载。AI Game Dev 不托管这些文件。
````
