@playcraft/cli 0.0.43 → 0.0.46

package/project-templates/threejs/.claude/agents/refs/artist-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版 + 写实（比例冲突）

package/project-templates/threejs/.claude/agents/refs/artist-color-audio-recipes.md

@@ -0,0 +1,153 @@
+> 本文件是按游戏类型的配色方案和音频情绪弧设计参数参考。核心心理设计原则见 `playcraft-ad-psychology` skill。
+
+# 按游戏类型配色方案
+
+## 休闲消除（Match-3 / 泡泡射击）
+
+```
+主色（60%）：柔和中性背景（奶油色 #FFF8E7 / 浅蓝 #E8F4FD / 薰衣草 #F0E8FF）
+辅色（30%）：高饱和暖色游戏元素（橙 #FF6B35、黄 #FFD700、粉 #FF69B4、绿 #5BE584）
+强调色（10%）：纯金色 CTA #F5A623 或 亮橙 #FF4800
+```
+
+**情感定位**：愉悦、轻松、"下一局会更好"。避免深色和高对比（降低决策压力）。
+
+**代表作参考**：Candy Crush（King）的高饱和糖果色
+
+---
+
+## 策略 / 战争 / 建设
+
+```
+主色（60%）：深色场景背景（深蓝 #0D1B2A / 深绿 #1A2F1A / 暗褐 #2D1B00）
+辅色（30%）：金属质感+金色（铁灰 #4A4A4A、青铜 #8B6914、深红 #8B1A1A）
+强调色（10%）：纯金色 #FFD700 或 亮红 #FF3B30（冲突感）
+```
+
+**情感定位**：权威、力量、"成为最强"。深色背景使金色 CTA 对比最强。
+
+**代表作参考**：Clash of Clans（Supercell）的深色+金色
+
+---
+
+## 益智 / 解谜 / 文字
+
+```
+主色（60%）：冷色中性背景（深蓝紫 #1A1A3E / 浅蓝灰 #F0F4F8 / 白 #FFFFFF）
+辅色（30%）：蓝紫色系游戏元素（钴蓝 #0066CC、紫 #7B4ACA、青 #00B4D8）
+强调色（10%）：鲜绿 #00C851 或 亮黄 #FFCE00（思维活跃感）
+```
+
+**情感定位**：清晰、专注、智慧。冷色调降低情绪噪音，有助于玩家专注于解谜逻辑。
+
+---
+
+## RPG / 奇幻 / 冒险
+
+```
+主色（60%）：神秘背景（深紫 #1A0033 / 夜蓝 #0A0028 / 森林绿 #0D2818）
+辅色（30%）：魔法色彩（紫 #8A2BE2、金 #FFD700、魔法蓝 #4169E1）
+强调色（10%）：火红/橙 #FF4500 或 魔法光 #00FFFF（史诗感）
+```
+
+**情感定位**：神秘、史诗、"踏上冒险"。渐变背景（深色 -> 稍亮）增加空间感和纵深感。
+
+---
+
+# 音频情绪弧设计参数
+
+> 80%+ 的应用内展示以**静音模式**播放——视觉必须独立成立。音频是增强层，不是信息传递主渠道。用 SFX 强化关键交互，而非依赖 BGM 传递情绪。
+
+## BGM：30 秒广告各阶段参数
+
+| 阶段         | 时段   | BPM 范围 | 编排密度               | 乐器推荐               |
+| ------------ | ------ | -------- | ---------------------- | ---------------------- |
+| **Hook**     | 0-3s   | 120-140  | 全层（立即冲击）       | 打击 + 合成铅音 + 低音 |
+| **Tutorial** | 3-10s  | 90-110   | 稀疏（旋律 + 轻打击）  | 木琴/钢片琴 + 轻鼓     |
+| **Gameplay** | 10-25s | 110-135  | 逐层递增（随难度渐进） | 渐进加入贝斯、弦乐     |
+| **EndCard**  | 25-30s | 125-145  | 全层高潮（驱动 CTA）   | 铜管 + 全打击 + 合唱   |
+
+**垂直重编排技术（Vertical Re-orchestration）**：同一段音乐保持相同 BPM / 调号 / 拍号，通过增减轨道层数控制情绪强度，确保阶段切换平滑无割裂感。
+
+```
+情绪强度
+ ▲
+5|      *            /--*  <- EndCard 高潮（全层）
+4|     / \          /
+3|    /   \--------/       <- Gameplay 渐进叠层
+2|   /     Tutorial        <- 降速 / 稀疏编排
+1|  /  ^Hook（立即全层）
+ └──────────────────────────> 时间(秒)
+  0    3      10    18  24  30
+```
+
+**按游戏类型的 BPM 基准**：
+
+| 游戏类型 | 休闲/益智 | RPG/模拟 | 跑酷/平台 | 动作/射击 |
+| -------- | --------- | -------- | --------- | --------- |
+| BPM 区间 | 90-115    | 100-125  | 120-150   | 130-160   |
+
+**Artist 生成 BGM 时的组合写法**：
+
+```bash
+# 示例：休闲消除游戏，Tutorial 阶段风格
+playcraft tools generate-bgm \
+  --prompt "casual match-3 puzzle game, tutorial section, gentle and encouraging, marimba and light percussion, simple melody" \
+  --bpm 100
+
+# EndCard 高潮风格（同一游戏，BPM 提升，编排加密）
+playcraft tools generate-bgm \
+  --prompt "casual match-3 puzzle game, victory climax, full orchestra, triumphant but brief, drives install action" \
+  --bpm 130
+```
+
+> **实践建议**：生成一条 30 秒完整 BGM（以 Gameplay BPM 为基准），再用 `playcraft audio trim` 裁剪出 Hook 段和 EndCard 段。比生成多条独立 BGM 更能保证风格连贯。
+
+---
+
+## SFX：各游戏事件时长标准
+
+| 游戏事件           | 建议时长   | 设计要点                   |
+| ------------------ | ---------- | -------------------------- |
+| UI 点击 / 按钮确认 | 50-100ms   | 轻快无干扰，不抢注意力     |
+| 卡牌翻转           | 100-200ms  | 纸张/塑料质感，干脆利落    |
+| 金币单个收集       | 80-150ms   | 金属叮当，高频悦耳         |
+| Match-3 单次消除   | 150-300ms  | 清脆短促，满足感           |
+| Match-3 连锁 Combo | 300-500ms  | 音阶递增，每次 combo +50ms |
+| 批量奖励 / 金币雨  | 300-800ms  | 叮当序列 + 收尾音          |
+| CTA 按钮弹出       | 200-400ms  | 吸引注意力但不惊吓         |
+| 关卡完成           | 500-1200ms | 凯旋感，可含短旋律片段     |
+| 失败 / 重试提示    | 300-600ms  | 下行音阶，不过度沮丧       |
+
+**SFX Prompt 对应写法**（结合 `playcraft-audio-generation` Skill 使用）：
+
+```bash
+# Match-3 消除 SFX
+playcraft tools generate-sfx \
+  --prompt "satisfying match-3 tile elimination sound, crisp pop with sparkle tail, game UI, clean no reverb" \
+  --duration 0.25
+
+# 连锁 Combo（第 2 连）
+playcraft tools generate-sfx \
+  --prompt "combo chain sound, ascending tone, brighter and higher than previous, game feedback" \
+  --duration 0.4
+
+# CTA 弹出
+playcraft tools generate-sfx \
+  --prompt "call-to-action button appear sound, attention-grabbing chime, positive and inviting, mobile game UI" \
+  --duration 0.3
+```
+
+---
+
+## 音频-视觉对齐检查清单
+
+Artist 完成音频生成后，对照以下清单验证情绪一致性：
+
+- [ ] Hook BGM 第一个节拍 <= 0.5s 内出现（不要淡入铺垫）
+- [ ] Tutorial 段 BPM 比 Gameplay 低 15-30（有感知上的降速）
+- [ ] EndCard 音量/编排密度是全广告中最高点
+- [ ] 每个关键交互（消除/收集/胜利）都有配套 SFX
+- [ ] BGM 经过 `playcraft audio loop --crossfade 1.0` 处理，无缝循环
+- [ ] SFX 文件 <= 50KB（`playcraft audio info` 验证）
+- [ ] BGM 文件 <= 300KB（压缩后）