English · 简体中文 · 日本語

制作第一本有声书

第一个目标：三句英文旁白、一个 Ryan 预置声音、一份检查过的 MP3。 先用原创示例文本走通流程，再处理整本书。打开文件后点击 Download raw file，或将下面的文字保存为 UTF-8 编码的 first-audiobook.txt。

The rain stopped just before dawn. A small bird landed on the garden gate. By the time the kettle sang, the sky was bright.

这是随文档提供的原创文本，适用仓库的 MIT 许可。示例没有对话，只需要旁白。此处刻意使用同一份英文文本和 Ryan，方便对照中英文步骤；处理中文书籍时再改为对应语言和声音。

1. Setup（设置）

按LLM 设置连接已运行的 LLM，点击 Test Connection，再点击 Save Configuration；测试本身不会保存设置。选择 TTS Mode → Local Model (built in)、Device → Auto (best available)、TTS Language → English。准确设置 Runs on this machine's GPU?，修改后再保存。

**成功检查点：**连接测试通过，并收到配置保存确认。

流程图仅标明操作顺序和检查点，不代表实际生成结果。

2. Script（脚本）

在 Select Book/Novel (Text, Markdown, or EPUB) 选取示例，文件会自动上传。可选旁白字段留空。点击 Generate Annotated Script。

**成功检查点：**生成结束，三句话均被保留，条目为旁白；分段数量可能不同。

3. Voices（声音）

在旁白卡片选择 Custom voice → Ryan，角色风格留空，等待 saved。

**成功检查点：**Ryan 保持选中，没有未保存更改警告。

4. Editor（编辑器）

先点击第一行的 Gen 并试听。效果正常后点击 Render Pending。

**成功检查点：**每行均有可播放的音频，没有失败或未完成的行。Text integrity 只比较保存的文本和原文，不检查实际发音；仍需听辨漏读和重复。

5. Editor → Result（结果）

点击 Merge All，阅读原文比对确认；遇到意外差异先取消并修正。在 Result 试听，点击 Download MP3。

**成功检查点：**下载文件可以打开，三句话完整且顺序正确。合并可能跳过缺失或损坏的片段后仍生成文件，请查看日志。

某一步失败时，先停在该步排查。 连接问题见 LLM 设置；首次 TTS 下载或报错请查看 Pinokio 的 Terminal 和常见问题。缺少权重时，首次生成会下载，耗时可能比后续生成更长。

远程 LLM 会收到标注文本，外部 TTS 会收到合成输入。只处理有权使用的书籍与声音。Save Current 不是完整备份：不保留仅在 Editor 中修改的片段、音频或导出文件。切换书籍前请备份当前工作。

完成第一份 MP3 之后

• 手动 LLM 模式及其他服务
• 更多声音、别名、角色描述、克隆及 LoRA
• 审校、检查点与长书
• M4B、章节与 Audacity 导出
• Designer、Dataset、Training、Preparer、Voice Lab 与 Reports

安全停止并在之后继续

• 对于脚本生成，Generate Annotated Script（生成标注脚本） 会从兼容的检查点继续。Start over（重新开始） 会丢弃该文本已保存的生成进度。
• Save snapshot（保存快照） 会保留正在运行的脚本任务中已经完成的部分。快照是部分结果，不是完整的书籍。
• 对于音频，请取消当前渲染，等待其停止，之后使用 Render Pending（渲染待处理片段） 处理未完成的片段。
• Save Current（保存当前内容）不是完整的项目备份。 它不会保存仅在 Editor 中进行的片段编辑、已渲染音频或导出文件。Load（加载） 会替换当前脚本和片段，并清空当前导出文件。在切换离开仍在制作中的音频项目之前，请按照更新与备份进行备份。

如果某一步失败，请保留日志，在重复启动相同任务之前先查看故障排查。

参考来源

已对照项目主分支（main）提交 8006baa05294139de4d64eb16683b6c77624cb9a 检查：核心操作教程、当前界面、已保存脚本的行为，以及音频组装。