aibis-dream/Assets/Scripts/MiniGame/HuoShan/Language/AnalysisMode/QuickStart.md

分析模式快速设置清单

✅ 关键要点

1. 共享 Canvas：分析模式使用 LanguageParticleManager 的 Language Canvas（WorldSpace Canvas）
2. UI 位置：所有分析模式 UI 都在 Language Canvas 下创建
3. 初始化按钮位置：放在 Emotion Control（情绪控制区）里
4. 游戏流程：先完成语言粒子游戏 → 启动分析模式 → 呼出控制器 → 初始化 → 过滤分析 → 验证

🚀 5分钟快速设置

1. 找到现有 Canvas（1分钟）

Hierarchy:
Expression View
└── Language Particle Manager
    └── Language Canvas ← 这个！

2. 创建分析面板（2分钟）

在 Language Canvas 下：

右键 Language Canvas → Create Empty
命名为：Analysis Panel
添加 RectTransform
设置 Active: false（初始隐藏）

3. 创建控制区（1分钟）

在 Analysis Panel 下：

创建 Vertical Layout Group 对象：Control Panel
├── 创建 Vertical Layout Group 对象：Emotion Control
│   ├── Button: Initialize Button
│   ├── TMP_Text: Frequency Text
│   ├── Slider: Emotion Slider
│   └── TMP_Text: Signal Strength Text
├── Button: Start Filter Button
├── Button: Verify Button
└── Scroll View: Log Scroll View
    └── TMP_Text: Log Text

4. 创建网格区（1分钟）

在 Analysis Panel 下：

创建 Empty 对象：Grid Container
└── 创建 Image：Decoder Strip
    - 添加 Canvas Group
    - 添加 Outline
    - 添加 AnalysisDecoderStrip
    - Active: false（初始隐藏）

5. 配置管理器（立即完成）

创建 GameObject：Analysis Mode Manager（在 Expression View 下）
添加组件：AnalysisModeManager

拖入引用：
✓ Shared Canvas → Language Canvas
✓ Analysis Panel → Analysis Panel
✓ 所有按钮、文本、滑动条
✓ Grid Container → Grid Container
✓ Decoder Strip → Decoder Strip
✓ Grid Cell Prefab → 你创建的预制体

📋 完整层级结构

Expression View
├── Expression Camera
├── Expression Deep Camera
├── Language Particle Manager (挂 LanguageParticleManager)
│   └── Language Canvas (WorldSpace Canvas)
│       ├── FloatingParticles (运行时创建)
│       ├── CandidateParticles (运行时创建)
│       └── Analysis Panel ← 你要创建的
│           ├── Control Panel
│           │   ├── Emotion Control
│           │   │   ├── Initialize Button
│           │   │   ├── Frequency Text ("50.0 Hz")
│           │   │   ├── Emotion Slider (0-100, 初始50)
│           │   │   └── Signal Strength Text ("信号强度: 0%")
│           │   ├── Start Filter Button (初始禁用)
│           │   ├── Verify Button (初始禁用)
│           │   └── Log Scroll View
│           │       └── Log Text
│           └── Grid Container
│               └── Decoder Strip (初始隐藏)
└── Analysis Mode Manager (挂 AnalysisModeManager)

🎯 关键配置项

AnalysisModeManager Inspector 设置

Canvas 引用（共享）

• Shared Canvas: Language Canvas ← 必须设置！

UI 引用

• Analysis Panel: Analysis Panel
• Initialize Button: Initialize Button
• Emotion Slider: Emotion Slider (Min: 0, Max: 100, Value: 50)
• Frequency Text: Frequency Text
• Signal Strength Text: Signal Strength Text
• Start Filter Button: Start Filter Button (初始 Interactable: false)
• Verify Button: Verify Button (初始 Interactable: false)
• Log Text: Log Text
• Log Scroll Rect: Log Scroll View

网格配置

• Grid Container: Grid Container
• Grid Cell Prefab: GridCellPrefab ← 需要创建预制体
• Grid Width: 20
• Grid Height: 20
• Cell Size: 45
• Cell Gap: 2

解码器条纹

• Decoder Strip: Decoder Strip
• Strip Width: 5
• Strip Height: 3

动画配置

• Panel Slide Duration: 0.5
• Slide Ease: OutCubic

