# Test_Huoshan Yarn 完整流程图（Debug 用）

> 基于 `Test_Huoshan.yarnproject` 及所有 `.yarn` 文件生成

## 0. Yarn Graph 布局说明

节点已按逻辑分组，position 与 tags 便于在 Yarn Editor 中浏览：

| 区域 | X 范围 | 内容 |
|------|--------|------|
| 核心枢纽 | 300 | Start → VarsInit → Center（竖直） |
| Stage1 | 100 | 诊室开场（左列） |
| Stage2 主流程 | 150-450 | 检查表达→滤波器→情绪（中） |
| Stage2 分支 | 50-650 | 检查记忆/逻辑/视觉（插线入口上方） |
| 插线桥接 | 50-650, y=600 | Emo/Speak/Logic/Color/Memory/EyePlugIn |
| Stage3 销售 | 100-350 | 步进→转动完成→安装日志→旋钮（左中） |
| 销售桥接 | 550 | 销售模块转动完成、处理器单次调节失败 |
| Stage4-8 | 500 | 各 Stage 入口与结束（右列竖直） |
| 波形工具 | 700 | 波形_* 节点（最右） |

**colorID 含义：** 1=入口, 2=Stage, 3=主流程/Expression, 4=变量, 5=销售, 6=波形, 7=桥接, 8=通用

## 1. 主流程总览

```mermaid
flowchart TB
    subgraph entry ["入口"]
        Start --> VarsInit
        VarsInit --> Center
    end

    subgraph center ["Center 调度 (按 $gameStage)"]
        Center -->|1| Stage1
        Center -->|2| Stage2
        Center -->|3| Stage3
        Center -->|4| Stage4
        Center -->|5| Stage5
        Center -->|6| Stage6
        Center -->|7| Stage7
        Center -->|8| Stage8
        Center -->|100| 测试
        Center -->|999| NextYarn
    end

    subgraph stage_flow ["Stage 流转"]
        Stage1 --> S1_end["gameStage=2"]
        Stage2 --> S2_end["gameStage=3"]
        Stage3 --> S3_end["gameStage=4"]
        Stage4 --> S4_end["gameStage=5"]
        Stage5 --> S5_end["gameStage=6"]
        Stage6 --> S6_end["gameStage=7"]
        Stage7 --> S7_end["gameStage=8"]
        Stage8 --> S8_end["gameStage=999"]
        S1_end --> Center
        S2_end --> Center
        S3_end --> Center
        S4_end --> Center
        S5_end --> Center
        S6_end --> Center
        S7_end --> Center
        S8_end --> Center
    end
```

---

## 2. 变量初始化 (VarsInit)

| 变量 | 说明 |
|------|------|
| `$gameStage` | 当前流程阶段 (1-8, 100=测试, 999=结束) |
| `$TaskToDo` | 待完成任务数 |
| `$emoChecked` / `$memoryChecked` / `$logicChecked` / `$eyeChecked` / `$speakerChecked` / `$colorChecked` / `$expressionChecked` | 各模块首次检查标记 |
| `$emoDeepChecked` / `$expressionSentenceGet` / `$hasTimestamp` | 深入检查标记 |
| `$currentSocket` / `$PlugCount` / `$PlugAll` | 插线相关 |
| `$salesTurnIndex` | 销售模块转动轮次 (1-based) |
| `$knobFailCount` | 旋钮调节失败次数 |

---

## 3. Stage 1 - 诊室开场

```mermaid
flowchart LR
    Stage1 --> 开头对话
    开头对话 -->|"set $gameStage=2"| Center
```

- 内容：火山说笑话、发热 → 去诊室

---

## 4. Stage 2 - 后脑检查（插线）

```mermaid
flowchart TB
    Stage2["Stage2 入口"]
    Stage2 --> Task["Task: 检查表达模块"]
    Task --> 检查表达

    subgraph 表达流程
        检查表达 -->|"gameStage==2"| 表达完成["完成Task\nModuleHightLight Speak→color\nTask: 检查滤波器"]
        表达完成 --> 检查销售模块
    end

    检查销售模块 -->|"gameStage==2"| 滤波器完成["波形分析\n发现锯齿波\nTask: 检查情绪模块"]
    滤波器完成 --> 检查情绪

    subgraph 情绪与波形
        检查情绪 --> 条件{"speakerChecked &&\ncolorChecked"}
        条件 -->|是| 查询情绪波形["对比预测波形与真实情绪\n发现对不上"]
        条件 -->|否| 结束
        查询情绪波形 --> 结束Stage2["结束Stage2\ngameStage=3"]
    end

    检查表达 -.->|其他插线| 检查记忆
    检查表达 -.->|其他插线| 检查逻辑
    检查表达 -.->|其他插线| 检查视觉
    检查表达 -.->|其他插线| 检查情绪
```

