Toonflow 国风二次元道具衍生状态生成约束手册:从衍生原则到提示词模板的完整解析

原创2026-09-21 21:34:271,872 阅读
文章标签:人工智能AI 应用媒体生成大模型AI AgentMCP 服务工作流自动化多模态语音音视频视频处理前端后端桌面应用

Toonflow 国风二次元道具衍生状态生成约束手册:从衍生原则到提示词模板的完整解析

本文以 Toonflow 开源 AI 短剧创作工具中「国风二次元新国潮」美术技能包内的 art_prop_derivative.md(道具衍生状态生成·约束手册)为骨架,结合仓库中技能加载与衍生资产生成的源码实现,系统讲解国风道具"状态变体"的生成方法论:衍生原则、四大状态类型、画面规范、材质变化规则、可直接复用的提示词模板,以及必守/严禁约束。读完本文,你将掌握在 AI 短剧生产流程中为关键道具批量产出"崭新 / 破损 / 染血 / 发光"等视觉状态图的一整套可落地提示词工程方案。


一、文档定位:一份可被 Agent 动态加载的道具衍生约束手册

在 Toonflow 仓库中,美术技能按风格组织在 data/skills/art_skills/ 目录下,每种风格(如 2D_chinese_guofeng 国风二次元新国潮)都包含 art_prompt/(美术提示词约束)与 driector_skills/(导演技法)两个子目录。本文聚焦的 art_prop_derivative.md 属于 art_prompt 目录中的六份约束手册之一,与以下同目录手册形成互补:

各手册均以 YAML frontmatter 开头声明元信息,例如本文档:

---
name: art_prop_derivative
description: 道具衍生状态生成 · 约束手册
metaData: art_skills
---

这份元信息并非摆设。在 skillsTools.ts 中,parseFrontmatter() 会严格校验技能文件必须具备 name 与 description 字段(缺任一字段即抛错),并将其注入 Agent 的上下文作为技能索引;当 Agent 的任务与描述匹配时,通过 activate_skill 工具把手册正文整体加载进上下文(参见 createSkillTools() 中 activate_skill 的实现,加载时会剔除 frontmatter 并返回 <skill_content> 包裹的正文)。换句话说,本文档是一份"机器可读、按需激活"的提示词工程资产,而非仅供人阅读的说明文字。

与道具设定图手册的衔接:art_prop.md 负责生成道具的基准态设定图(四宫格:正面/侧面/背面/特写),本文档负责在基准态之上派生视觉状态变体。两者共享同一套"纯道具静物展示、月白纯色背景"的画面语言,保证衍生图与设定图风格一致。


二、衍生原则:造型锚定、状态可读、叙事服务

道具衍生不是随意加特效,而是受控的视觉状态工程。手册开篇给出五条核心原则:

  1. 造型锚定 — 道具核心造型/轮廓在所有状态中必须可识别。无论处于崭新、破损还是发光状态,观众一眼仍能认出是同一件道具。
  2. 状态可读 — 状态差异必须一目了然,观众能立即区分"这是破损态"而非"这是另一种道具"。
  3. 叙事服务 — 每种状态变体服务于特定剧情节点,例如残片态对应"信物被毁"的关键转折,染血态对应"凶器现身"的悬念点。
  4. 渐进退化 — 损伤/老化状态应有合理的物理逻辑,磨损、破损、残片应呈现渐进关系,不能跳变。
  5. 纯道具独立展示 — 画面中只能出现道具本身,严禁任何人物、手部、肢体;道具不可处于被持有/佩戴/握持状态,必须以静物陈列方式独立呈现。

第 5 条与 art_prop.md 的第五条设计原则完全一致,是国风道具资产的一贯红线:道具资产为"可复用资产",若画面中出现手持状态,分镜阶段将无法把它独立地复用到任意镜头。

三、状态类型:四大类、十五种状态全覆盖

手册按叙事用途将道具状态划分为四类,每类给出"状态名—描述—适用道具—提示词"四要素,可直接作为提示词素材库使用。

3.1 使用状态(生命周期)

