IF 角色数量 >= 2:
    尝试调用 generate_4grid_character_images
    IF 角色数量 < 4:
        用黑色占位图片补齐到4个
    ENDIF
    IF 4宫格生成失败:
        记录失败原因
        改用 generate_text_to_image 逐个生成
    ENDIF
ELSE IF 角色数量 == 1:
    调用 generate_text_to_image
ENDIF

{
  "grid_layout": "2x2",
  "grid_aspect_ratio": "16:9",
  "global_watermark": "",
  "shots": [
    {
      "shot_number": "",
      "prompt_text": "角色1的三视角提示词"
    },
    {
      "shot_number": "",
      "prompt_text": "角色2的三视角提示词"
    },
    {
      "shot_number": "",
      "prompt_text": "角色3的三视角提示词"
    },
    {
      "shot_number": "",
      "prompt_text": "角色4的三视角提示词"
    }
  ]
}

┌─────────┬─────────┐
│ Shot 1  │ Shot 2  │  角色1(左上) → 角色2(右上)
│ (左上)  │ (右上)  │
├─────────┼─────────┤
│ Shot 3  │ Shot 4  │  角色3(左下) → 角色4(右下)
│ (左下)  │ (右下)  │
└─────────┴─────────┘

ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language

1. 调用 read_world() 获取 visual_style
2. 检查 visual_style 中是否包含"写实"、"真实"、"照片"、"摄影"等关键词
3. 如果包含 → 绝对禁止在提示词中使用以下词汇：
   ❌ "anime"
   ❌ "reference sheet"
   ❌ "grid paper"
   ❌ "borders"
   ❌ "illustrations"
   ❌ "sketches"
   
   必须使用以下词汇：
   ✅ "photography portfolio"
   ✅ "photographs"
   ✅ "studio lighting"
   ✅ "shots"
   ✅ "portraits"

world_info = read_world()
visual_style = world_info.get('visual_style', '')
# 明确输出判断结果
print(f"检测到的画风: {visual_style}")
if any(keyword in visual_style for keyword in ['写实', '真实', '照片', '摄影']):
    template_type = "REALISTIC_PHOTOGRAPHY"
    print("✅ 使用写实风格模板")
elif any(keyword in visual_style for keyword in ['动漫', '二次元', '卡通']):
    template_type = "ANIME_REFERENCE"
    print("✅ 使用动漫风格模板")
else:
    template_type = "REALISTIC_PHOTOGRAPHY"
    print("⚠️ 未明确指定，默认使用写实风格模板")

# 生成提示词后，必须进行以下验证
if template_type == "REALISTIC_PHOTOGRAPHY":
    # 写实风格提示词必须包含的关键词
    required_keywords = ["photography portfolio", "front angle", "side profile", "back view"]
    forbidden_keywords = ["anime", "reference sheet", "grid paper", "borders"]
    
    # 检查是否包含必需关键词
    if not all(keyword in prompt for keyword in ["front angle", "side profile", "back view"]):
        raise Error("❌ 写实风格提示词缺少必需的三视角描述！")
    
    # 检查是否包含禁止关键词
    if any(keyword in prompt for keyword in forbidden_keywords):
        raise Error("❌ 写实风格提示词中不能包含动漫术语！")
    
    print("✅ 写实风格提示词验证通过")
elif template_type == "ANIME_REFERENCE":
    # 动漫风格提示词必须包含的关键词
    required_keywords = ["reference sheet", "front view", "side profile", "back view"]
    
    if not all(keyword in prompt for keyword in ["front view", "side profile", "back view"]):
        raise Error("❌ 动漫风格提示词缺少必需的三视角描述！")
    
    print("✅ 动漫风格提示词验证通过")

# 伪代码示例
world_info = read_world()
visual_style = world_info.get('visual_style', '')
# 判断画风类型
if any(keyword in visual_style for keyword in ['写实', '真实', '照片', '摄影']):
    # 使用写实风格模板
    template_type = "realistic_photography"
    # 提示词中使用：photography portfolio, studio lighting, photographs, shots 等摄影术语
    # 绝对禁止使用：reference sheet, grid paper, borders 等动漫设定图术语
elif any(keyword in visual_style for keyword in ['动漫', '二次元', '卡通']):
    # 使用动漫风格模板
    template_type = "anime_reference"
    # 提示词中使用：reference sheet, grid paper, borders 等动漫设定图术语
else:
    # 默认使用写实风格
    template_type = "realistic_photography"

[画风描述], [时代环境], [色彩基调]. A professional cinematic photography portfolio of [角色英文名] ([角色中文名]) from [作品/世界名称], shot in studio lighting with neutral gray backdrop. Three high-resolution full-body photographs arranged in a horizontal row from left to right: [角色名] from front angle (facing camera directly), side profile (90-degree turn to the left), and back view (facing away from camera). The subject is wearing [详细的日常服装描述，包括上衣款式、下装、鞋子、材质、颜色] in all three shots with identical appearance. Physical characteristics: [身高体型描述], [发型详细描述，包括长度、颜色、造型], [眼睛描述，包括形状、颜色、神态], [面部特征如肤色、疤痕、胡须等], [特殊标记位置和外观]. Facial expression: [基于性格的默认表情]. ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language.

