# 回响星核 / Echo Nexus

> 原创深空考古 **放置策略**游戏 · Original deep-space archaeology **idle strategy** game

你是一名深空考古指挥官，驾驶自治勘探舰回收已「飞升」的以太文明遗留的记忆晶体，解码碎片拼凑出他们的故事，并最终跨越维度发起「接触」。

**关掉浏览器，星核仍在为你工作**——采矿无人机舰队 24h 不间断采矿，放置工程在离线时持续推进，回来后一键领取积累的奖励。

---

## 🎮 在线游玩

**👉 [https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/](https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/)**

无需安装，打开即玩。支持桌面（鼠标 + 键盘）与移动端（触控）。

---

## 项目状态

- **版本**：**v0.16** — 解码阈值叙事事件（全屏碎片释放叠层）+ loreLayer 已读标记 + idleHistory 详情展开 + 移动端 375px 适配审计
- **栈**：Next.js 16 (App Router) · TypeScript · Tailwind CSS 4 · shadcn/ui · Canvas 2D · Zustand · Web Audio API
- **仓库**：[https://git.atdunbg.xyz/Super_Z/echo-nexus](https://git.atdunbg.xyz/Super_Z/echo-nexus)
- **在线版**：[https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/](https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/)
- **部署**：Gitea Pages（静态导出，`BUILD_EXPORT=true next build` → `out/` 推送 `gh-pages` 分支）

---

## 核心特色

- **📡 采矿无人机舰队**：每解锁一个采矿分支技术，就有一台自动采矿无人机加入舰队，24h 持续产出晶体（无需点击）
- **⚙️ 放置工程项目**：6 种工程，派遣后**离线/在线自动推进**，完成领取奖励（晶体/洞见/能量/永久产能加成/随机碎片）
- **🔓 离线收益**：关闭浏览器后产能按 `offlineEff × crystalsPerSec` 持续累积（上限 8h），重新打开弹窗结算「沉睡期间」收益
- **🎯 始终可见的放置徽章**：Header 永远显示「放置中 +X/s」徽章，悬停查看产能构成明细——一眼就知道这是个 idle game
- **🔍 解码共振谜题**：把放置游戏的「等待」变成有节奏的主动小谜题（路径构造法生成器，100% 可解）
- **📜 碎片涌现叙事**：故事从解码中自然浮现，5 纪元循环命名 + 模板化 lore，不打断玩法
- **💎 深空全息美学**：晶体 + Canvas 粒子 + 共振波纹的差异化视觉（严格 emerald/rose/amber/fuchsia 四色全息色谱，零蓝色/靛色）
- **🔄 飞升多周目**：终局「接触」后保留蓝图开启新周目，星图天文台 18 个天赋跨周目永久生效
- **🚀 实时巡航玩法**：Canvas 2D 飞船操控 + 8 种实体 + 3 层视差星空，打破纯放置节奏
- **🧬 角色 RPG 深度**：四维属性（探索力/智慧/勇气/灵感）影响所有游戏系统

---

## 游戏系统（11 大系统）

| # | 系统 | 简介 | 类型 |
|---|------|------|------|
| 1 | **📡 放置采矿** | 中央晶体球 Canvas 粒子系统 + 主动脉冲 + 连击加成 + **自动采矿无人机舰队** | 放置 |
| 2 | **⚙️ 放置工程** | 6 种工程 × 3 槽位，**离线/在线自动推进**，完成领取奖励 | **放置** |
| 3 | **🔓 离线收益** | 关闭浏览器后产能按 `eff × cps` 累积（8h 上限），重新打开结算 | **放置** |
| 4 | 谐振解码 | 原创路径谜题，100% 可解率 | 主动 |
| 5 | 技术树 | 三层科技解锁，提升产能/解码/探险 | 主动 |
| 6 | 遗迹探险 | 肉鸽系统，6 种节点 + 程序化路径 + BOSS | 主动 |
| 7 | 星潮事件 | 6 种动态事件，全屏叠层 + 程序化音效 | 被动 |
| 8 | 星图天文台 | 飞升后 3 选 1 天赋 draft，18 个跨周目天赋 | 元进程 |
| 9 | 回响编年史 | 跨周目叙事时间轴，5 纪元循环命名 | 元进程 |
| 10 | 深空信标 | 每日挑战 + 本地排行榜 Top20 | 每日 |
| 11 | 深空巡航 | Canvas 2D 实时玩法，飞船操控/陨石躲避/星门通关 | 实时 |
| 12 | 角色属性 | 四维属性（探索力/智慧/勇气/灵感），飞升获得属性点 | 元进程 |

---

## 放置系统设计哲学（v0.14 + v0.15 平衡）

回响星核的「放置」不是简单地把数字挂机增长，而是分层呈现 **3 种 idle 节奏**：

### 节奏 1：被动产能（最慢，最持续）
- 采矿无人机舰队 = 你已解锁的采矿技术节点
- 每台无人机 24h 持续产出晶体，无需任何操作
- 晶体进入仓库（受 `crystalCap` 限制），仓库满后停止产出（防溢出）
- **永远在线，离线也累积**

### 节奏 2：放置工程（中等周期，需要决策）
- 6 种工程，时长 1min ~ 1h 不等
- 玩家选择派遣到 3 个槽位之一 → 启动后**离线/在线自动推进**
- 完成后必须**手动领取**（防玩家错过奖励时机）
- 奖励类型多样：晶体 / 洞见 / 能量 / 永久产能加成 / 随机碎片
- **核心 idle loop：派遣 → 离开 → 回来 → 领取 → 再派遣**

### 节奏 3：离线收益（最长周期，回归奖励）
- 关闭浏览器后，被动产能按 `offlineEff`（默认 50%，可通过技术提升至 100%）继续累积
- 上限 8 小时（防极端挂机）
- 重新打开页面弹窗结算：「你离开了 X 小时，星核为你产出 Y 颗晶体」
- **回归玩家的"啊我回来了"瞬间**

---

## 开发路线

| 版本 | 核心内容 | 状态 |
|------|---------|------|
| v0.1 | 放置 + 解码 + 技术树 + 图谱 + 飞升 | ✅ |
| v0.1.1 | 解码可解性修复（路径构造法） | ✅ |
| v0.2 | 遗迹探险肉鸽系统 | ✅ |
| v0.2.1 | 程序化音频 + 14 项成就 | ✅ |
| v0.3 | 星潮事件系统 | ✅ |
| v0.3.1 | 星图天文台元进程 | ✅ |
| v0.4 | 回响编年史系统 | ✅ |
| v0.5 | 深空信标系统 | ✅ |
| v0.5.1 | Gitea Pages 静态部署 + 新手教程 | ✅ |
| v0.5.2 | 离线收益报告 + 标签页 UI 重设计 | ✅ |
| v0.6 | 深空巡航 Canvas 2D 实时玩法 | ✅ |
| v0.7 | CrystalOrb Canvas 粒子系统 + 四维角色属性 | ✅ |
| v0.8 | 巡航玩法增强 / BOSS 关卡 / 道具掉落 | ✅ |
| v0.8.1 | 探险平衡 + 信标系统扩展（周挑战 + 信标链） | ✅ |
| **v0.14** | **放置系统：采矿无人机舰队 + 6 种放置工程 + 永久产能加成 + 始终可见 idle 徽章** | ✅ |
| **v0.15** | **叙事深化（8 碎片 × 2 层 = 16 层 loreLayers）+ 永久加成 softcap + 批量领取 + 完成 toast + StatsPanel idle 统计** | ✅ |
| **v0.16** | **解码阈值叙事事件（5 里程碑全屏叠层）+ loreLayer 已读标记 + idleHistory 详情展开 + 移动端 375px 适配审计** | ✅ |
| v0.17 | 星潮三频段切换 + 健康设计（每日软上限 + 星核建议休眠） | 🔜 |
| v1.0 | 全 5 纪元手写叙事 + 多人同步星潮 | 🔜 |

---

## 文档

- [`docs/01-调研报告.md`](docs/01-调研报告.md) — 游戏市场调研
- [`docs/02-游戏设计文档.md`](docs/02-游戏设计文档.md) — GDD 策划设计
- [`docs/03-技术架构.md`](docs/03-技术架构.md) — 技术架构
- [`docs/04-解码系统修复-v0.1.1.md`](docs/04-解码系统修复-v0.1.1.md) — v0.1.1 解码修复
- [`docs/05-遗迹探险系统-v0.2.md`](docs/05-遗迹探险系统-v0.2.md) — v0.2 探险系统
- [`docs/06-音频与成就系统-v0.2.1.md`](docs/06-音频与成就系统-v0.2.1.md) — v0.2.1 音频与成就
- [`docs/07-星潮事件系统-v0.3.md`](docs/07-星潮事件系统-v0.3.md) — v0.3 星潮
- [`docs/08-星图天文台系统-v0.3.1.md`](docs/08-星图天文台系统-v0.3.1.md) — v0.3.1 天文台
- [`docs/09-回响编年史系统-v0.4.md`](docs/09-回响编年史系统-v0.4.md) — v0.4 编年史
- [`docs/10-深空信标系统-v0.5.md`](docs/10-深空信标系统-v0.5.md) — v0.5 信标
- [`docs/11-放置系统-v0.14.md`](docs/11-放置系统-v0.14.md) — **v0.14 放置系统（idle operations）**
- [`docs/12-叙事深化-v0.15.md`](docs/12-叙事深化-v0.15.md) — **v0.15 loreLayers 多层碎片文本 + softcap + 批量领取**
- [`docs/13-叙事事件-v0.16.md`](docs/13-叙事事件-v0.16.md) — **v0.16 解码阈值里程碑叠层 + loreLayer 已读 + 移动端适配**

---

## 本地开发

```bash
# 安装依赖
bun install

# 启动 dev 服务器（http://localhost:3000）
bun run dev

# 静态导出（用于 Gitea Pages 部署）
BUILD_EXPORT=true bun run build:static
# 产物在 out/ 目录，basePath 为 /Super_Z/echo-nexus

# 代码检查
bun run lint
```

---

## 部署到 Gitea Pages

```bash
# 1. 静态导出
BUILD_EXPORT=true bun run build:static

# 2. 推送到 gh-pages 分支
cd out
git init && git checkout -b gh-pages
git add -A
git commit -m "deploy: v0.16"
git remote add origin https://git.atdunbg.xyz/Super_Z/echo-nexus.git
git push -f origin gh-pages
```

Gitea Pages 会自动从 `gh-pages` 分支提供静态网站服务。

---

## 灵感来源（Inspired by）

- **Antimatter Dimensions** — 数值膨胀美学 + 终端 UI
- **Universal Paperclips** — 叙事驱动的放置游戏（Frank Lantz）
- **A Dark Room** — 极简文字放置游戏（Michael Townsend）
- **Melvor Idle** — 离线收益 + 多技能树
- **Outer Wilds** — 知识解锁式考古
- **Cookie Clicker** — Orteil 的放置游戏范式定义

---

## 健康游戏设计声明

放置游戏天然具有"低投入高回报"的成瘾性，可能对学业/工作压力大的青年造成时间碎片化风险。回响星核主动采取以下健康设计：

- ✅ **离线收益上限 8h**——防止 24h 挂机
- ✅ **工程完成需手动领取**——避免"打开就有奖励"的条件反射
- ✅ **无广告、无内购**——纯粹的单机体验
- 🔜 **v0.17 计划**：每日软上限 + "星核建议休眠"提醒（每 1 小时主动提示休息）

参考学术研究：
- Frank Lantz GDC 2018 "This Is Your Brain on Games"
- Reuters 2025 "Cozy video games can quell stress and anxiety"
- DOI:10.3389/fpsyg.2026.1774030 TikTok 时代学术倦怠研究

---

© Super_Z · 持续开发中