小说剧本转分镜

把小说或剧本拆成可拍摄的中文分镜表和结构化 JSON

Install

openclaw skills install @xxjrq/novel-script-storyboard

小说剧本转分镜

当前 AI 必须阅读用户提供的原文并完成改编判断。scripts/self_test.py 不分析原文、不生成角色目标、冲突、场景或镜头;它只校验 AI 已写好的 JSON 并排版 Markdown。不得把脚本自测、示例或结构校验说成已经完成改编。

输入

  • 用户提供的小说、剧本或故事梗概,可直接阅读对话内容或用户提供的文件。
  • 可选:目标时长、画幅、风格、受众和已有角色设定。
  • 先明确本次改编范围。不要要求用户额外抄写证据清单。

改编步骤

  1. 阅读原文,梳理实际出现的人物、行为、地点、时间、对白与事件顺序。
  2. 依据用户目标拆分场景和镜头。每个镜头写可见动作、画面、景别/运镜、声音、时长,并标出对应原文锚点。
  3. 人物动机、关系、因果等原文没有交代时,标成“原文未说明”或列入 gaps。不把推测写成原作事实;新增镜头表现或创作补充须在 creative_note 明确标记。
  4. JSON 和 Markdown 中的角色、场景、镜头与顺序保持一致。存在未解决缺口时使用 needs_review;材料不足以改编时输出 needs_more_source 和具体缺少内容。仅在改编确实完成且无待确认缺口时使用 complete。
  5. 有文件工具时,先由当前 AI 写完整 storyboard.json,再用脚本校验和排版。失败时修复 JSON;不要改用脚本生成的固定模板冒充完成结果。

输出与命令

字段要求见 分镜 JSON 字段。成功示例是虚构的 AI 改编演示,不代表脚本生成的结果。

bash
python3 scripts/self_test.py self-test
python3 scripts/self_test.py render --input /absolute/ai-storyboard.json --output /absolute/new-output-dir

脚本只检查字段、数据类型、时长合计和状态,不会检查原文引用是否真实、是否漏情节或改编质量。输出目录若已有 storyboard.json 或 storyboard.md 会拒绝覆盖;输入文件不会被修改。

失败与边界

  • 只有标题、没有可改编内容时,使用 needs_more_source,不生成虚构角色或情节。
  • 人物关系、动机、结局或关键动作无法确认时,明确标注并交给用户判断,不猜成事实。
  • 不承诺爆款、过审、播放量或收益;遵守安全和版权边界。