状态 描述 适用道具 提示词
崭新 完好无损、光泽如新 所有道具 崭新、完好无损、光泽如新
日常使用 微磨损、自然包浆 兵器/器物/饰品 日常使用痕迹、自然包浆
陈旧 明显年代感、色泽暗淡 器物/信物/卷轴 古旧斑驳、年代感、色泽暗沉

"使用状态"描述的是道具被正常使用后的自然痕迹,属于"时间线"维度,适合表现传承多年的信物、伴随主角征战的兵器。

3.2 损伤状态(破坏程度)

状态 描述 适用道具 提示词
微损 小裂纹/小缺口/轻微磨损 瓷器/玉佩/兵器 细微裂纹、轻微缺口
破损 明显裂缝/断裂/破碎 瓷器/饰品/兵器 裂缝明显、碎裂、断裂
残片 仅剩部分/碎片 瓷器/玉佩/信物 残片、碎片、仅存半块

损伤状态构成"微损 → 破损 → 残片"的渐进序列,与前文"渐进退化"原则呼应:玉碎、剑断、信物残缺,往往是短剧情感高潮的视觉锚点。

3.3 特殊状态(剧情事件)

状态 描述 适用道具 提示词
染血 血迹附着 兵器/信物/卷轴 血迹斑驳、染血、二次元渲染
浸水/湿润 水渍、湿润反光 卷轴/信物/纸张 浸水、纸张湿润、墨迹晕染
燃烧/焦损 焦黑边缘、火烧痕迹 卷轴/信物/木质品 边缘焦黑、火烧痕迹、炭化
发光/激活 内在能量、光芒四射 信物/法器/玉石 微微发光、内蕴光华、赛璐璐光效
包裹/封存 用布/盒子包裹 信物/饰品/秘物 锦布包裹、木盒封存、古风包装

特殊状态直接对应剧情事件节点:刺杀现场的染血凶器、水淹密室后晕染的密信、封印解除时发光的法器、即将开启的锦盒……这五种子状态是悬疑、动作、仙侠类短剧最常用的"剧情道具"素材。

3.4 环境适应状态(新增扩展)

状态 描述 适用道具 提示词
雪覆 积雪覆盖 兵器/器物/信物 雪花覆盖、积雪、冬日感
雨湿 雨水湿润 纸张/布/木质品 雨水湿润、水渍、潮湿感
风蚀 风沙磨损 户外器物/兵器 风沙痕迹、磨损、年代感
锈蚀 金属氧化 兵器/金属饰品 锈迹斑斑、氧化、岁月感

"环境适应状态"(手册标注"新增")补充了天气与地理维度:同一件兵器在雪原、雨夜、荒漠、古墓中呈现不同的环境痕迹,与场景的时间/天气变体(见 art_scene_derivative.md)配合使用,可显著提升短剧画面的环境叙事一致性。

四、状态变体画面规范:单状态图与状态对比图

衍生状态图的画面语言必须与设定图完全统一,手册分别约束两种出图方式:

单状态图(单个状态独立成图)

项目 约束
背景 月白纯色 #E8EAF5(与设定图一致)
光线 均匀照明,无硬阴影
角度 与原设定图正面图一致
比例 道具占画面主体 70%+

状态对比图(多状态并排展示)

项目 约束
布局 同一画面并排展示 2-3 种状态
标注 每种状态下方标注状态名
一致性 角度/光线/背景完全一致,仅状态不同

对比图适合"一览式"资产确认:导演/分镜 Agent 可以一次看到"崭新 / 破损 / 残片"三态,快速核对状态差异是否足够"可读"。背景色 #E8EAF5(月白)与道具设定图手册 art_prop.md 中"背景:月白纯色 #E8EAF5"的规范完全一致,这是保证衍生图可以直接替换/拼接入设定图集的技术细节。

五、材质状态变化规则:物理逻辑决定"怎么变"

不同材质在"崭新 → 日常 → 陈旧"的生命周期与损伤表现上遵循各自的物理规律,手册用一张矩阵表约束 AI 生成时的材质变化逻辑:

