# 09 · 进程系统规范

> **所属文档集** [← 返回索引](./README.md)  
> **摘要**：能力解锁、门控系统、Geo 遗骸机制与游戏完成度追踪。

---

## 目录

1. [进程设计原则](#1-进程设计原则)
2. [能力系统](#2-能力系统)
3. [门控系统](#3-门控系统)
4. [Geo 遗骸机制](#4-geo-遗骸机制)
5. [完成度追踪](#5-完成度追踪)
6. [护符系统](#6-护符系统)
7. [进程事件目录](#7-进程事件目录)

---

## 1. 进程设计原则

| 原则 | 说明 |
|------|------|
| **有机探索** | 能力解锁带来新的区域通路，而非仅仅提升战斗数值 |
| **无死门** | 不存在因获取顺序错误而无法继续的情况 |
| **多路径** | 大多数门控有多种解锁方式（能力/密钥/支线）|
| **数据驱动** | 所有解锁条件用数据定义，逻辑层不硬编码 |

---

## 2. 能力系统

### 2.1 能力数据模型

```
DataModel AbilityData {
    abilityId       : ID
    displayName     : String
    description     : String
    ──────────────────────────────────
    abilityType     : AbilityType        // 移动/战斗/探索/形态
    unlockSource    : UnlockSource       // 如何获得（Boss掉落/收集品/商店）
    ──────────────────────────────────
    gatesUnlocked   : List<GateType>     // 该能力解锁哪些门控类型
    movementFlags   : Flags<MovementAbilityFlag>  // 移动系统的能力开关
    combatFlags     : Flags<CombatAbilityFlag>    // 战斗系统的能力开关
}
```

### 2.2 核心能力列表

| 能力 ID | 名称 | 获取方式 | 解锁内容 |
|--------|------|---------|---------|
| `DoubleJump` | 双跳 | 初始能力（教程）| 空中二段跳 |
| `WallGrab` | 墙抓 | 区域 1 Boss | 抓墙/墙跳 |
| `AerialDash` | 空中冲刺 | 区域 2 Boss | 8方向空中冲刺 |
| `Plunge` | 下冲 | 区域 3 收集品 | 下冲攻击 |
| `SwimAbility` | 游泳 | 区域 4 收集品 | 进入液体区域 |
| `SkyFormUnlock` | 天魂解锁 | 剧情节点 | 天魂形态 |
| `EarthFormUnlock` | 地魂解锁 | 剧情节点 | 地魂形态 |
| `DeathFormUnlock` | 命魂解锁 | 剧情节点 | 命魂形态 |
| `SoulSkillUpgrade` | 魂技能升级 | 特定 NPC | 魂技能二阶效果 |

### 2.3 能力解锁流程

```
玩家获得 AbilityData（来源：Boss掉落/拾取/购买）
  → 发出 OnAbilityUnlocked 事件（abilityId）
  → 更新 SaveData.unlockedAbilities 集合
  → 玩家系统注册新 movementFlags 和 combatFlags
  → 门控系统重新评估所有已知门控状态
  → 地图更新（若新能力打开了新路径）
```

---

## 3. 门控系统

### 3.1 门控数据模型

```
DataModel GateData {
    gateId          : ID
    roomId          : ID
    displayName     : String
    ──────────────────────────────────
    conditions      : List<GateCondition>   // 解锁条件（满足任一即可，OR逻辑）
    unlockMode      : GateUnlockMode        // 永久解锁 / 单次通过
    ──────────────────────────────────
    lockedVisual    : VisualState
    unlockedVisual  : VisualState
    tooltipText     : String                // 玩家尝试进入未解锁门时显示
}

DataModel GateCondition {
    conditionType   : GateConditionType
    targetId        : ID                    // 依条件类型：能力ID/密钥ID/任务ID
    quantity        : Optional<Integer>     // 若需要数量（如 Geo 消耗）
}
```

### 3.2 门控条件类型

| 条件类型 | 说明 | 示例 |
|---------|------|------|
| `HasAbility` | 玩家已解锁某能力 | 需要双跳才能通过高台 |
| `HasItem` | 玩家持有某关键道具 | 需要古城钥匙 |
| `BossDefeated` | 某 Boss 已被击败 | 区域终 Boss 死后大门开启 |
| `QuestComplete` | 某任务/剧情已完成 | NPC 认可后打开秘道 |
| `PaidGeo` | 支付 Geo（商人/通行税）| 进入特定区域收费 |
| `WorldFlag` | 某世界标记为真 | 触发了某机关后解锁 |

---

## 4. Geo 遗骸机制

### 4.1 规则规范

```
玩家死亡:
  → 当前持有的 Geo 全部转移为遗骸（GeoShade）
  → 遗骸实体生成于死亡位置
  → 玩家的 Geo 归零
  → 若已有遗骸（上一次死亡未取回）:
       → 旧遗骸永久消失（及其中的 Geo）
       → 新遗骸替代旧遗骸

玩家到达遗骸位置并触碰:
  → 恢复遗骸中的全部 Geo
  → 遗骸消失
  → 发出 OnGeoShadeRecovered 事件
```

### 4.2 数据模型

```
DataModel GeoShadeState {
    exists          : Boolean
    geoAmount       : Integer
    deathPosition   : Vector2
    roomId          : ID                // 遗骸所在房间（跨房间持久存在）
}
```

> **设计决策**：再次死亡前遗骸永久消失  
> **原因**：来自 Hollow Knight 的核心惩罚机制。失去 Geo 的焦虑推动玩家谨慎前进，而非莽撞行事。

---

## 5. 完成度追踪

### 5.1 完成度指标

```
DataModel CompletionData {
    ──── 主线进程 ────────────────────
    mainQuestStage  : Integer           // 当前主线阶段
    endingUnlocked  : Optional<EndingType>
    
    ──── 探索进度 ────────────────────
    roomsVisited    : Set<ID>           // 已访问房间
    mapRevealPercent: Number            // 0.0~1.0
    
    ──── 收集进度 ────────────────────
    maxHPUpCount    : Integer           // 已拾取 HP 上限碎片数
    maxSoulUpCount  : Integer           // 已拾取灵力上限碎片数
    maxSpiritUpCount: Integer           // 已拾取魄元上限碎片数
    lorePiecesFound : Set<ID>
    
    ──── 挑战进度 ────────────────────
    bossesDefeated  : Set<ID>
    bossesParried   : Set<ID>           // 弹反过 Boss 至少一次
    secretsFound    : Set<ID>
}
```

### 5.2 三结局条件

| 结局 | 触发条件 |
|------|---------|
| **结局 A**（普通结局）| 击败最终 Boss，未满足结局 B/C 条件 |
| **结局 B**（完全结局）| 击败所有 Boss + 主线所有剧情节点 + 特定 NPC 任务完成 |
| **结局 C**（隐藏结局）| 发现隐藏区域、触发特定世界标记序列 + 结局 B 条件 |

---

## 6. 护符系统

### 6.1 护符数据模型

```
DataModel CharmData {
    charmId         : ID
    displayName     : String
    description     : String
    ──────────────────────────────────
    notchCost       : Integer           // 装备槽位消耗
    ──────────────────────────────────
    effects         : List<CharmEffect>
    comboCharms     : Optional<List<ID>> // 与哪些护符组合触发强化效果
    comboEffects    : Optional<List<CharmEffect>>
}

DataModel CharmEffect {
    effectType      : CharmEffectType
    params          : Map<String, Number>
}
```

### 6.2 护符槽位规则

| 规则项 | 说明 |
|--------|------|
| 初始槽位 | 3 个 Notch |
| 扩展方式 | 特定 NPC（付 Geo）增加 Notch |
| 最大 Notch | 11 个（初始 3 + 最多可购买 8）|
| 过量装备 | 可强行装备超过槽位（超出则 HP 上限临时减半）|

### 6.3 护符效果类型

| 类型 | 说明 | 参数 |
|------|------|------|
| `StatModifier` | 修改某资源上限/恢复量 | `statType`, `delta` |
| `DamageModifier` | 修改某类攻击的伤害倍率 | `attackType`, `multiplier` |
| `WeaponOverride` | 覆盖某形态的武器 | `formId`, `weaponId` |
| `SkillModifier` | 修改技能效果参数 | `skillId`, `paramKey`, `newValue` |
| `AerialDashCount` | 增加空中冲刺充能次数 | `additionalCharges` |
| `ParryWindowExpand` | 扩大弹反时间窗口 | `addedSeconds` |
| `OnHitEffect` | 命中时附加效果 | `effectType`, `chance` |

---

## 7. 进程事件目录

| 事件 | 触发时机 | 载荷 |
|------|---------|------|
| `OnAbilityUnlocked` | 获得新能力 | `abilityId` |
| `OnGateUnlocked` | 门控条件满足，门开启 | `gateId` |
| `OnCharmEquipped` | 装备护符 | `charmId, slotIndex` |
| `OnCharmUnequipped` | 卸下护符 | `charmId` |
| `OnCharmComboActivated` | 护符组合效果触发 | `charmIds: List<ID>` |
| `OnGeoShadeCreated` | 死亡创建遗骸 | `position, amount` |
| `OnGeoShadeRecovered` | 拾取遗骸 | `amount` |
| `OnGeoShadeLost` | 遗骸永久消失 | `amount` |
| `OnEndingUnlocked` | 结局条件满足 | `endingType` |
| `OnCompletionMilestone` | 完成度达到里程碑 | `milestoneId, percent` |