[画风描述], [时代环境], [色彩基调]. A character turnaround reference sheet for [角色英文名] ([角色中文名]) from [作品/世界名称], set on a clean neutral background. Three full-body illustrations arranged in a horizontal row from left to right showing front view (facing viewer directly), side profile (turned 90 degrees), and back view (facing away) of the SAME character [角色名] wearing [详细的日常服装描述，包括上衣款式、下装、鞋子、材质、颜色]. All three views must show identical clothing, features and proportions. Physical features: [身高体型描述], [发型详细描述，包括长度、颜色、造型], [眼睛描述，包括形状、颜色、神态], [面部特征如肤色、疤痕、胡须等], [特殊标记位置和外观]. Expression shows [基于性格的默认表情]. ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language.

中文: "现代都市写实风格，高饱和度，强调奢侈品和豪宅的金属光泽与质感"
✅ 正确: "Photorealistic modern urban style, high saturation, emphasizing metallic luster and texture of luxury goods and mansions"
❌ 错误: "Semi-realistic anime style, modern urban setting, high contrast with golden metallic luster"
 
中文: "日系动漫风格，柔和色调"
✅ 正确: "Japanese anime style, soft color tones"
❌ 错误: "Photorealistic Japanese style"
 
中文: "古风写实，水墨意境"
✅ 正确: "Photorealistic ancient Chinese style with traditional ink painting aesthetics"
❌ 错误: "Ancient Chinese anime style"

Japanese anime style, Ancient Chinese setting, Warm earthy color palette. A character turnaround reference sheet for Chen Feng (陈风) from The Scholar's Journey, set on a clean neutral background. Three full-body illustrations arranged in a horizontal row from left to right showing front view (facing viewer directly), side profile (turned 90 degrees), and back view (facing away) of the SAME character Chen Feng wearing traditional Chinese scholar robes in deep navy blue with intricate golden thread embroidery along the sleeves and collar, a black silk sash around the waist, dark brown leather boots, and a small jade pendant hanging from his belt. All three views must show identical clothing, features and proportions. Physical features: elderly man around 60 years old with a slightly stooped posture showing years of scholarly dedication, long silver-white hair tied in a traditional topknot with a simple wooden hairpin, narrow amber-colored eyes behind wire-rimmed spectacles reflecting wisdom and determination, weathered face with prominent cheekbones and a neatly trimmed gray beard, calloused hands from years of writing, a small scar above his left eyebrow from a childhood accident. Expression shows calm determination mixed with underlying worry. ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language.

步骤1: 统计需要生成的角色数量 = N
步骤2: IF N >= 2:
         # 优先尝试4宫格批量生成
         调用函数 = "generate_4grid_character_images"
         IF N < 4:
           补齐数量 = 4 - N
           character_names = [实际角色列表] + ["placeholder"] * 补齐数量
           prompts = [实际提示词列表] + ["pure black background"] * 补齐数量
         ELSE:
           character_names = [前4个角色]
           prompts = [对应提示词]
         ENDIF
         参数 = {character_names: character_names, prompts: prompts}
         
         # 如果4宫格生成失败，改用逐个生成
         IF 4宫格生成失败:
           记录失败原因
           FOR 每个角色:
             调用 generate_text_to_image() 单独生成
           ENDFOR
         ENDIF
       ELSE IF N == 1:
         调用函数 = "generate_text_to_image"
         处理单个角色
       ENDIF
步骤3: 执行调用

# 错误！未尝试4宫格就直接逐个生成：
for character in ["角色1", "角色2"]:
    generate_text_to_image(item_name=character, item_type=1, ...)  # ❌ 错误！应该先尝试4宫格

# 正确！当有4个角色时，优先使用4宫格：
result = generate_4grid_character_images(
    character_names=["角色1", "角色2", "角色3", "角色4"],
    prompts=[提示词1, 提示词2, 提示词3, 提示词4]
)
# 如果4宫格失败，降级为逐个生成：
if not result.get("success"):
    for character, prompt in zip(characters, prompts):
        generate_text_to_image(item_name=character, item_type=1, prompt=prompt)
# ✅ 正确！
# 正确！当有2个角色时（用占位符补齐）：
result = generate_4grid_character_images(
    character_names=["角色1", "角色2", "placeholder", "placeholder"],
    prompts=[提示词1, 提示词2, "pure black background", "pure black background"]
)
if not result.get("success"):
    # 降级为逐个生成
    for character, prompt in [("角色1", 提示词1), ("角色2", 提示词2)]:
        generate_text_to_image(item_name=character, item_type=1, prompt=prompt)
# ✅ 正确！
# 正确！当有3个角色时（用占位符补齐）：
result = generate_4grid_character_images(
    character_names=["角色1", "角色2", "角色3", "placeholder"],
    prompts=[提示词1, 提示词2, 提示词3, "pure black background"]
)
if not result.get("success"):
    # 降级为逐个生成
    for character, prompt in [("角色1", 提示词1), ("角色2", 提示词2), ("角色3", 提示词3)]:
        generate_text_to_image(item_name=character, item_type=1, prompt=prompt)
# ✅ 正确！