v2.5.0 新增

选择范围并导出
- 打开工程,在左侧剧本树中右键章节,选择「导出剧本…」。
- 选择格式,在「导出范围」勾选一个或多个章节。目录可整组勾选,章节下面会展示所包含的片段;选择一章会包含它的全部片段。
- 在「文件组织」选择「合并为一个文件」或「每章单独一个文件」。顺序沿用剧本树的章节排列。
- 在「指令类型」选择「仅文本」或所需类型,按需纳入禁用指令。筛选影响实际导出内容。
- 查看右侧预览。按章输出时先切换预览章节;Markdown 与 Word 可以查看排版,Ren’Py 可检查脚本与转换提醒。
- 点击导出,选择工程目录之外的文件或文件夹。看到完成提示后打开输出文件,检查文字、章节层级和范围。
选择格式
| 格式 | 文件 | 用途与边界 |
|---|---|---|
| 纯文本 | .txt | 通读、配音或自定义排版;不携带原项目素材 |
| 表格 | .csv | 用电子表格处理结构化台词;不是 .xlsx 工作簿 |
| JSON | .json | 保留所选指令的结构与属性;导出 Schema 是 letsgal-script-export,不能直接当章节文件导入 |
| Ren’Py | .rpy | 将可转换指令导出为标准 Ren’Py 脚本;不能完整还原 Studio 的所有演出 |
| Markdown | .md | 带章节与片段层级的阅读稿 |
| Word 文档 | .docx | 带章节层级、角色与对白排版的文档 |
.rpy 导出分别处理,不应把 Studio 的 studio ... 语法直接交给 Ren’Py 运行。
自定义纯文本导出
纯文本格式提供自定义脚本入口,可以载入或编辑 JavaScript,然后运行脚本生成输出,检查预览后再保存。范围或脚本发生变化后需要重新运行。 脚本应返回字符串,或包含text 与 extension 的对象。单次运行上限为 2 秒,输出上限为 5 MiB,载入脚本文件上限为 256 KiB。扩展名使用 1~12 位字母或数字。按章输出时脚本会分别处理每个有导出内容的章节。
保存与失败处理
- 导出不会替代工程保存、Git 同步或素材备份;先确认编辑器保存状态。
- 输出位置必须在工程目录之外,避免覆盖工程文件。
- 按章输出如果部分文件保存失败,提示会列出已保留的文件;先检查输出目录,再重试。
- 选择为空或筛选后没有内容时,先调整章节与指令类型。