echo-nexus/docs/05-遗迹探险系统-v0.2.md

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 — 新增探险标签页 + 仓库满仓警告 + 能量红点