ViMax的CharacterExtractor角色提取一段剧本如何变成结构化角色卡【免费下载链接】ViMaxViMax: Agentic Video Generation (Director, Screenwriter, Producer, and Video Generator All-in-One)项目地址: https://gitcode.com/GitHub_Trending/ai/ViMaxViMax 是一个集导演、编剧、制片人和视频生成器于一体的开源视频生成系统。本文聚焦它流程里一个容易被忽略的环节CharacterExtractor 如何从故事文本里自动识别关键人物并把每个人的外貌整理成结构化角色卡供后续角色肖像和视频生成直接使用。为什么视频生成前要先做角色提取把文字变成视频难点往往不在能不能出画面而在画面里的人像不像同一个人。剧本里同一个角色可能一会儿叫名字、一会儿是她、一会儿是年轻女子很多故事对人物外貌只字未提或只提了一半。这些情况如果靠人工整理角色设定既慢又容易前后不一致而后续每一镜头的图像生成都依赖这份设定来维持角色一致性。CharacterExtractor 就是干这件事的它读一遍完整文本输出一份角色清单清单里每个人的外观特征都是补齐过的、可画进画面的。角色提取整体流程从一段文本到 characters.json实现位于 agents/character_extractor.py思路比想象中朴素——没有复杂的 NLP 规则核心就是一次带严格约束的大模型调用打包输入整段剧本或故事被包进SCRIPT标签和一段系统提示词一起发给大模型。系统提示词给模型定了身份——顶级电影剧本分析专家——并附上一组硬性指导规则下一节展开。约束输出输出格式不是自由文本而是预先定义好的 JSON 结构。模型必须返回一个角色列表每个角色包含哪些字段在提示词里就已写好。校验落盘返回的 JSON 用 Pydantic 模型做校验Pydantic 是 Python 里常用的数据验证库字段不对会直接报错转换成CharacterInScene对象后由流水线写成characters.json存进工作目录供 pipelines/idea2video_pipeline.py 和 pipelines/script2video_pipeline.py 中的角色肖像生成环节读取。失败重试整个调用挂了 tenacity 的装饰器最多重试 3 次单次网络波动或输出小故障不会让整条流水线停摆。角色对象本身的字段定义在 interfaces/character.py 的CharacterInScene里idx编号、identifier_in_scene本场景中的称呼、is_visible该角色在这个场景里是否露面、static_features和dynamic_features下面细说。值得看的设计同一角色的多个称呼会被合并系统提示词里明确要求所有指向同一实体的名字必须归到同一个角色下并从中选一个最合适的作为标识文本里没给名字的允许用那位年轻女子咖啡店服务员这类基于身份或体貌特征的说法来代称如果是真实名人则保留其真实姓名。这样年轻女子她那位顾客就不会被拆成三个人。静态特征与动态特征分开记这是角色卡最有实用性的拆分静态特征指长相、体型这类基本不变的东西动态特征指服装、配饰、随身物品这类随场景换的东西。分开记录意味着同一角色换装出镜时生成端可以只改动态部分。同时规则明确禁止把性格、身份、人物关系写进这两类特征——角色卡只负责画得出来的事。没描写的特征会被合理补全且要求互相区分剧本里没写或只写了一半的外貌模型需要基于上下文设计出合理、具体、可视觉化的特征——比如写清衣服颜色和大眼睛高鼻梁这类具体体貌而不是含糊的形容词。更关键的一条是在合理范围内不同角色的外形要刻意做得有区分度避免生成出一批脸长一样的角色。输出解析对脏 JSON有容错LLM 返回的 JSON 有时会带尾随逗号这类小瑕疵。项目用的是 utils/robust_json_parser.py 里一个容忍尾随逗号的 Pydantic 解析器而不是默认解析器减少模型答对了但格式崩了的失败率。快速跑起来三步启用角色提取克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/ai/ViMax cd ViMax uv sync然后在 configs/script2video.yaml 里填好对话模型、图像生成器、视频生成器的 API key在main_script2video.py中填上剧本、用户要求和画风运行脚本即可。角色提取会在流程中自动执行结果以characters.json的形式保存在工作目录默认.working_dir/script2video下不需要单独调用。能用来做什么剧本分析快速拆解剧本里的人物清单为分镜和镜头设计打底游戏开发自动生成 NPC 的角色设定档案动画制作为 2D/3D 动画提供统一的角色原型虚拟形象根据文本描述直接产出虚拟角色的外观描述角色提取只是文生视频链条的第一块拼图但它决定了后面所有镜头里人物像不像同一个人。把这一步做扎实ViMax 整条流水线的输出质量才有稳定的基础。【免费下载链接】ViMaxViMax: Agentic Video Generation (Director, Screenwriter, Producer, and Video Generator All-in-One)项目地址: https://gitcode.com/GitHub_Trending/ai/ViMax创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考