第五版奇幻 - 声音

第五版奇幻 - 语音

**第五版奇幻**的地下城主会大声朗读其叙述，镇民也会说出他们的台词。此包
包含**自然英语语音**的库：[Kokoro-82M](https://huggingface.co/hexgrad/Kokoro-82M)，一个在你自己的
PC 处理器上运行的小型神经文本转语音模型。你说出或听到的任何内容都不会经过网络。

## 如何使用

1. 使用你的模组管理器安装此包（它会一并带来第五版奇幻）。
2. 在游戏中，打开控制台（F5）并输入 `fef voice on` —— 或在配置中设置 `[Voice] Narration = true`。
3. 首次使用时，模组会从模型自己的 GitHub 发布页下载语音模型及其 54 种语音
（约 337 MB，仅一次，经 SHA-256 校验）到 `BepInEx/config/FifthEditionFantasy/Voices`。在准备就绪之前，
Windows 自带的语音会进行朗读。

之后，每张地下城主叙述卡、NPC 台词和镇民的回复都会被朗读。地下城主有自己独特的语音（默认是一位英国讲故事者）；
每个 NPC 都会获得自己的语音，且每次都是同一个。

| 命令 | 作用 |
|---|---|
| `fef voice` | 状态 |
| `fef voice on` / `off` | 开启或关闭叙述 |
| `fef voice dm bm_fable` | 更改地下城主的语音（`fef voice list` 显示全部 28 种英语语音） |
| `fef voice speed 1.1` / `volume 0.7` | 速度和音量 |
| `fef voice test Hello there` | 说点什么 |

**其他语言**不需要此包：它们使用 Windows 自带的语音（设置 > 时间和语言 > 语音 可添加更多）。

**速度：** 在典型的游戏 PC 上，一句话的准备时间远低于说出它所花费的时间（在 6 核 CPU 上约为实时速度的 0.4 倍）。
它仅在使用时占用你一半的 CPU 线程，最多六个。

## 包含内容

| 文件 | 内容 | 许可证 |
|---|---|---|
| `Microsoft.ML.OnnxRuntime.dll`、`onnxruntime.dll`、`onnxruntime_providers_shared.dll`、`libonnxruntime.so` | Microsoft ONNX Runtime 1.20.1（Windows 和 Linux） | MIT |
| `MisakiSharp.dll` | Lyrcaxis 的 MisakiSharp 2.2.0 - 英语文本转音素（无 eSpeak） | Apache-2.0（见 `licenses/`） |
| `compat/*.dll` | System.Buffers、System.Memory、System.Numerics.Vectors、System.Runtime.CompilerServices.Unsafe - 仅当游戏运行时缺少它们时才加载 | MIT |

所有文件均为发布者原版，未经更改。许可证文本和声明位于 `licenses/`。Kokoro 模型（Apache-2.0，
由 hexgrad 提供；ONNX 导出由 thewh1teagle 完成，MIT；训练数据致谢：Koniwa CC BY 3.0、SIWIS CC BY 4.0）在首次使用时
单独下载。