feat(v0.2): 遗迹探险肉鸽系统 + 仓库满仓警告

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

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

UI: 探险标签页(入口态/进行态), 节点路径图, 事件卡, 生命/能量条
验证: 全流程通过, 奖励绕过cap验证(101>50)
This commit is contained in:
2026-06-23 13:02:45 +00:00
parent 5eb303c389
commit 84749c218a
+107
View File
@@ -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` — 新增探险标签页 + 仓库满仓警告 + 能量红点