@playcraft/cli 0.0.40 → 0.0.42

package/project-template/.claude/agents/refs/README.md

@@ -0,0 +1,73 @@
+# Agent Refs — 渐进披露详细参考层（L2）
+
+这个目录是 **Agent 指令分层架构的第二层（L2）**，存放各 Agent 的详细工作流、脚本示例和决策参考。
+
+## 分层架构
+
+| 层              | 位置                                    | 加载时机                               | 内容                                                            | 大小目标                    |
+| --------------- | --------------------------------------- | -------------------------------------- | --------------------------------------------------------------- | --------------------------- |
+| **L1 常驻指令** | `.claude/agents/<role>.md`              | sub-agent invoke 时全量加载            | Goals (Top3) / Agent Conduct / Identity / Workflow / Hard Rules | < 280 行（Developer < 220） |
+| **L2 按需细则** | `.claude/agents/refs/<role>-<topic>.md` | sub-agent 在指定 Phase/任务前主动 read | 详细流程 / 命令示例 / 决策树                                    | 不限                        |
+| **L3 平台工具** | `.claude/skills/<tool>/SKILL.md`        | sub-agent 使用工具时按 trigger 加载    | 工具用法 / 脚本模板                                             | 不限                        |
+
+## 渐进披露原则
+
+- **L1（agent .md）必须精简**：每次 sub-agent invoke 都全量加载，token 成本高
+- **L2（refs/）按需读取**：agent .md 或 SKILL.md 在对应阶段显式指引，形如：`> Read refs/ta-pipeline-cookbook.md`
+- **L3（SKILL）工具触发**：使用具体工具前读取对应 SKILL
+- **每个 refs 文件必须有至少一处显式引用**：未被引用的文件应删除——LLM 无法自行发现未引用的文档
+
+## 文件清单
+
+| 文件                                   | 引用来源                                                       | 内容摘要                                                                |
+| -------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `pm-workflow-detail.md`                | `agents/pm.md`                                                 | Step 1-8 详细分析流程 + 调度元信息指南 + 直接意图模式                   |
+| `docs/team/atom-plan-format.md`        | `pm.md`, `atom-plan.template.md`, `playcraft-workflow`         | atom-plan JSON 主 + MD 辅；Gate #1 validate/link 流程                   |
+| `designer-dimension-axis.md`           | `agents/designer.md`                                           | 2D/2.5D/Isometric/3D 维度处理指南                                       |
+| `designer-master-composite-recipes.md` | `skills/playcraft-storyboard`, `agents/designer.md`            | 游戏类型 MC prompt 配方 + 模型多样性策略 + 故障恢复                     |
+| `designer-art-style-catalog.md`        | `skills/playcraft-art-style-guide`                             | 9 种美术风格完整目录（prompt/模型/管线/错误）                           |
+| `designer-color-audio-recipes.md`      | `skills/playcraft-ad-psychology`, `agents/designer.md`         | 按游戏类型配色方案 + 音频情绪弧参数                                     |
+| `designer-deliverable-spec.md`         | `agents/designer.md`                                           | designer-handoff-v2 交付规格、Handoff Pack、Phase 2 规则                |
+| `designer-handoff-v2-checklist.md`     | `designer-style-exploration-flow.md` Step 5                    | Gate #2b：Coverage Matrix、Palette Locked、Motion Notes                 |
+| `skills/playcraft-asset-state-sheet`   | `agents/designer.md`, `designer-deliverable-spec.md`           | ASR 双板规范                                                            |
+| `designer-style-exploration-flow.md`   | `agents/designer.md`                                           | Phase 1 Step 2–5：MC 生成、#2a 包、ASR 双板、#2b 收尾与 STOP            |
+| `developer-impl-cookbook.md`           | `agents/developer.md`, `refs/developer-phase1-flow.md`         | index.html 骨架 + Atlas/WebP+JSON 绑定 + CTA handler                    |
+| `developer-phase1-flow.md`             | `agents/developer.md`                                          | `ui_pass` + `gameplay_pass` + `ui_rework` 全流程                        |
+| `developer-dev-handoff.md`             | `agents/developer.md`, `refs/developer-impl-cookbook.md`       | Dev 迭代节奏 + ui_ready/ready + upstream blockers                       |
+| `reviewer-convergence-eval.md`         | `agents/reviewer.md`                                           | design_check + ui_diff + load_check 流程                                |
+| `reviewer-six-dimension-eval.md`       | _(deprecated)_                                                 | 指向 `reviewer-convergence-eval.md`                                     |
+| `ta-tools-reference.md`                | `agents/technical-artist.md`                                   | 全工具命令表（AI 生成/3D/精灵图/图像/音频）                             |
+| `ta-pipeline-cookbook.md`              | `agents/technical-artist.md`                                   | **Step 0–2** 脚本 + TA Step 0–D pipeline + Compliance 全表 + 引用图规则 |
+| `ta-atlas-deliverable-standard.md`     | `agents/technical-artist.md`, `refs/ta-pipeline-cookbook.md`   | WebP 运行时默认、atlas `.webp`+`.json`、分组与合规、转码示例            |
+| `ta-3d-flip-recipe.md`                 | `agents/technical-artist.md`, `skills/playcraft-vfx-animation` | 素材重刷 + 3D 翻转动画教程                                              |
+| `ta-image-generation-detail.md`        | `skills/playcraft-image-generation`                            | 精灵图直出策略 + Edit 工作流 + 错误恢复 + 批量最佳实践                  |
+| `ta-image-ops-reference.md`            | `skills/playcraft-image-ops`                                   | `playcraft image` 全子命令 CLI 参数速查表                               |
+| `ta-batch-pipeline-recipes.md`         | `skills/playcraft-batch-pipeline`                              | batch/pipeline 实用配方集                                               |
+| `ta-vfx-preset-catalog.md`             | `skills/playcraft-vfx-animation`                               | VFX/animate 预设完整目录 + 游戏类型配方                                 |
+
+## 按 invoke 场景反查
+
+| Stage / 触发                     | Sub-agent        | 应该读的 refs（按顺序）                                                                                          |
+| -------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `pm` 首次 invoke                 | PM               | `pm-workflow-detail.md` (Steps 1–8)                                                                              |
+| `style_exploration`, Gate #2a 前 | Designer         | `designer-style-exploration-flow.md` (Steps 2–3) + `designer-deliverable-spec.md` § MC                           |
+| `style_exploration`, Gate #2b 前 | Designer         | `designer-style-exploration-flow.md` (4–5) + `designer-handoff-v2-checklist.md` + `designer-deliverable-spec.md` |
+| `production`, Wave 1             | Designer         | `designer-deliverable-spec.md` § Phase 2 + audio skills                                                          |
+| `production`, Wave 2 (TA)        | Technical Artist | `ta-pipeline-cookbook.md` (**Step 0a** intake → Step 0 → 2) → `ta-atlas-deliverable-standard.md`                 |
+| `pm` STOP, Gate #1 pending       | Reviewer         | `reviewer-convergence-eval.md` § design_check Gate #1                                                            |
+| `style_exploration`, Gate #2b 前 | Reviewer         | `reviewer-convergence-eval.md` § design_check Gate #2b                                                           |
+| `ui_pass`, Developer             | Developer        | `developer-phase1-flow.md` Part A → `developer-impl-cookbook.md` → `developer-dev-handoff.md`                    |
+| `ui_review`                      | Reviewer         | `reviewer-convergence-eval.md` § ui_diff + `playwright-cli` skill                                                |
+| `ui_rework`, Developer           | Developer        | `developer-phase1-flow.md` Part B + UI Diff Report                                                               |
+| `gameplay_pass`, Developer       | Developer        | `developer-phase1-flow.md` Part C → `developer-impl-cookbook.md`                                                 |
+| `gameplay_pass`, load_check      | Reviewer         | `reviewer-convergence-eval.md` § load_check + `playwright-cli` skill                                             |
+| `ui_rework`, routeTo TA          | Technical Artist | `ta-pipeline-cookbook.md` (scoped fixes) + `ta-atlas-deliverable-standard.md`                                    |
+| `ui_rework`, routeTo Designer    | Designer         | `designer-deliverable-spec.md` + `designer-handoff-v2-checklist.md` + `designer-color-audio-recipes.md`          |
+| spec-gap (any)                   | PM               | `pm-workflow-detail.md` § Atlas grouping + layout/atom patch                                                     |
+
+## 维护规则
+
+1. **不要在 refs/ 里写应该放在 agent .md 的内容**：Hard Rules、Identity、File Access 矩阵必须留在 L1
+2. **每份 refs/ 文档必须有对应的显式引用入口**：agent .md 或 SKILL.md 里有明确的 "read refs/xxx.md" 指令
+3. **未被引用的 refs 文件必须删除**：LLM 无法自行发现未引用的文档，孤立文件只是噪音
+4. **refs/ 不进入 project-state.md 文件读写矩阵**：这些是只读参考，不是产出文件

