在 fnOS 安装 AngeVoice

fnOS 安装的重点不是参数填得多，而是选对运行方式并保证数据目录不会随升级丢失。

安装前准备

• 确认 NAS 架构和可用硬件。没有可用 NVIDIA GPU 时选择 CPU。
• 为模型和输出预留独立存储位置。
• 如果计划使用 MP3、OGG 或 M4A，确认应用配置中已启用 FFmpeg。

安装流程

1. 在 fnOS 应用中心或本地安装入口选择 AngeVoice FPK。
2. 根据设备选择 CPU、标准 GPU 或 Legacy GPU；不确定时先用 CPU。
3. 确认模型、配置、凭据、参考音频和输出目录都映射到持久化存储。
4. 启动应用，等待健康状态由 loading 变为 ok 或 idle。
5. 进入管理后台修改默认管理员凭据，并保存 API Key。

推荐的运行默认值

KOKORO_PROCESS_ISOLATION_ENABLED=true
MOSS_PROCESS_ISOLATION_ENABLED=true
ZIPVOICE_PROCESS_ISOLATION_ENABLED=true
ANGEVOICE_STARTUP_PRELOAD_ENABLED=false
ANGEVOICE_RESTART_AFTER_IDLE_UNLOAD=false

默认按需加载更适合 NAS：空闲时可以释放模型，首次请求再唤醒。只有在你明确需要更低首包延迟且内存充足时，才开启启动预载。

音频转码

ANGEVOICE_FFMPEG_ENABLED=true
ANGEVOICE_FFMPEG_BINARY=ffmpeg
ANGEVOICE_FFMPEG_TIMEOUT_SECONDS=30

只需要 WAV 或 PCM 时可以保持关闭。出现 MP3/OGG/M4A 转换失败时，先确认 fnOS 应用内能执行 ffmpeg -version。

升级前后检查

1. 备份 credentials/、config/、prompts/ 和需要保留的输出。
2. 记录当前运行方式和端口。
3. 升级后检查 /health、/v1/models 和一次真实语音合成。
4. 确认管理员账号、API Key 和 Voice Profile 仍然存在。