114 lines
5.3 KiB
Markdown
Executable File
114 lines
5.3 KiB
Markdown
Executable File
# 回响星核 v0.3 — 星潮事件系统（周期性全局玩法修饰）
|
||
|
||
> 版本：v0.3
|
||
> 日期：2026-06-23
|
||
> 范围：6 种星潮事件、周期触发、全屏视觉叠层、程序化音效、寂静期补偿机制
|
||
|
||
---
|
||
|
||
## 一、设计动机
|
||
|
||
回应 Gitea Issue #1「就一直连连看？」的玩法单一反馈。星潮事件为放置循环注入**动态变化**：深空中偶发的「星潮」会短暂改变物理法则，让玩家在 75 秒内体验产能翻倍、解码加成、探险增强等不同玩法侧重，打破单调感。
|
||
|
||
## 二、6 种星潮事件
|
||
|
||
| 类型 | 名称 | 效果 | 色调 | 性质 |
|
||
|------|------|------|------|------|
|
||
| crystal | 晶体潮 | 采矿产能 ×2 | 翠绿 | 正面 |
|
||
| resonance | 谐振风暴 | 解码奖励 ×1.6 | 玫红 | 正面 |
|
||
| ruins | 遗迹共振 | 探险力 +5、生命 +30 | 琥珀 | 正面 |
|
||
| void | 虚空低语 | 洞见获取 ×2 | 紫红 | 正面 |
|
||
| core | 星核悸动 | 接触率 ×3、脉冲威力 ×2 | 青色 | 正面 |
|
||
| silence | 寂静期 | 产能 ×0.5；结束时按时长补偿洞见 | 灰蓝 | 负面（有补偿） |
|
||
|
||
## 三、触发机制
|
||
|
||
- **首次星潮**：游戏开始 30 秒后触发（`TIDE_CONFIG.firstDelay`）
|
||
- **常规间隙**：星潮结束后 40 秒触发下一次（`TIDE_CONFIG.gap`）
|
||
- **持续时间**：75 秒（`TIDE_CONFIG.duration`）
|
||
- **权重抽取**：6 种事件按权重随机（正面事件权重高，寂静期权重最低 10%）
|
||
- **飞升重置**：飞升后清空当前星潮，重置计时，30 秒后重新开始
|
||
|
||
## 四、修饰器应用层
|
||
|
||
| 修饰器 | 应用点 |
|
||
|--------|--------|
|
||
| crystalsPerSecMult | `tick()` 即时乘（显示基础值，实际翻倍积累） |
|
||
| pulsePowerMult | `pulse()` 即时乘 |
|
||
| decodeRewardMult | `clickNode()` / `autoDecodeTick()` 结算时乘 |
|
||
| insightMultAdd | 进 `recomputeStats` 缓存（星潮起止时重算） |
|
||
| contactRateMult | 进 `recomputeStats` 缓存 |
|
||
| expeditionPowerBonus / hpBonus | `startExpedition()` 即时加 |
|
||
| silenceInsightPerSec | 星潮结束时 `computeSilenceCompensation` 结算 |
|
||
|
||
## 五、UI 表现
|
||
|
||
### 顶部指示器（`StarTideIndicator`）
|
||
- 活跃时在 header 右侧显示彩色芯片：图标 + 名称 + 倒计时秒数
|
||
- 芯片背景为对应色半透明，带光晕，进度条随时间推进
|
||
|
||
### 全屏背景叠层（`StarTideOverlay`）
|
||
- 顶部 + 底部对应色渐变色带
|
||
- 边缘 `inset box-shadow` 呼吸光效（3 秒周期）
|
||
- 活跃时整页笼罩对应色调氛围
|
||
|
||
### 通知（`StarTideNotifier`）
|
||
- 星潮降临时 Toast + `tideStart` 音效（神秘扫频）
|
||
- 星潮结束时 Toast + `tideEnd` 音效（柔和消退）
|
||
- 寂静期结束时显示「虚空回赠 N 洞见」+ `techBuy` 音效
|
||
|
||
### Footer 联动
|
||
- 活跃时 footer 提示文字变为「✺ 星潮「晶体潮」进行中 · 深空晶体涌动…」
|
||
- footer 边框点亮对应色光晕
|
||
|
||
## 六、程序化音效
|
||
|
||
新增 2 种音效（`audio.ts`）：
|
||
- `tideStart`：330→660Hz 正弦扫频 + 440→880Hz 三角波 + 523/784Hz 长音（神秘降临感）
|
||
- `tideEnd`：659→523→392Hz 下行三音（柔和消退）
|
||
|
||
## 七、状态与兼容
|
||
|
||
- `GameState` 新增 `activeTide: StarTide | null`、`lastTideEnd: number`
|
||
- 旧存档兼容：`init()` 补全字段为 `null/0`
|
||
- `partialize` 排除运行时队列 `_tideEvents`
|
||
- `performPrestige` 重置星潮（清空 activeTide，lastTideEnd 设为 now）
|
||
|
||
## 八、QA 验证
|
||
|
||
### agent-browser 自动化
|
||
- ✅ 强制触发星潮：`lastTideEnd=0` → 重载 → 30s 内自动触发，状态显示 `activeTide: crystal`
|
||
- ✅ 顶部指示器渲染：「✺ 晶体潮 64s」绿色芯片
|
||
- ✅ 背景叠层：VLM 确认绿色调背景光晕 + 顶部/底部色带 + 边缘呼吸光
|
||
- ✅ 寂静期补偿：设置 `type=silence, endsAt=now+3s` → 等待结束 → insights 从 50 增至 81（补偿 30）
|
||
- ✅ Footer 联动：活跃时显示「✺ 星潮「晶体潮」进行中 · 深空晶体涌动…」
|
||
- ✅ 版本号 v0.3 显示
|
||
- ✅ lint 零错误，HTTP 200，无运行时错误
|
||
|
||
### VLM 视觉确认
|
||
- 指示器芯片：绿色文字「晶体潮 11s」
|
||
- 背景光晕：深绿色，顶部/底部色带 + 边缘呼吸光
|
||
- 视觉完成度：界面清晰、风格统一、细节良好
|
||
|
||
## 九、文件变更清单
|
||
|
||
**新增**：
|
||
- `src/lib/game/starTide.ts` — 星潮定义、修饰器、触发逻辑
|
||
- `src/components/game/StarTide.tsx` — 指示器 + 叠层 + 通知三组件
|
||
|
||
**修改**：
|
||
- `src/lib/game/types.ts` — GameState 新增 `activeTide` / `lastTideEnd`
|
||
- `src/lib/game/config.ts` — INITIAL_STATE 新增潮汐字段
|
||
- `src/lib/game/engine.ts` — `recomputeStats` 应用 insightMultAdd/contactRateMult；`performPrestige`/`createInitialState` 处理潮汐
|
||
- `src/lib/game/audio.ts` — 新增 `tideStart` / `tideEnd` 音效
|
||
- `src/store/gameStore.ts` — `tickTide` / `consumeTideEvents`；tick/pulse/clickNode/autoDecodeTick/startExpedition 应用修饰器；init/hardReset/partialize 兼容
|
||
- `src/hooks/useGameLoop.ts` — 主循环调用 `tickTide`，可见性恢复补检测
|
||
- `src/app/page.tsx` — 接入 StarTideOverlay/Indicator/Notifier；Footer 联动；版本号 v0.3
|
||
|
||
## 十、下一步规划
|
||
|
||
- v0.3 已完成客户端星潮（原计划 socket 全局事件，现以单机版先行，后续可扩展为多人同步）
|
||
- v0.4：云存档 + 排行榜
|
||
- v0.5：全 5 纪元叙事扩展
|
||
- 持续关注 Gitea 工单
|