package/project-template/.claude/agents/refs/designer-art-style-catalog.md

@@ -0,0 +1,533 @@
+# 美术风格完整目录
+
+> 本文件是各美术风格的深度参考。选型决策树和核心策略见 `playcraft-art-style-guide` skill。
+
+---
+
+## 1. 像素风（Pixel Art）
+
+### 视觉定义
+
+- 所有图形由可见的方块像素组成，无抗锯齿平滑
+- 限色板（通常 8-32 色），色彩过渡通过 dithering 而非渐变实现
+- 边缘清晰锐利，"锯齿"是风格的一部分而非缺陷
+- 阴影用 1-2 级色阶表现，不用连续渐变
+
+### 适用场景
+
+- 怀旧/复古定位的游戏广告
+- 体积敏感场景（像素图压缩后极小）
+- 独立游戏/像素类游戏的广告还原
+- 年轻用户中的"像素美学"潮流
+
+### Prompt 策略
+
+```
+[主体描述], pixel art style, 8-bit retro game aesthetic,
+limited [N]-color palette, sharp crisp pixels, no anti-aliasing,
+no smooth gradients, dithering for shading, [背景处理]
+```
+
+**关键变量**：
+
+- 色板数：`8-color`(极简) / `16-color`(标准) / `32-color`(丰富)
+- 像素密度：`low-res chunky pixels`(大像素) / `detailed pixel art`(精细)
+
+**完整示例**：
+
+```
+A treasure chest pixel art sprite, 8-bit retro game style,
+limited 16-color palette, sharp pixels, no anti-aliasing,
+warm wood brown base with golden metal trim, glowing gems inside,
+on solid bright green #00FF00 background, isolated, centered
+```
+
+### 模型推荐
+
+| 模型          | 适合度 | 说明                            |
+| ------------- | ------ | ------------------------------- |
+| gpt-image-2   | 最佳   | 对"limited palette"指令理解最好 |
+| nano-banana-2 | 良好   | 简单像素图快速出图              |
+| gemini-flash  | 一般   | 容易过度平滑，丢失像素感        |
+
+### TA 管线注意
+
+- **缩放**：只用整数倍（`--scale 2` / `--scale 4`），禁止分数缩放（会引入抗锯齿模糊）
+- **去背**：floodfill 即可（像素边缘清晰），tolerance 15-20
+- **VFX**：可用，但建议生成后用 `playcraft image pixelate --pixel-size 4` 后处理，让 VFX 也像素化
+- **sprite-sheet**：padding=0（像素紧贴），Developer 按精确像素切割
+
+### 常见错误
+
+| 错误       | 原因                   | 修正                                                  |
+| ---------- | ---------------------- | ----------------------------------------------------- |
+| 边缘平滑了 | 模型默认 AA            | 加 `no anti-aliasing, no smoothing, hard pixel edges` |
+| 色彩太多   | 未限色板               | 明确 `limited 16-color palette, no gradients`         |
+| 尺寸太大   | 生成了高分辨率"假像素" | 用最小预设生成(`--image-size 1K`)再整数放大           |
+
+---
+
+## 2. 扁平卡通（Flat Cartoon / Vector）
+
+### 视觉定义
+
+- 纯色填充、无或极少渐变
+- 粗描边（2-4px），颜色统一（通常黑色或深色）
+- 几何化简的形状，低细节密度
+- 色彩鲜艳但数量可控（单元素 3-5 色）
+
+### 适用场景
+
+- 休闲游戏广告（消除、益智）
+- 全年龄受众
+- 需要快速大批量生产的项目（AI 生成成功率高）
+- 体积预算紧张时（纯色压缩效率高）
+
+### Prompt 策略
+
+```
+[主体描述], flat 2D vector illustration style,
+bold [N]px black outlines, solid color fills, no gradients,
+minimal shading, clean geometric shapes, [背景处理]
+```
+
+**关键变量**：
+
+- 描边粗细：`2px`(精致) / `3px`(标准) / `4px`(粗犷)
+- 阴影程度：`no shading`(纯扁平) / `minimal cel-shading`(略有层次)
+
+**完整示例**：
+
+```
+A cute orange cat character, flat 2D vector style,
+bold 3px black outlines, solid color fills, no gradients,
+simple geometric shapes, big round eyes, cheerful expression,
+game mascot character, centered, isolated on white background
+```
+
+### 模型推荐
+
+| 模型            | 适合度   | 说明                   |
+| --------------- | -------- | ---------------------- |
+| 任意 text+image | 均可     | 扁平风格生成成功率最高 |
+| gemini-flash    | 速度最佳 | 快速迭代首选           |
+| gpt-image-2     | 质量最佳 | 细节更精确             |
+
+### TA 管线注意
+
+- **缩放**：任意缩放均可，矢量感天然耐缩放
+- **去背**：floodfill 即可（描边清晰），tolerance 20-30
+- **VFX**：所有预设兼容，视觉融合度高
+- **批量一致性**：同一场景元素描边粗细必须统一（在 prompt 中固定 Npx）
+
+### 常见错误
+
+| 错误           | 原因              | 修正                                                       |
+| -------------- | ----------------- | ---------------------------------------------------------- |
+| 出现渐变阴影   | 模型默认加光影    | 加 `no gradient, no shadow, no 3D effect, completely flat` |
+| 描边粗细不一致 | prompt 未指定像素 | 全批次统一写 `bold 3px black outlines`                     |
+| 颜色过多       | 未限色            | 加 `limited color palette, 4-5 colors per element`         |
+
+---
+
+## 3. Q版/Chibi
+
+### 视觉定义
+
+- 2-3 头身比（头部占身体 1/2 到 1/3）
+- 圆润形状，几乎无棱角
+- 大眼睛、小嘴巴、夸张的表情和动作
+- 手脚简化（小手掌、短粗四肢）
+
+### 适用场景
+
+- 女性向/全年龄游戏
+- 需要亲和力和萌感的品牌
+- 角色需要丰富表情变体的场景
+- 社交游戏、养成类广告
+
+### Prompt 策略
+
+```
+[角色描述], chibi style, cute kawaii aesthetic,
+2.5-head proportion (head is 40% of total height),
+big round eyes, small mouth, round soft body shapes,
+short chubby limbs, [表情/动作], [背景处理]
+```
+
+**完整示例**：
+
+```
+A chibi knight character, cute kawaii style, 2.5-head proportion,
+big sparkling eyes, tiny mouth, round chubby body in silver armor,
+holding a small cute sword, happy determined expression,
+on solid bright green #00FF00 background, full body visible, centered
+```
+
+### 模型推荐
+
+所有模型均可，Q 版是 AI 生图最擅长的风格之一。
+
+### TA 管线注意
+
+- **表情变体**：同一角色换表情时，prompt 只改表情词 + 用 reference-image 锁身体
+- **缩放**：任意
+- **去背**：floodfill（描边清晰），tolerance 20-30
+
+### 常见错误
+
+| 错误                 | 原因         | 修正                                                      |
+| -------------------- | ------------ | --------------------------------------------------------- |
+| 头身比不稳定         | 未明确比例   | 加 `2.5-head proportion, head is 40% of body height`      |
+| 风格偏写实           | 模型倾向     | 加 `NOT realistic, NOT adult proportion, keep chibi cute` |
+| 同一角色不同帧不一致 | 无 reference | Phase 2 必须带 `--reference-image`                        |
+
+---
+
+## 4. 写实/半写实（Realistic / Semi-realistic）
+
+### 视觉定义
+
+- 自然光影、环境反射、软阴影
+- 真实材质纹理（木纹、金属拉丝、布料褶皱）
+- 人体/物体比例接近真实
+- 细节密度高，色彩自然过渡
+
+### 适用场景
+
+- 高端/奢华品牌感的游戏
+- 棋牌/桌游类（仿真桌面感）
+- 目标受众是成年用户
+- 需要"触得到"质感的元素（金币、宝箱、道具）
+
+### Prompt 策略
+
+```
+[主体描述], photorealistic / semi-realistic style,
+detailed textures, natural lighting from [方向],
+soft shadows, [材质描述: brushed metal / polished wood / woven fabric],
+high detail, professional 3D render quality, [背景处理]
+```
+
+**关键变量**：
+
+- 写实程度：`photorealistic`(全写实) / `semi-realistic, stylized`(半写实)
+- 光照：`studio lighting` / `warm ambient` / `dramatic rim light`
+
+**完整示例**：
+
+```
+A stack of realistic gold coins, semi-realistic 3D render style,
+detailed metallic texture with subtle scratches, warm studio lighting from top-left,
+soft shadows beneath, slight depth of field blur on edges,
+on solid bright green #00FF00 background, isolated, centered
+```
+
+### 模型推荐
+
+| 模型         | 适合度 | 说明                            |
+| ------------ | ------ | ------------------------------- |
+| gpt-image-2  | 必选   | 写实风只有 gpt-image-2 质量达标 |
+| gemini-flash | 不推荐 | 细节不足，偏卡通                |
+
+### TA 管线注意
+
+- **去背**：必须用 AI 去背（`--method ai`），floodfill 处理不了复杂光影边缘
+- **缩放**：只能缩小不能放大（放大会暴露细节不足），原图至少生成 1024px+
+- **reference-image**：写实风格漂移最严重，必须使用 reference-image + 限制 prompt 中的风格词数量
+- **VFX**：慎用卡通预设（explosion_small 等），可用 glow / impact_ring（较中性）
+
+### 常见错误
+
+| 错误             | 原因         | 修正                                               |
+| ---------------- | ------------ | -------------------------------------------------- |
+| 质感塑料感       | 模型不够好   | 只用 gpt-image-2 + 加材质细节描述                  |
+| 风格跨元素不一致 | 写实风差异大 | 全批次用同一张 reference + 相同光照描述            |
+| 文件体积爆炸     | 写实细节多   | 生成后压缩，build 阶段处理，不要在生产阶段妥协质量 |
+
+---
+
+## 5. 中国传统风
+
+### 视觉定义
+
+- 水墨笔触感（飞白、浓淡变化）
+- 留白美学（不填满画面）
+- 金色/红色/深色为主色调
+- 书法元素、印章、卷轴、祥云等传统纹饰
+- 克制的色彩（不过度饱和）
+
+### 适用场景
+
+- 麻将/棋牌类游戏
+- 面向中国市场的广告
+- 东方仙侠/武侠题材
+- 需要"高雅"感的品牌定位
+
+### Prompt 策略
+
+```
+[主体描述], Chinese traditional ink painting style,
+elegant brush strokes, subtle ink wash gradients,
+gold and red accents, [留白描述], classical aesthetic,
+[装饰元素: clouds / scroll / seal stamp], [背景处理]
+```
+
+**完整示例**：
+
+```
+Mahjong tile set on dark green felt table,
+Chinese traditional aesthetic, tiles with cream-white face,
+brushed brass metallic frame, traditional Kaiti calligraphy for characters,
+warm amber lighting, elegant and premium, ink painting background elements,
+gold decorative border patterns
+```
+
+### 模型推荐
+
+| 模型          | 适合度 | 说明                               |
+| ------------- | ------ | ---------------------------------- |
+| gpt-image-2   | 最佳   | 中文字符渲染最准确，文化细节理解好 |
+| hy-image-v3.0 | 良好   | 亚洲审美偏向，角色设计好           |
+
+### TA 管线注意
+
+- **文字**：中文字符必须用 gpt-image-2（其他模型笔画容易错）
+- **去背**：水墨渐变边缘需 tolerance 30-40 或 AI 去背
+- **VFX**：glow（金色光晕）和 sparkle（金色闪光）最搭配
+- **色彩**：主色调克制（深色 + 金色 + 红色），避免高饱和霓虹色
+
+### 常见错误
+
+| 错误         | 原因               | 修正                                                          |
+| ------------ | ------------------ | ------------------------------------------------------------- |
+| 汉字笔画错误 | 模型对中文理解不足 | 只用 gpt-image-2 + 指定"correctly written Chinese characters" |
+| 风格偏日式   | 未区分中日美学     | 加 `Chinese traditional, NOT Japanese, NOT anime`             |
+| 色彩过于鲜艳 | 模型偏好高饱和     | 加 `muted elegant tones, subdued colors, ink wash aesthetic`  |
+
+---
+
+## 6. 赛博朋克/科技风（Cyberpunk / Tech）
+
+### 视觉定义
+
+- 深色背景（黑/深蓝/深紫）+ 霓虹发光线条
+- 几何线条、电路图案、数据可视化元素
+- 主发光色：青色(cyan) / 品红(magenta) / 电蓝(electric blue)
+- 高对比：暗底 + 亮光，中间调极少
+- 故障感(glitch)、全息投影(hologram)、雨天反射
+
+### 适用场景
+
+- 动作/射击类游戏
+- 科技公司品牌广告
+- 目标用户：年轻男性 / 科技爱好者
+- 需要"未来感"和"酷"的定位
+
+### Prompt 策略
+
+```
+[主体描述], cyberpunk style, neon [颜色] glow,
+dark [背景色] background, holographic elements,
+circuit board patterns, high contrast, futuristic,
+[发光效果描述], [背景处理]
+```
+
+**完整示例**：
+
+```
+A futuristic pistol weapon icon, cyberpunk style,
+dark navy background, glowing cyan neon outlines,
+holographic data readout overlay, circuit pattern details,
+high contrast, electric blue and magenta accent lights,
+centered, isolated, game UI asset
+```
+
+### 模型推荐
+
+| 模型         | 适合度 | 说明                 |
+| ------------ | ------ | -------------------- |
+| gpt-image-2  | 最佳   | 光效细节丰富         |
+| gemini-flash | 良好   | 色彩鲜艳，霓虹效果好 |
+
+### TA 管线注意
+
+- **去背**：发光溢出到背景——trim 时保留发光边缘（threshold 低一些 5-10）
+- **VFX**：glow 和 starburst 非常搭配，tint 用 cyan/magenta
+- **合成**：overlay 时注意发光层的 alpha 混合——不要硬切边
+- **体积**：发光渐变会增加 PNG 体积，build 时转 WebP 压缩效果好
+
+### 常见错误
+
+| 错误       | 原因         | 修正                                                       |
+| ---------- | ------------ | ---------------------------------------------------------- |
+| 发光过度   | 霓虹占比太高 | 加 `subtle neon accents, not overwhelming, dark dominates` |
+| 背景不够暗 | 模型偏亮     | 明确 `very dark background #0A0A1A`                        |
+| 缺乏深度   | 太扁平       | 加 `depth of field, atmospheric haze, layered lighting`    |
+
+---
+
+## 7. 科幻风（Sci-fi / Space）
+
+### 视觉定义
+
+- 金属/合金材质表面（拉丝钢、钛合金、碳纤维）
+- 星空/太空环境光
+- 全息 UI、数据面板、圆弧形 HUD
+- 冷色调为主（蓝、银、白），暖色作点缀（引擎橙焰）
+- 干净、精密、工业设计感
+
+### 适用场景
+
+- 太空题材游戏
+- 机甲/飞船类
+- 科技产品联名广告
+- 需要"高级"和"精密"感的定位
+
+### Prompt 策略
+
+```
+[主体描述], sci-fi style, metallic surfaces,
+space / futuristic environment, cold blue lighting,
+holographic UI elements, clean industrial design,
+[材质: brushed titanium / carbon fiber / polished chrome], [背景处理]
+```
+
+**完整示例**：
+
+```
+A sci-fi spaceship cockpit dashboard, futuristic style,
+holographic circular UI displays with data readouts,
+brushed titanium frame, cold blue ambient lighting,
+stars visible through viewport, clean precise industrial design,
+high detail, game background asset
+```
+
+### TA 管线注意
+
+- **材质一致性**：金属质感需要 reference-image 严格锁定，否则每次生成材质感不同
+- **VFX**：glow（冷蓝）和 impact_ring 适合，避免 confetti（太欢乐）
+- **3D**：如有 3D 元素，用 `generate-3d` + `apply-texture` 比纯 2D 生成更可控
+
+---
+
+## 8. 奇幻/魔法（Fantasy / Magic）
+
+### 视觉定义
+
+- 发光粒子、魔法光芒、以太能量
+- 饱和色彩（紫色/金色/翠绿）
+- 神秘氛围（雾气、光束、星尘）
+- 有机形状 + 几何魔法阵的结合
+- 光源来自魔法本身（非自然光）
+
+### 适用场景
+
+- RPG/冒险类游戏
+- 卡牌收集类
+- 需要"史诗感"的广告
+- 西方奇幻受众
+
+### Prompt 策略
+
+```
+[主体描述], fantasy art style, magical atmosphere,
+ethereal glow, mystical [颜色] energy particles,
+rich saturated colors, magical light source from [位置],
+[魔法元素: runes / magic circle / floating crystals], [背景处理]
+```
+
+**完整示例**：
+
+```
+A magical staff weapon, fantasy RPG art style,
+glowing purple crystal on top emitting ethereal particles,
+ornate golden twisted wood shaft, mystical rune engravings,
+magical purple and gold light emanating from crystal,
+on solid bright green #00FF00 background, centered, isolated
+```
+
+### TA 管线注意
+
+- **VFX**：sparkle + glow + starburst 是三件套，tint 为紫色/金色
+- **去背**：魔法粒子半透明——用 AI 去背 + 保留 alpha 通道
+- **合成**：魔法光效通过 overlay 叠加（additive blend 效果），不要硬切
+
+---
+
+## 9. 水彩/手绘（Watercolor / Hand-drawn）
+
+### 视觉定义
+
+- 纸质纹理底纹（可见纸张颗粒）
+- 颜色渗透感（边缘不锐利，色彩互相渗透）
+- 笔触可见（不是光滑数字绘制）
+- 柔和过渡、不规则边缘
+- "留白"即纸面原色
+
+### 适用场景
+
+- 治愈系/清新风格游戏
+- 女性向模拟经营/养成类
+- 绘本/故事类广告
+- 需要"温暖"和"手作感"的定位
+
+### Prompt 策略
+
+```
+[主体描述], watercolor painting style, soft wet edges,
+visible paper texture, transparent color washes,
+artistic hand-painted feel, [笔触描述],
+gentle color blending, [背景处理]
+```
+
+**完整示例**：
+
+```
+A cozy cottage house, watercolor painting style,
+soft wet edges, warm colors bleeding into each other,
+visible paper texture background, loose brush strokes,
+delicate botanical details around the house,
+artistic hand-painted illustration, gentle lighting
+```
+
+### TA 管线注意
+
+- **去背**：最难的风格——边缘极不规则，必须用 AI 去背(`--method ai`)
+- **trim**：threshold 设高(30-40)，否则水彩渐变边会被误切
+- **VFX**：慎用——卡通 VFX 会破坏手绘感。如需动效，建议用 animate `float`/`swing`（柔和运动）
+- **缩放**：缩小后纸质纹理可能消失，建议原始生成尺寸即为最终使用尺寸
+- **批量一致性**：水彩风格漂移最严重——reference-image 必须 + prompt 完全复用
+
+### 常见错误
+
+| 错误           | 原因         | 修正                                                   |
+| -------------- | ------------ | ------------------------------------------------------ |
+| 边缘太锐利     | 模型偏数字风 | 加 `soft wet edges, bleeding colors, no hard outlines` |
+| 缺少纸张质感   | 未指定       | 加 `visible paper texture, rough paper grain`          |
+| 颜色过于饱和   | 模型偏好鲜艳 | 加 `muted watercolor tones, diluted pigments, pastel`  |
+| 风格跨帧不统一 | 水彩随机性大 | 多张 reference-image + 完全相同的 prompt               |
+
+---
+
+## 风格混搭规则
+
+某些场景需要混合两种风格（如"科幻 + 中国风"），遵循以下原则：
+
+1. **确定主风格(80%) + 副风格(20%)**：prompt 中主风格关键词 3-4 个，副风格 1-2 个
+2. **元素分配**：主场景用主风格，装饰/点缀用副风格（如：科幻底 + 中国风纹饰）
+3. **避免冲突**：不要混合写实 + 像素（底层矛盾）、不要混合水彩 + 赛博朋克（美学冲突）
+4. **在 design-brief 中明确标注**：`StyleDirection: 主=科幻; 副=中国传统（金色纹饰元素）`
+
+**可混搭组合**：
+
+- 中国风 + 写实（高端麻将/棋牌）
+- 科幻 + 赛博朋克（暗黑科技）
+- 扁平卡通 + Q版（休闲萌系）
+- 奇幻 + 水彩（绘本冒险）
+
+**避免混搭**：
+
+- 像素 + 写实（根本矛盾）
+- 水彩 + 赛博朋克（美学对立）
+- Q版 + 写实（比例冲突）