小说剧本转分镜

当前 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 改编演示，不代表脚本生成的结果。

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，不生成虚构角色或情节。
• 人物关系、动机、结局或关键动作无法确认时，明确标注并交给用户判断，不猜成事实。
• 不承诺爆款、过审、播放量或收益；遵守安全和版权边界。