Manju Script Generator

小说转漫剧剧本生成器 v2.0 — 专业导演引擎，集成Seedance 2.0/Toonflow/Inkos导演思维系统

漫剧剧本生成器 v2.0 (Manju Script Generator)

概述

专业导演引擎 — 基于 Seedance 2.0 Skill OS、Toonflow、Inkos 等工业级系统蒸馏

输入小说内容 + 角色配置，输出结构化的漫剧分镜剧本，包含：

• 导演引擎: 每场先分析戏剧功能，定一个意图，所有镜头语言服务于这个意图
• 场景拆分: 按剧情逻辑切分，每场 3-8 个分镜，每段 2-5 秒
• Shot Contract: 每个分镜按专业合约输出（景别/镜头感/支撑/运镜/构图/灯光/焦点/光圈/调度）
• 类型片导演指南: 7种类型片（古风仙侠/都市/科幻/悬疑/动作/言情/恐怖）的导演手册
• Continuity Ledger: 自动生成跨分镜一致性总账
• 多角色输出: 完整剧本 / 导演笔记 / 摄影笔记
• 抗AI味词汇表: 自动清理 cinemetic/beautiful/stunning 等弱词

使用方法

ash python3 skills/manju-script-generator/generate.py --input novel.txt --characters characters.json --output script.json --style 古风仙侠 --tone 浪漫

或以Markdown格式输出：

ash python3 skills/manju-script-generator/generate.py -i novel.txt -c characters.json -o script.md -f markdown

导演视角：

ash python3 skills/manju-script-generator/generate.py -i novel.txt -c characters.json -o director_notes.md -f director

摄影视角：

ash python3 skills/manju-script-generator/generate.py -i novel.txt -c characters.json -o dp_notes.md -f dp

输入参数

参数	类型	必填	默认	说明
--input/-i	string	否	-	小说文件路径
--text/-t	string	否	-	小说文本内容
--characters/-c	string	是	-	角色配置JSON文件或JSON字符串
--output/-o	string	否	script.json	输出文件路径
--style/-s	string	否	通用	视觉风格: 通用/古风仙侠/现代都市/科幻/悬疑/动作/言情/恐怖/奇幻/喜剧
--tone/-n	string	否	中性	情绪基调: 浪漫/悲伤/紧张/清新/黑暗/梦幻/中性
--format/-f	string	否	json	输出格式: json/markdown/director/dp

输出格式

JSON 输出

包含完整剧本 + Continuity Ledger：

json { "title": "剧本标题", "style": "古风仙侠", "tone": "浪漫", "director_voice": "全片统一的导演意图", "scenes": [ { "id": "S01", "dramatic_function": "establish", "intention": "建立世界的壮美与孤独", "location": "城墙之上", "time": "黄昏", "weather": "晴朗", "atmosphere": "宁静，略带忧伤", "shots": [ { "id": "S01-C01", "duration": "3s", "shot_type": "大远景", "lens_feel": "广角24mm，暖调柔光", "camera_support": "三脚架", "movement": "固定镜头", "composition": "三分法构图，人物在右1/3", "lighting": "黄昏暖光，侧逆光勾勒轮廓", "focus": "全景清晰", "aperture": "f/8", "blocking": "林月独自站在城墙边缘", "action": "林月眺望远方，风吹动长裙", "dialogue": "", "sound": "风声，远处钟声", "transition": "淡入" } ] } ], "continuity_ledger": { "characters": { "林月": {"outfit": "青色长裙", "hair": "长发及腰", "makeup": "清冷淡妆"} }, "lighting": {"S01": "黄昏暖光，侧逆光"}, "color": {"S01": "暖色(橙红)，暖调5800K"} } }

导演引擎

戏剧功能分析

每个场景先判断"这场戏是干什么的"，再决定镜头语言：

功能	代码	说明	典型处理
建立	establish	建立场景世界观	大远景/远景，固定镜头，缓慢节奏
转折	turn	情节转折点	特写反应，急推，音乐骤变
揭示	reveal	真相大白	缓慢推近，变焦，静默
对峙	confront	正面冲突	过肩镜头，手持，快切
化解	resolve	冲突收束	拉远，叠化，音乐渐弱
情感	emotional	情感高光	近景/特写，眼神光，推近
动作	action	动作场面	手持，广角，快速切换
对话	dialogue	对话推进	过肩/中景，正反打
悬疑	suspense	铺垫伏笔	浅景深，暗角，缓慢推进

导演信条

引自 Seedance 2.0 导演引擎：

1. 读场景的戏剧功能，定一个意图 — 所有镜头/灯光/调度/表演/声音服务于这个意图
2. 不要说"电影级" — 直接指导：镜头怎么动，光从哪里来，演员怎么走位
3. 一场一个意图 — 不堆砌形容词，弱词(beautiful/amazing/stunning)是垃圾
4. 全片统一声音 — 不跳风格，保持统一的导演手法

类型片导演指南

类型	镜头感	节奏	灯光	色调	转场
古风仙侠	暖调柔光，长焦	慢速推拉	自然光+侧逆光	青绿+暖橙	叠化
现代都市	锐利冷调	快节奏手持	霓虹高对比	冷灰+宝蓝	跳切
科幻	超广角畸变	缓慢推拉	冷调荧光	冷蓝+银白	划像
悬疑	浅景深暗角	缓慢急推	单光源大阴影	暗蓝+灰	黑场
动作	广角动态	手持快速切换	高对比闪光	高饱和暖色	跳切匹配剪辑
言情	中焦柔光	慢速环绕	黄金时刻眼神光	暖橙+粉	叠化淡入
恐怖	广角畸变	极慢急转	极低调闪烁	暗黑+血红	跳切黑场

Shot Contract 系统

每个分镜按专业合约输出，包含14个字段：

字段	说明	示例
shot_type	景别	近景/中景/全景/特写
lens_feel	镜头感	50mm标准镜头，柔光
camera_support	支撑方式	三脚架/手持/斯坦尼康
movement	运镜	缓慢推近/固定镜头
composition	构图	三分法构图/黄金分割
lighting	灯光	黄昏暖光，侧逆光
focus	焦点	焦点锁定在人物面部
aperture	光圈	f/2.8
blocking	调度	角色站位和走位
action	动作	角色动作描述
dialogue	台词	台词(如有)
sound	音效	风声，远处钟声
transition	转场	淡入/切/叠化
duration	时长	3s

连续性总账

自动生成跨场景/分镜的一致性总账，确保：

• 角色服饰/发型/妆容不变
• 场景灯光方案不变
• 道具位置连续
• 色调方案统一

抗AI味词汇表

自动清理提示词中的弱词，避免AI味：

beautiful/stunning/gorgeous/breathtaking/dramatic/emotional/vibrant → 删除 cinematic → directed epic → wide atmospheric → low key moody → underexposed 电影级/大片感/唯美/极致/高级感 → 删除 震撼 → 强视觉冲击

示例

参见 examples/input/ 和 examples/output/ 目录