**Stage2 插线入口（EventNode）：**

| 插线节点 | jump 目标 |
|----------|-----------|
| EmoPlugIn | 检查情绪 |
| SpeakPlugIn | 检查表达 |
| LogicPlugIn | 检查逻辑 |
| SalePlugIn | 检查销售模块 |
| MemoryPlugIn | 检查记忆 |
| EyePlugIn | 检查视觉 |

**关键顺序（gameStage==2）：** 表达 → 滤波器 → 情绪（情绪需 speaker+color 都检查过才会对比波形 → 结束Stage2）

---

## 5. Stage 3 - 滤波器深入（步进 + 销售模块）

```mermaid
flowchart TB
    Stage3["Stage3 入口\nTask: 检查滤波器处理链路"]
    Stage3 --> 步进查看模式

    subgraph 步进流程["步进流程（Yarn 仅显示情绪输入，其余由转动监听驱动）"]
        步进查看模式 --> 步进_情绪输入["步进_情绪输入\n显示原始情绪波形\n转动发条来检测吧"]
        步进_情绪输入 -->|"等待 SalesManager\n转动完成事件"| 销售模块转动完成
    end

    subgraph EventNode_销售["销售模块转动完成（EventNode 仅桥接，分发到 Stage3）"]
        销售模块转动完成["销售模块转动完成"]
        销售模块转动完成 -->|salesTurnIndex==1| 语义合成["销售转动_语义合成"]
        销售模块转动完成 -->|salesTurnIndex==2| 语言审查["销售转动_语言审查"]
        销售模块转动完成 -->|salesTurnIndex==3| 异常检测["销售转动_异常检测"]
    end

    subgraph 安装日志与旋钮["调取安装日志 → 解锁旋钮 → 监听旋钮"]
        异常检测 --> 查询异常进程["查询异常进程\n情绪修改器组件"]
        查询异常进程 --> 查看安装日志["查看安装日志\n3年无复查"]
        查看安装日志 -->|"unlock_knob\n节点结束，等待旋钮"| 等待旋钮["KnobController 监听"]
        等待旋钮 -->|"用户转动超阈值"| 处理器单次调节失败
    end

    subgraph EventNode_旋钮["旋钮失败时 KnobController 跳入（EventNode 仅桥接）"]
        处理器单次调节失败["处理器单次调节失败\n<<jump 旋钮调节失败>>"]
        处理器单次调节失败 --> 旋钮调节失败
    end

    subgraph 旋钮调节失败_Stage3["旋钮调节失败 (Stage3)"]
        旋钮调节失败["旋钮调节失败"]
        旋钮调节失败 -->|knobFailCount==1| 重试["再试一次\nreset_knob"]
        旋钮调节失败 -->|knobFailCount>=2| 最终失败["lock_knob + 叙事\njump 结束Stage3"]
    end
```

**Stage3 关键流程：**
1. 步进_情绪输入 结束 → 对话暂停，等待玩家转动发条
2. **转1**：销售模块转动完成 → 语义合成完成
3. **转2**：销售模块转动完成 → 语言审查通过
4. **转3**：销售模块转动完成 → 检测异常 → 进入处理器 → lock_knob → 查询异常进程 → 查看安装日志 → unlock_knob → 等待旋钮
5. 旋钮失败 → 处理器单次调节失败（1次重试）→ 处理器功率调节失败 → 结束Stage3

---

## 6. Stage 4 - 表达模块 RAM

```mermaid
flowchart TB
    Stage4["Stage4 入口\nTask: 检查表达模块"]
    Stage4 --> 检查表达

    检查表达 -->|"gameStage==4"| RAM发现["发现未释放log\nRAM溢出"]
    RAM发现 --> 结束Stage4["结束Stage4\ngameStage=5"]
```

---

## 7. Stage 5 - 诊室对话

```mermaid
flowchart TB
    Stage5["Stage5 入口"]
    Stage5 --> 诊室对话["诊室对话\n火山承认+达成共识"]
    诊室对话 --> 结束Stage5["结束Stage5\ngameStage=6"]
```

---

## 8. Stage 6 - 释放 RAM

