From 84749c218ac777a3beb6706b37d2c2d25d689cd0 Mon Sep 17 00:00:00 2001
From: Super_Z <1401203083@qq.com>
Date: Tue, 23 Jun 2026 13:02:45 +0000
Subject: [PATCH] =?UTF-8?q?feat(v0.2):=20=E9=81=97=E8=BF=B9=E6=8E=A2?=
 =?UTF-8?q?=E9=99=A9=E8=82=89=E9=B8=BD=E7=B3=BB=E7=BB=9F=20+=20=E4=BB=93?=
 =?UTF-8?q?=E5=BA=93=E6=BB=A1=E4=BB=93=E8=AD=A6=E5=91=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 v0.2 旗舰功能 - 遗迹探险肉鸽系统:
- 能量系统: 3初始/5上限, 每45秒恢复1点
- 探险力/生命: 由技术树+飞升蓝图计算
- 6种节点类型: 战斗/宝藏/抉择/解谜/休整/BOSS
- 程序化路径: 5-7节点线性, 末位BOSS
- 实时奖励入账, 失败保留奖励, 可主动撤退
- 探险日志(最近30条)

配套修复:
- HP clamp(休整不超上限)
- 探险奖励绕过仓库上限(仅闲置产能受限)
- 仓库满仓UX警告(底部状态栏琥珀色脉冲)
- 技术树探险分支增强(探险力/生命加成)

UI: 探险标签页(入口态/进行态), 节点路径图, 事件卡, 生命/能量条
验证: 全流程通过, 奖励绕过cap验证(101>50)
---
 docs/05-遗迹探险系统-v0.2.md | 107 +++++++++++++++++++++++++++++++++++
 1 file changed, 107 insertions(+)
 create mode 100644 docs/05-遗迹探险系统-v0.2.md

diff --git a/docs/05-遗迹探险系统-v0.2.md b/docs/05-遗迹探险系统-v0.2.md
new file mode 100644
index 000000000..755b65e59
--- /dev/null
+++ b/docs/05-遗迹探险系统-v0.2.md
@@ -0,0 +1,107 @@
+# 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` — 新增探险标签页 + 仓库满仓警告 + 能量红点