焦虑短句（默认，可通过 Yarn 覆盖）

临检要来了大家都很紧张只有销售员说终于可以检查业绩了
不合格英里被骂了因为销售业绩太差了
我担心业绩会下滑结果真的下滑了我的担心是对的
销售员总是混淆客户和老板因为都要讨好
一个销售员走进酒吧问两张桌子要不要买保险

目标配置

• Target Sentence: [临检]要来了，不合格[英里]被骂了，这让我很[担心]

🎮 测试流程

Yarn 测试脚本

title: 测试分析模式
---
// 1. 先完成语言粒子游戏（可选）
角色：现在让我们分析一下你的焦虑...

// 2. 启动分析模式
<<start_analysis_mode "" "TestComplete">>

// 等待玩家操作...
===

title: TestComplete_Success
---
角色：太好了！你找到了答案。
<<close_analysis_mode>>
===

title: TestComplete_Fail
---
角色：再试试看...
-> 重试
    <<start_analysis_mode "" "TestComplete">>
-> 放弃
    <<close_analysis_mode>>
===

Play Mode 测试步骤

1. ✓ 启动游戏，通过 Yarn 触发 start_analysis_mode
2. ✓ 检查 Analysis Panel 是否滑出/显示
3. ✓ 点击 Initialize Button，网格应该开始填充
4. ✓ 点击 Start Filter Button，解码器条纹应该出现
5. ✓ 拖动 Emotion Slider，观察网格变化
6. ✓ 调整到 90Hz 左右（Fear 频率）
7. ✓ 点击 Verify Button，应该成功

⚠️ 常见错误

❌ 错误 1：网格没有显示

原因：Grid Cell Prefab 没有设置或配置错误 解决：

1. 确保创建了 GridCellPrefab 预制体
2. 拖入 AnalysisModeManager 的 Grid Cell Prefab 字段
3. 预制体必须包含 AnalysisGridCell 组件

❌ 错误 2：面板没有滑出

原因：Analysis Panel 初始位置不对 解决：

1. Analysis Panel 初始应该设置为 Active: false
2. 或者设置到屏幕外位置
3. 检查 Panel Slide Duration 是否 > 0

❌ 错误 3：按钮点击没反应

原因：Canvas 缺少 Graphic Raycaster 或 EventSystem 解决：

1. 在 Language Canvas 上添加 Graphic Raycaster
2. 确保场景中有 EventSystem

❌ 错误 4：文字太小看不清

原因：WorldSpace Canvas 中文字需要更大字号 解决：

1. 增大 Cell Size（建议 60-80）
2. 增大 TMP_Text 的 Font Size（建议 16-20）
3. 调整 Canvas 的缩放

📖 详细文档

• 完整设置指南：Unity_Setup_Guide_Updated.md
• 功能说明：README.md
• Yarn 示例：AnalysisMode_YarnExample.yarn

🎨 自定义建议

调整 UI 位置

根据你的游戏设计，Analysis Panel 可以：

• 覆盖在粒子系统上方（半透明）
• 平移到屏幕侧边
• 淡入淡出切换

调整网格大小

如果 20x20 太大：

• 修改 Grid Width/Height（如 15x15）
• 相应调整 Cell Size
• 修改焦虑短句数量

调整情绪频率

在 EmotionConfig 中：

• Joy: 15Hz（黄色）
• Sadness: 40Hz（蓝色）
• Anger: 65Hz（红色）
• Fear: 90Hz（紫色）

✨ 完成检查清单

• Language Canvas 存在且配置正确
• Analysis Panel 在 Language Canvas 下
• Emotion Control 包含 Initialize Button
• 所有按钮都有点击事件（在代码中绑定）
• Grid Cell Prefab 创建并配置
• AnalysisModeManager 所有字段都拖入了引用
• ExpressionManager 中 Analysis Mode Manager 字段已设置
• 测试 Yarn 脚本可以启动分析模式
• Play Mode 下可以完整走完流程

🚦 现在开始

1. 打开 Unity 编辑器
2. 找到 Expression View -> Language Particle Manager -> Language Canvas
3. 按照上面的"5分钟快速设置"创建 UI
4. 配置 AnalysisModeManager
5. 运行测试！

祝你成功！🎉