# 语言分析系统 - 清晰架构说明

## ✅ 你应该使用的系统：LanguageAnalysisManager

### 系统位置
```
Assets/Scripts/MiniGame/HuoShan/Language/
└── LanguageAnalysis/
    └── LanguageAnalysisManager.cs  # ✅ 这是主系统！
```

### 使用方法

#### 在 Yarn 中
```yarn
// 进入语言分析系统
<<enter_language_analysis>>

// 启动记忆解密器
<<memory_decryptor_start Success>>

// 退出语言分析系统
<<exit_language_analysis>>
```

#### 在场景中
```
LanguageAnalysisManager
├── Language Analysis View (GameObject)
│   └── MemoryDecryptorMode
│       ├── Config: 留空即可（自动使用默认配置）
│       ├── MemoryDecryptorRenderer
│       └── MemoryDecryptorInputHandler
├── Language Analysis Camera
└── Language Analysis Deep Camera
```

## 📋 核心流程图

```
游戏开始
    ↓
任意状态 (Clinic / BodyModule / etc.)
    ↓
<<enter_language_analysis>>  ← Yarn 命令
    ↓
[FixStateMachine 切换状态]
    ↓
FixState.LanguageAnalysis ← 进入此状态
    ↓
LanguageAnalysisState.Enter()
  - 切换相机
  - 打开 Analysis View
  - 淡入淡出效果
    ↓
<<memory_decryptor_start>>  ← Yarn 命令
    ↓
LanguageAnalysisManager.StartMemoryDecryptor()
    ↓
MemoryDecryptorMode.StartSystem()
  - Boot 序列
  - 加载网格
  - 显示笑话
    ↓
玩家操作界面
  - 调整频率
  - 拖动解码器
  - 点击验证
    ↓
成功/失败
    ↓
Yarn 节点跳转 (Success / Success_Fail)
    ↓
<<memory_decryptor_stop>>  ← Yarn 命令
    ↓
<<exit_language_analysis>>  ← Yarn 命令
    ↓
[FixStateMachine 切换状态]
    ↓
返回之前的状态
```

## 🔑 关键组件

### 1. LanguageAnalysisManager (主系统)
**位置**: `LanguageAnalysis/LanguageAnalysisManager.cs`  
**职责**:
- 管理语言分析视图
- 注册到 FixSystemCenter
- 注册相机
- 管理子系统（MemoryDecryptorMode）

**公开方法**:
```csharp
void OpenView()                              // 打开视图
void CloseView()                             // 关闭视图
void StartMemoryDecryptor(string node)      // 启动解密器
void StartMemoryDecryptorFiltering()        // 开始过滤
void SetMemoryDecryptorFrequency(float f)   // 设置频率
void CheckMemoryDecryptorMatch()            // 检查匹配
```

### 2. LanguageAnalysisState (状态机状态)
**位置**: `FixSystemNew/FixStateMachine.cs`  
**职责**:
- Enter: 切换相机、打开视图、淡入淡出
- Exit: 关闭视图、重置 Plug

### 3. MemoryDecryptorMode (解密器核心)
**位置**: `MemoryDecryptor/MemoryDecryptorMode.cs`  
**职责**:
- 游戏逻辑
- 网格管理
- 频率调谐
- 匹配检测

### 4. Yarn 命令
**位置**: 
- `LanguageAnalysis/LanguageAnalysisYarnCommands.cs` (状态切换)
- `MemoryDecryptor/MemoryDecryptorYarnCommands.cs` (解密器控制)

## 📝 调用链

### Yarn → Manager → Mode

```
<<enter_language_analysis>>
    ↓
LanguageAnalysisYarnCommands.EnterLanguageAnalysis()
    ↓
FixStateMachine.SwitchState(LanguageAnalysis)
    ↓
LanguageAnalysisState.Enter()
    ↓
LanguageAnalysisManager.OpenView()

---

<<memory_decryptor_start>>
    ↓
MemoryDecryptorYarnCommands.StartMemoryDecryptor()
    ↓
LanguageAnalysisManager.StartMemoryDecryptor()
    ↓
MemoryDecryptorMode.StartSystem()
```

## ⚡ 快速配置（零配置模式）

### 最简场景设置

1. **创建 LanguageAnalysisManager 对象**
2. **添加子对象和组件**（参考 SETUP_GUIDE.md）
3. **运行游戏**
4. **在 Yarn 中使用：**

```yarn
<<enter_language_analysis>>
<<memory_decryptor_start>>
```

就这么简单！✨

## ❌ 已移除的内容

从 ExpressionManager 中移除了：
- ❌ `AnalysisMode` 枚举
- ❌ `memoryDecryptorMode` 字段
- ❌ `SwitchMode()` 方法
- ❌ `SwitchToParticleMode()` 方法
- ❌ `SwitchToMemoryDecryptorMode()` 方法
- ❌ `StartMemoryDecryptor()` 方法
- ❌ `SetMemoryDecryptorFrequency()` 方法
- ❌ `StartMemoryDecryptorFiltering()` 方法
- ❌ `CheckMemoryDecryptorMatch()` 方法

**原因**: 记忆解密器现在完全属于 LanguageAnalysisManager

## ✅ 现在的清晰架构

```
ExpressionManager (表达系统)
├── 只管理粒子表达
└── 不再管理记忆解密器

LanguageAnalysisManager (语言分析系统)
├── 管理所有语言分析相关功能
└── 包含记忆解密器
```

## 🎯 使用建议

### 表达情绪时 → ExpressionManager
```yarn
<<open_expression>>
<<start_expression "焦虑短句" "目标句子">>
```

### 解密语言时 → LanguageAnalysisManager
```yarn
<<enter_language_analysis>>
<<memory_decryptor_start>>
```

## 📚 文档导航

**开始使用语言分析系统：**
1. 📖 `LanguageAnalysis/QUICK_REFERENCE.md` - 快速上手
2. 🔧 `LanguageAnalysis/SETUP_GUIDE.md` - 详细设置
3. 🧪 `LanguageAnalysis/TestLanguageAnalysis.yarn` - 测试示例

**了解记忆解密器：**
1. 📖 `MemoryDecryptor/README.md` - 详细说明
2. ⚡ `MemoryDecryptor/QUICKSTART.md` - 快速入门
3. ✨ `MemoryDecryptor/AUTO_CONFIG_FEATURE.md` - 自动配置

---

## 💡 记住

**只使用 LanguageAnalysisManager！**  
**ExpressionManager 已经不再包含记忆解密器了！**  
**两个系统完全独立，不要混用！**

---

**🚀 开始使用:** `<<enter_language_analysis>>`