材质 崭新 → 日常 日常 → 陈旧 损伤表现
金属 亮光泽 → 微包浆 包浆 → 锈蚀斑点 缺口/卷刃/断裂
玉石 通透温润 → 微磨损 磨损 → 表面微裂 裂纹/碎裂/缺角
木质 新木纹理 → 自然包浆 包浆 → 色泽暗沉 开裂/断裂/虫蛀
瓷器 釉面光泽 → 微划痕 划痕 → 釉面暗淡 裂纹/碎裂/缺口
布/纸 崭新平整 → 微皱折 皱折 → 发黄变脆 撕裂/焦损/墨迹晕染

这张表同时服务于两条约束:一是物理逻辑正确性(玉会裂、铁会锈,反之"玉石生锈"即违规),二是渐进退化(每个阶段都有明确的中间形态)。在提示词生成时,应根据道具的基材(对应 art_prop.md 中的材质分类:精钢/玉/木/瓷/布纸)从表中选择对应行的变化描述填入模板。

六、提示词模板:单状态变体可直接套用

手册在第五部分给出"单状态变体"的完整提示词模板,以下为全文照录并附逐段解析:

基于{道具名}设定图,国风二次元道具衍生状态,
国风二次元,新国潮美学,日式动画渲染,赛璐璐平涂,细腻笔触,
{道具类型},{材质描述},
当前状态:{状态名},{状态视觉描述},
{材质表面变化描述},
纯道具静物展示,道具独立陈列,无人持有,无人佩戴,
同一画面四宫格(2×2):左上正面图(front view)+右上侧面图(side view)+左下背面图(back view)+右下细节特写(detail closeup),
月白纯色背景,均匀柔光,无硬阴影,
材质纹理超清晰,质感细腻,状态细节可辨,
国风二次元高清渲染,高细节,细腻线条,赛璐璐平涂感,
画面无字幕、无水印、无标题叠字,
画面中不能出现任何人物、手部、手指、肢体,道具不可处于被握持或佩戴状态

模板中的占位符替换规则如下:

占位符 取值来源
{道具名} 父资产名称,如"传国玉玺""霜华剑"
{道具类型} 来自 art_prop.md 的道具分类:兵器/饰品/生活器物/信物/文房四宝/节庆道具
{材质描述} 对应材质渲染词,如"玉质通透、温润如脂""金属冷光泽"
{状态名} 取自第三章状态类型表中的状态,如"残片""染血"
{状态视觉描述} 该状态对应的提示词列,如"残片、碎片、仅存半块"
{材质表面变化描述} 取自第五章材质变化矩阵的对应列

模板的关键设计有三点值得注意:

  1. 双重风格锁定:"国风二次元 + 新国潮美学 + 日式动画渲染 + 赛璐璐平涂"四词连用,与 README.md 中该风格包的定位(国风二次元动画、新国潮美学、日式动画渲染技法)完全对齐,杜绝模型漂移到写实渲染或西方奇幻风格。
  2. 四宫格布局继承:衍生状态图沿用设定图的"2×2 四宫格"(正面+侧面+背面+特写),而非单图输出,从而保证每个状态都有完整的多视角素材,分镜阶段可按需裁切。
  3. 负面约束前置:"无字幕、无水印、无标题叠字"与"不得出现人物/手部/肢体/握持佩戴"被显式写入正文,把最容易翻车的两类生成错误(水印污染、画面混入人物)直接堵死。

七、约束规则:必守 R1-R5 与严禁 X1-X6

手册以两张硬性规则表收尾,作为 Agent 生成后的自检清单:

必守(R 系列)

编号 规则
R1 道具核心造型/轮廓在所有状态中可识别
R2 状态变化须符合物理逻辑
R3 必须使用四宫格(2×2)布局:正面 + 侧面 + 背面 + 特写
R4 必须指定「月白纯色背景」,均匀柔光,无硬阴影
R5 必须包含「国风二次元 + 赛璐璐平涂」关键词

严禁(X 系列)

编号 严禁
X1 状态变化后道具不可识别
X2 违反物理逻辑的损伤(玉石生锈等)
X3 过度血腥/恐怖的损伤描绘
X4 出现任何人物形象,包括全身、半身、局部(手、手指、手臂等肢体)
X5 道具处于被持有、握持、佩戴、使用中的状态
X6 出现暗示人物存在的元素(如手持痕迹、佩戴视角、使用姿态)

