剧本导入会把外部文档中的角色名、表情、对白和旁白转换为 Studio Block，并追加到当前打开的 Fragment。
v1.8.0 新增
LetsGal Studio 剧本导入工作台

​
打开导入工作台

  1. 打开要接收内容的章节或 Fragment。
  2. 保持编辑器处于「卡片」视图。
  3. 点击工具栏中的「导入剧本」。
  4. 选择文件，或把文件拖入导入面板。
导入前会显示预览和统计。确认前不会修改当前 Fragment。

​
Excel 列映射

Excel 可以不使用 AI，直接把工作表列映射为 Studio 字段。
1

选择工作表

工作簿包含多个 Sheet 时，先选择要导入的工作表。
2

映射三列

分别选择「角色名」「表情」和「对话内容」列。三项不能指向同一列。
3

检查预览

确认角色、表情、正文和匹配结果，再执行导入。
转换规则：
  • 角色名为空的行按旁白导入。
  • 对话内容为空的行自动跳过。
  • 连续且同名的已匹配角色会组成连续对白。
  • 角色和表情按项目中已有名称匹配。
  • 未匹配的角色名或表情会保留原文，导入后可以继续调整。
导入前先在 Studio 创建主要角色和常用表情，可以提高自动匹配结果。Excel 首行使用明确的「角色」「表情」「对白」列名，也更容易自动推断映射。

​
AI 智能识别

AI 模式适合列结构不固定的 Excel，以及 Word、PDF和常见文本文件。
  1. 到 设置 → AI 配置 Provider、API Key 和模型。
  2. 在导入工作台选择「AI 智能识别」。
  3. 必要时填写自定义识别 Prompt，说明角色、表情和旁白的标记方式。
  4. 点击「开始 AI 识别」。
  5. 检查转换预览后导入当前 Fragment。
Studio 只会把本地提取出的文字发送给你配置的模型服务，不发送原文件。自定义 Prompt 应说明原文结构和保留规则，不需要要求模型输出特定 JSON。 示例： 
角色名写在【】中；角色名后的圆括号是表情；
以“场景：”开头的行按旁白处理；保持原文顺序，不要润色或续写。

​
图片与扫描 PDF

图片或没有可提取文字的扫描 PDF 需要 OCR。当前导入链路不会直接把图片或二进制文件发送给文本模型；出现「此文件需要 OCR」时，请先使用 OCR 工具转换为可复制文本或带文字层的 PDF，再重新导入。

​
导入后检查

  • 检查未匹配角色和表情。
  • 检查旁白与对白是否正确区分。
  • 检查连续对白的分组边界。
  • 检查原文中的舞台说明是否需要改成场景、声音或演出 Block。
  • 从导入位置运行预览，确认变量、资源和 Fragment 引用完整。
导入结果会追加到当前 Fragment。导入前确认打开的是目标位置；内容较多时建议先在新 Fragment 中导入并检查，再复制到正式剧本。