# v0.2 遗迹探险肉鸽系统

> 版本：v0.2.0
> 日期：2025-06-23
> 作者：Super_Z

## 概述

实现路线图中的 v0.2 旗舰功能——**遗迹探险肉鸽系统**。玩家消耗能量派出探险队，进入程序化生成的遗迹节点路径，沿途遭遇战斗、宝藏、抉择、解谜与休整事件，击败终点 BOSS 获取丰厚奖励。

## 新增系统

### 1. 能量系统
- 新增「探险能量」资源，初始 3 点，上限 5 点。
- 每 45 秒自动恢复 1 点能量（tick 驱动，离线也恢复）。
- 每次探险消耗 1 点能量。

### 2. 探险力与生命
- **探险力**：由基础值 10 + 探险分支技术加成 + 飞升蓝图加成 + 飞升周目加成计算。
- **探险生命**：基础 100 + 技术/飞升加成。归零则探险失败结束。
- **战斗胜率**：`clamp(power / (power + difficulty × 8), 0.25, 0.95)`。

### 3. 节点路径
- 每次探险生成 5-7 个节点的线性路径。
- 末位固定为 BOSS 节点。
- 首节点强制为友好类型（宝藏/休整），保证开局体验。
- 6 种节点类型：

| 类型 | 图标 | 颜色 | 机制 |
|---|---|---|---|
| 战斗 combat | 剑 | 玫红 | 按胜率决定胜负，胜获奖、败扣血或全灭 |
| 宝藏 treasure | 宝石 | 琥珀 | 直接获得晶体+洞见 |
| 抉择 choice | 问号 | 青 | 55% 好结果（奖励）/45% 坏结果（扣血） |
| 解谜 puzzle | 拼图 | 紫 | 探险力越高越可能解出，成功获大奖 |
| 休整 rest | 心 | 翠 | 恢复生命 |
| BOSS boss | 骷髅 | 红 | 必定战斗，高难度，胜则大量奖励+探险胜利 |

### 4. 奖励机制
- **实时入账**：每个节点结算后奖励立即加入玩家资源。
- **晶体绕过仓库上限**：探险奖励晶体不受 idle 产能仓库上限限制（仅闲置产能受限）。
- **失败保留**：探险失败（HP 归零）仍保留已获得的全部奖励。
- **BOSS 胜利**：额外给予大量晶体、洞见、接触进度。
- **撤退**：玩家可随时主动撤退，保留已获奖励。

### 5. 探险日志
- 记录最近 30 条探险事件，含节点类型、结果描述、奖励明细。
- 飞升后保留日志。

## UI 设计

### 探险标签页（主页面第 4 个标签）
- **入口态**（无活跃探险）：
  - 能量条（含恢复倒计时）
  - 出发按钮（消耗 1 能量）
  - 探险说明文案
  - 最近探险记录（最近 4 条）
- **进行态**（有活跃探险）：
  - 探险力 + 当前节点位置
  - 生命条（HP/maxHP，<30% 变红）
  - 节点路径图（横向，已通过/当前/未知，含类型图标与颜色）
  - 路径进度条
  - 当前节点事件卡（类型标签、难度、胜率、标题、描述、结算结果）
  - 操作按钮（探索节点 / 前进 / 撤退）
  - 本次累计奖励

### 视觉细节
- 每种节点类型有专属颜色与图标
- 当前节点放大 1.25 倍 + 光晕
- 已通过节点显示绿色对勾
- 事件卡使用对应节点类型的渐变背景与边框光晕
- 能量条渐变（琥珀→黄）
- 生命条渐变（玫红→翠绿）

## 配套修复与增强

### 仓库满仓警告
- 晶体达上限 98% 时，底部状态栏变琥珀色 + 脉冲动画 + 警告文案。
- 引导玩家解码或升级仓库。

### 闲置产能上限优化
- 仓库满时不再自动产出晶体（而非产出后截断）。
- 探险奖励晶体可超出上限，不被浪费。

### 技术树探险分支增强
- 远征推进器：探险力 +3
- 遗迹图谱：探险力 +5，探险生命 +20
- 维度信标：探险力 +8，接触进度 +50%

## 验证结果

- ✅ 探险出发/节点结算/前进/BOSS/撤退全流程通过
- ✅ HP clamp 修复（休整不超上限）
- ✅ 探险奖励绕过仓库上限（101 晶体 > 50 cap）
- ✅ 探险失败保留奖励
- ✅ 能量恢复计时
- ✅ 探险日志记录
- ✅ 探险标签红点提示（有能量/有进行中探险）

## 影响文件

- `src/lib/game/types.ts` — 新增探险类型定义
- `src/lib/game/expedition.ts` — **新建**，探险逻辑（生成/结算/能量恢复）
- `src/lib/game/config.ts` — 初始状态增加探险字段，技术树描述更新
- `src/lib/game/engine.ts` — createInitialState/performPrestige 包含探险字段
- `src/store/gameStore.ts` — 探险 actions + 能量恢复 tick + HP clamp + 产能上限优化
- `src/components/game/ExpeditionPanel.tsx` — **新建**，探险 UI
- `src/app/page.tsx` — 新增探险标签页 + 仓库满仓警告 + 能量红点