R 系列是生成下限,X 系列是生成红线。其中 R1 与 X1 互为镜像(造型锚定)、R2 与 X2 互为镜像(物理逻辑)、X4-X6 层层递进(从"出现人物"到"出现暗示人物的痕迹"),这种"正反成对"的规则设计在提示词工程中非常实用——既要告诉模型做什么,也要明确告诉模型连"暗示"都不允许出现。

八、在 Toonflow 生产流程中的落地机制:从手册到衍生资产

道具衍生约束手册并非孤立文档,它嵌在 Toonflow 生产 Agent 的完整调用链中。从仓库源码可以梳理出如下落地路径:

1. 美术技能按项目风格动态装配

在 productionAgent/index.ts 的 createArtSkills() 中,生产 Agent 根据项目配置的 artStyle(如 2D_chinese_guofeng)拼接出 data/skills/art_skills/{artStyle}/driector_skills 路径,扫描该目录下的所有技能文件并解析 frontmatter,注入 activate_skill 工具供 Agent 按需激活。美术技能包内的 art_prompt/ 手册(含本文档)作为技能资源,通过 read_skill_file 工具在激活后按需读取(见 skillsTools.ts 中 createSkillTools() 的 read_skill_file 实现)。

2. 执行层 Agent 判定"哪些状态需要衍生"

在 production_execution_derive_assets.md 中,执行层衍生资产生成遵循如下提取规则:

资产类型 是否衍生 提取范围
角色 是 仅变身状态:服装 / 变身特效 / 变形
场景 是 仅时间变体(日景→夜景等)
道具 否(默认) 不提取任何变体

从该执行层文档看,默认流程下道具不自动衍生,角色与场景才是常态衍生对象。这意味着 art_prop_derivative.md 在体系中的角色是"能力储备 + 按需启用":当剧本出现关键道具的状态转折(如定情信物碎裂、凶器染血、法器觉醒发光)且导演/决策层判定需要资产级状态图时,美术 Agent 便依据本手册生成道具衍生状态。这也解释了为何手册状态表中"残片""染血""发光"等强叙事状态被重点覆盖——它们正是短剧戏剧冲突最依赖的道具视觉节点。

3. 衍生资产通过 add_deriveAsset 写入工作区

productionAgent/tools.ts 中定义了 deriveAssetSchema 与 add_deriveAsset 工具,衍生资产以 { assetsId, id, name, desc, type } 结构写入 o_assets 表(type 取值 role | tool | scene | clip)。手册第三、四节的状态名与状态描述,恰好对应 desc 字段要求的"<a href="https://link.gitcode.com/i/97cc0d432077ff222ead0882fe6762c2" target="_blank">与默认态的差异] · [视觉特征]"格式;art_prop_derivative.md 因此成为生成 name/desc 时选词的重要依据。相关衍生资产的增删也由生产侧路由暴露为 API,如 [deleteAssetsDireve.ts。

九、实践建议:如何用好这份约束手册

结合手册内容与源码机制,给出三条可落地的使用建议:

  1. 按叙事节点预置状态:在剧本改编/分镜规划阶段,把"关键道具的戏剧化时刻"标记出来(碎裂、染血、激活、封存等),再对照第三章状态表选取对应状态词,避免临场乱选导致状态与剧情脱节。
  2. 四宫格一次出齐,分镜按需裁切:坚持使用模板中的 2×2 四宫格布局出图,正面图用于剧情镜头、细节特写用于"发现裂纹/血迹"的局部特写镜头,一图多用,降低成本。
  3. 用正反规则做生成后自检:把 R1-R5 与 X1-X6 作为人工或二次校验的核对清单,重点检查"造型是否仍可识别""有无人物/肢体/手持暗示""背景是否仍是月白纯色",即可在进入分镜前拦截绝大多数废图。

参考资源:本手册所在美术技能包的完整内容见 2D_chinese_guofeng 风格目录(含 prefix.md 风格前缀与示例图);技能加载机制见 skillsTools.ts;生产流程调用链见 productionAgent/index.ts 与 productionAgent/tools.ts;执行层衍生规则见 production_execution_derive_assets.md。

登录后查看全文
Toonflow-app