Toonflow 国风二次元道具衍生状态生成约束手册:从衍生原则到提示词模板的完整解析
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 目录中的六份约束手册之一,与以下同目录手册形成互补:
- art_character.md:角色图像生成约束
- art_character_derivative.md:角色衍生(变身)状态约束
- art_prop.md:道具图像生成约束(设定图基准态)
- art_scene.md 与 art_scene_derivative.md:场景及其时间变体约束
- art_storyboard_video.md:分镜视频生成约束
各手册均以 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负责生成道具的基准态设定图(四宫格:正面/侧面/背面/特写),本文档负责在基准态之上派生视觉状态变体。两者共享同一套"纯道具静物展示、月白纯色背景"的画面语言,保证衍生图与设定图风格一致。
二、衍生原则:造型锚定、状态可读、叙事服务
道具衍生不是随意加特效,而是受控的视觉状态工程。手册开篇给出五条核心原则:
- 造型锚定 — 道具核心造型/轮廓在所有状态中必须可识别。无论处于崭新、破损还是发光状态,观众一眼仍能认出是同一件道具。
- 状态可读 — 状态差异必须一目了然,观众能立即区分"这是破损态"而非"这是另一种道具"。
- 叙事服务 — 每种状态变体服务于特定剧情节点,例如残片态对应"信物被毁"的关键转折,染血态对应"凶器现身"的悬念点。
- 渐进退化 — 损伤/老化状态应有合理的物理逻辑,磨损、破损、残片应呈现渐进关系,不能跳变。
- 纯道具独立展示 — 画面中只能出现道具本身,严禁任何人物、手部、肢体;道具不可处于被持有/佩戴/握持状态,必须以静物陈列方式独立呈现。
第 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 的道具分类:兵器/饰品/生活器物/信物/文房四宝/节庆道具 |
{材质描述} |
对应材质渲染词,如"玉质通透、温润如脂""金属冷光泽" |
{状态名} |
取自第三章状态类型表中的状态,如"残片""染血" |
{状态视觉描述} |
该状态对应的提示词列,如"残片、碎片、仅存半块" |
{材质表面变化描述} |
取自第五章材质变化矩阵的对应列 |
模板的关键设计有三点值得注意:
- 双重风格锁定:"国风二次元 + 新国潮美学 + 日式动画渲染 + 赛璐璐平涂"四词连用,与 README.md 中该风格包的定位(国风二次元动画、新国潮美学、日式动画渲染技法)完全对齐,杜绝模型漂移到写实渲染或西方奇幻风格。
- 四宫格布局继承:衍生状态图沿用设定图的"2×2 四宫格"(正面+侧面+背面+特写),而非单图输出,从而保证每个状态都有完整的多视角素材,分镜阶段可按需裁切。
- 负面约束前置:"无字幕、无水印、无标题叠字"与"不得出现人物/手部/肢体/握持佩戴"被显式写入正文,把最容易翻车的两类生成错误(水印污染、画面混入人物)直接堵死。
七、约束规则:必守 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。
九、实践建议:如何用好这份约束手册
结合手册内容与源码机制,给出三条可落地的使用建议:
- 按叙事节点预置状态:在剧本改编/分镜规划阶段,把"关键道具的戏剧化时刻"标记出来(碎裂、染血、激活、封存等),再对照第三章状态表选取对应状态词,避免临场乱选导致状态与剧情脱节。
- 四宫格一次出齐,分镜按需裁切:坚持使用模板中的 2×2 四宫格布局出图,正面图用于剧情镜头、细节特写用于"发现裂纹/血迹"的局部特写镜头,一图多用,降低成本。
- 用正反规则做生成后自检:把 R1-R5 与 X1-X6 作为人工或二次校验的核对清单,重点检查"造型是否仍可识别""有无人物/肢体/手持暗示""背景是否仍是月白纯色",即可在进入分镜前拦截绝大多数废图。
参考资源:本手册所在美术技能包的完整内容见 2D_chinese_guofeng 风格目录(含 prefix.md 风格前缀与示例图);技能加载机制见 skillsTools.ts;生产流程调用链见 productionAgent/index.ts 与 productionAgent/tools.ts;执行层衍生规则见 production_execution_derive_assets.md。