Repository navigation
First Audiobook zh CN
第一个目标：三句英文旁白、一个 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，方便对照中英文步骤；处理中文书籍时再改为对应语言和声音。
按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?，修改后再保存。
**成功检查点：**连接测试通过，并收到配置保存确认。
流程图仅标明操作顺序和检查点，不代表实际生成结果。
在 Select Book/Novel (Text, Markdown, or EPUB) 选取示例，文件会自动上传。可选旁白字段留空。点击 Generate Annotated Script。
**成功检查点：**生成结束，三句话均被保留，条目为旁白；分段数量可能不同。
在旁白卡片选择 Custom voice → Ryan，角色风格留空，等待 saved。
**成功检查点：**Ryan 保持选中，没有未保存更改警告。
先点击第一行的 Gen 并试听。效果正常后点击 Render Pending。
**成功检查点：**每行均有可播放的音频，没有失败或未完成的行。Text integrity 只比较保存的文本和原文，不检查实际发音；仍需听辨漏读和重复。
点击 Merge All，阅读原文比对确认；遇到意外差异先取消并修正。在 Result 试听，点击 Download MP3。
**成功检查点：**下载文件可以打开，三句话完整且顺序正确。合并可能跳过缺失或损坏的片段后仍生成文件，请查看日志。
某一步失败时，先停在该步排查。 连接问题见 LLM 设置；首次 TTS 下载或报错请查看 Pinokio 的 Terminal 和常见问题。缺少权重时，首次生成会下载，耗时可能比后续生成更长。
远程 LLM 会收到标注文本，外部 TTS 会收到合成输入。只处理有权使用的书籍与声音。Save Current 不是完整备份：不保留仅在 Editor 中修改的片段、音频或导出文件。切换书籍前请备份当前工作。
- 手动 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 检查：核心操作教程、当前界面、已保存脚本的行为，以及音频组装。