From 27bb1555e5a2b7915b253cb1cab4aeb799627a07 Mon Sep 17 00:00:00 2001
From: Super_Z <1401203083@qq.com>
Date: Tue, 23 Jun 2026 13:51:32 +0000
Subject: [PATCH] =?UTF-8?q?feat(v0.3):=20=E6=98=9F=E6=BD=AE=E4=BA=8B?=
 =?UTF-8?q?=E4=BB=B6=E7=B3=BB=E7=BB=9F=20-=206=E7=A7=8D=E5=91=A8=E6=9C=9F?=
 =?UTF-8?q?=E6=80=A7=E5=85=A8=E5=B1=80=E7=8E=A9=E6=B3=95=E4=BF=AE=E9=A5=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 6种星潮: 晶体潮(产能x2)/谐振风暴(解码x1.6)/遗迹共振(探险+5力+30血)/虚空低语(洞见x2)/星核悸动(接触x3脉冲x2)/寂静期(产能x0.5,结束补偿洞见)
- 触发: 首次30s, 常规间隙40s, 持续75s, 权重抽取, 飞升重置
- UI: 顶部指示器芯片(倒计时) + 全屏背景叠层(色带+呼吸光) + Toast通知 + Footer联动
- 音效: tideStart(神秘扫频) + tideEnd(柔和消退), 程序化合成
- 修饰器: 产能/脉冲/解码奖励即时乘, 洞见/接触率进缓存, 探险力/血量即时加
- QA: agent-browser全流程通过(触发/指示器/叠层/寂静期补偿), VLM视觉确认, lint零错误
---
 docs/07-星潮事件系统-v0.3.md | 113 +++++++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 docs/07-星潮事件系统-v0.3.md

diff --git a/docs/07-星潮事件系统-v0.3.md b/docs/07-星潮事件系统-v0.3.md
new file mode 100644
index 000000000..60b863636
--- /dev/null
+++ b/docs/07-星潮事件系统-v0.3.md
@@ -0,0 +1,113 @@
+# 回响星核 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 工单