108 lines
4.4 KiB
Markdown
Executable File
108 lines
4.4 KiB
Markdown
Executable File
# 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` — 新增探险标签页 + 仓库满仓警告 + 能量红点
|