```mermaid
flowchart TB
    Stage6["Stage6 入口\nTask: 释放表达模块RAM"]
    Stage6 --> 检查表达

    检查表达 -->|"gameStage==6"| 释放log["释放log\n自动释放 log1/2/3"]
    释放log --> 手动释放["遇到被干扰log\n进入手动释放"]
    手动释放 --> 手动释放log["手动释放log\nswitch Expression"]
    手动释放log --> LOG1["LOG1: 哈哈|嘿嘿|呵呵 → 我很害怕"]
    LOG1 --> LOG1梳理完成
    LOG1梳理完成 --> LOG2["LOG2: ... → 她都是为了我"]
    LOG2 --> LOG2梳理完成
    LOG2梳理完成 --> LOG3["LOG3: ... → 我不想再继续逃了"]
    LOG3 --> LOG疏通全部完成
    LOG疏通全部完成 --> 结束Stage6["结束Stage6\ngameStage=7"]
```

---

## 9. Stage 7 - 最终检查

```mermaid
flowchart TB
    Stage7["Stage7 入口\nTaskToDo=2"]
    Stage7 --> Task1["Task: 检查表达模块"]
    Stage7 --> Task2["Task: 检查滤波器"]

    检查表达 -->|"gameStage==7"| 表达OK["完成Task\nTaskToDo--"]
    检查销售模块 -->|"gameStage==7"| 滤波器OK["完成Task\nTaskToDo--"]

   表达OK --> 判断1{"TaskToDo==0?"}
    滤波器OK --> 判断1
    判断1 -->|是| 结束Stage7["结束Stage7\ngameStage=8"]
    判断1 -->|否| 继续["继续等待另一项完成"]
```

---

## 10. Stage 8 - 结束对话

```mermaid
flowchart TB
    Stage8["Stage8 入口"]
    Stage8 --> 结束对话["结束对话\n火山说出真话"]
    结束对话 -->|"gameStage=999"| Center
```

---

## 11. EventNode 与波形节点

```mermaid
flowchart TB
    subgraph 插线入口
        EmoPlugIn
        SpeakPlugIn
        LogicPlugIn
        SalePlugIn
        MemoryPlugIn
        EyePlugIn
    end

    subgraph 销售相关
        销售模块转动完成
        处理器单次调节失败
        处理器功率调节失败
    end

    subgraph 波形
        波形_显示并连接
        波形_显示情绪
        波形_显示滤波器输出
        波形_隐藏
    end
```

---

## 12. Debug 检查清单

| 现象 | 可能原因 | 检查点 |
|------|----------|--------|
| 流程卡住 | `$gameStage` 未正确更新 | Center 各 Stage 分支 |
| Stage2 不推进 | 表达/滤波器/情绪未按顺序完成 | 检查表达→滤波器→情绪，以及 speakerChecked+colorChecked |
| Stage3 步进不走 | 未从滤波器进入步进；或 SalesManager 未触发转动完成 | 检查销售模块 gameStage==3 的「进入步进查看模式」；检查 totalTurns≥3、crankCompleteNode |
| 销售模块无反馈 | SalesManager/KnobController 未跳转 | EventNode: 销售模块转动完成、处理器单次调节失败 |
| Stage4 无法进 | 需从 Stage3 结束 或 处理器功率调节失败 | 结束Stage3 与 处理器功率调节失败 都 `<<jump 结束Stage3>>` |
| Stage6 手动释放卡住 | Expression 模块/start_expression | start_expression 完成节点 |
| Stage7 TaskToDo 不清零 | 表达/滤波器 有一项未完成 | 两项都需 `complete_task` 且 `TaskToDo--` |
| 测试模式 | gameStage=100 | 测试 节点直接进入 Sales+EmotionWave |

---

## 13. 文件与节点索引

| 文件 | 节点 |
|------|------|
| Center.yarn | Start, VarsInit, Center, 测试 |
| EventNode.yarn | EmoPlugIn, SpeakPlugIn, LogicPlugIn, SalePlugIn, MemoryPlugIn, EyePlugIn, 销售模块转动完成, 处理器单次调节失败（桥接）, 波形_* |
| Stage1.yarn | Stage1, 开头对话 |
| Stage2.yarn | Stage2, 检查表达, 检查销售模块, 检查情绪, 检查记忆, 检查逻辑, 检查视觉, 结束Stage2 |
| Stage3.yarn | Stage3, 步进查看模式, 步进_情绪输入, 销售转动_语义合成/语言审查/异常检测, 查询异常进程, 查看安装日志, 旋钮调节失败, 结束Stage3 |
| Stage4.yarn | Stage4, 结束Stage4 |
| Stage5.yarn | Stage5, 结束Stage5 |
| Stage6.yarn | Stage6, 手动释放log, LOG1/2/3梳理完成, LOG疏通全部完成, 结束Stage6 |
| Stage7.yarn | Stage7, 结束Stage7 |
| Stage8.yarn | Stage8, 结束对话 |