vault backup: 2026-06-03 10:30:42

hzh/Gen2D/13-标签驱动提示词工程.md

@@ -1,10 +1,17 @@
-# 13. 标签驱动提示词工程
-
-> **一句话概括**：40+ 预定义标签映射到精确的图像生成指令，保障风格一致性与管线友好性。
-
+---
+tags: [prompt-engineering, tag-mapping, ai, llm, fallback-pattern, template]
+create time: 2026-06-03 11:00
 ---
 
-## 处理流程
+# 13. 标签驱动提示词工程
+
+## 概述
+
+40+ 预定义标签映射到精确的图像生成指令，保障风格一致性与管线友好性。
+
+## 正文
+
+### 处理流程
 
 ```mermaid
 flowchart LR
@@ -24,11 +31,11 @@ flowchart LR
 
 ---
 
-## 标签分类体系
+### 标签分类体系
 
 系统内置 40+ 预定义标签，分为 **7 大类别**，每条标签精确映射到一条图像生成指令。
 
-### 内容类型 — 决定布局与格式
+#### 内容类型 — 决定布局与格式
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -40,7 +47,7 @@ flowchart LR
 | `序列帧` | 连续动画帧，网格排列，标注方向和帧数 |
 | `纸娃娃部件` | 可组合散件，统一比例和锚点 |
 
-### 美术风格 — 决定渲染技术
+#### 美术风格 — 决定渲染技术
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -50,7 +57,7 @@ flowchart LR
 | `矢量` | 干净几何形状，平滑曲线 |
 | `扁平` | 无阴影或极少阴影，纯色块面 |
 
-### 色调配色
+#### 色调配色
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -60,7 +67,7 @@ flowchart LR
 | `柔和` | 低饱和度，温和内敛 |
 | `单色` | 单一色相，明暗层次 |
 
-### 线条粗细
+#### 线条粗细
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -69,7 +76,7 @@ flowchart LR
 | `中等` | 1-2px，清晰明确 |
 | `粗线` | 2-4px，粗犷有力 |
 
-### 场景氛围
+#### 场景氛围
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -80,7 +87,7 @@ flowchart LR
 | `水下` | 珊瑚、水草、气泡 |
 | `沙漠` | 沙丘、仙人掌、绿洲 |
 
-### 光照效果
+#### 光照效果
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -89,7 +96,7 @@ flowchart LR
 | `戏剧` | 强烈明暗对比，聚光灯效果 |
 | `霓虹` | 高饱和彩色光源，赛博朋克辉光 |
 
-### 情绪基调
+#### 情绪基调
 
 | 标签 | 映射指令要点 |
 |------|-------------|
@@ -101,7 +108,7 @@ flowchart LR
 
 ---
 
-## 精灵图特殊处理
+### 精灵图特殊处理
 
 ```mermaid
 flowchart TD
@@ -121,9 +128,13 @@ flowchart TD
 
 这些指令对下游的 `SplitSprite` 切割算法至关重要。
 
+> [!question] 为什么精灵图需要特殊的网格布局指令？
+>
+> 如果不指定间隙要求，AI 生成的图片往往会让人物之间几乎没有空隙——人类艺术家这样做是为了最大化利用画布，但机器无法从中准确推断分割边界。**强制纯白间隙 = 人为制造"裂缝"**，让投影检测算法可以像翻书页一样逐页分离内容。这就是典型的「用约束换精度」的设计思路。
+
 ---
 
-## 未知标签回退
+### 未知标签回退
 
 当用户输入系统未预定义的标签时，不会报错，而是降级为通用风格描述：
 
@@ -141,7 +152,7 @@ func tagToInstruction(tag string) string {
 
 ---
 
-## PromptOptimizer 节点
+### PromptOptimizer 节点
 
 PromptOptimizer 是 Eino 管线的第一个节点，负责将标签指令组装为最终提示词。
 
@@ -186,13 +197,13 @@ flowchart LR
 
 ---
 
-## LLM 回退机制
+### LLM 回退机制
 
 当 LLM 不可用时（API Key 未配置 / 网络故障），系统自动降级到模板生成：
 
 ```mermaid
 flowchart TD
-    A["callLLMRefine"] --> B{"API Key\n已配置?"}
+    A["callLLMRefine"] --> B{"API Key 已配置?"}
     B -->|"否"| F["fallbackRefine\n模板回退"]
     B -->|"是"| C["调用 Chat API"]
     C --> D{"调用成功?"}
@@ -204,13 +215,9 @@ flowchart TD
 
 模板回退同样遵循标签驱动逻辑，保证即使没有 LLM 参与，生成的提示词也具备结构化和一致性。
 
----
-
 ## 关联文档
 
-| 文档 | 关系 |
-|------|------|
-| [05 - 生成管线](05-generation-pipeline.md) | PromptOptimizer 是管线第一阶段 |
-| [06 - 精灵图处理](06-sprite-processing.md) | 网格布局指令影响切割算法 |
-| [01 - 系统总览](01-system-overview.md) | 提示词工程在整体架构中的位置 |
-| [00 - 索引](00-index.md) | 返回文档总览 |
+- [[05-生成管线]] — PromptOptimizer 是管线第一阶段
+- [[06-精灵图处理]] — 网格布局指令影响切割算法
+- [[01-系统总览]] — 提示词工程在整体架构中的位置
+- [[00-索引]] — 返回文档总览