diff --git a/README.md b/README.md
index 5ff51c8e5..dd0874d4e 100644
--- a/README.md
+++ b/README.md
@@ -4,32 +4,127 @@
 
 你是一名深空考古指挥官，驾驶自治勘探舰回收已「飞升」的以太文明遗留的记忆晶体，解码碎片拼凑出他们的故事，并最终跨越维度发起「接触」。
 
+---
+
+## 🎮 在线游玩
+
+**👉 [https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/](https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/)**
+
+无需安装，打开即玩。支持桌面（鼠标 + 键盘）与移动端（触控）。
+
+---
+
 ## 项目状态
 
-- **版本**：v0.1（MVP 开发中）
-- **栈**：Next.js 16 · TypeScript · Tailwind · shadcn/ui · Canvas · Zustand · Prisma
-- **仓库**：https://git.atdunbg.xyz/Super_Z/echo-nexus
+- **版本**：**v0.7** — CrystalOrb Canvas 粒子系统 + 四维角色属性
+- **栈**：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` 分支）
+
+---
+
+## 核心特色
+
+- **解码共振谜题**：把放置游戏的「等待」变成有节奏的主动小谜题（路径构造法生成器，100% 可解）
+- **碎片涌现叙事**：故事从解码中自然浮现，5 纪元循环命名 + 模板化 lore，不打断玩法
+- **深空全息美学**：晶体 + Canvas 粒子 + 共振波纹的差异化视觉（严格 emerald/rose/amber/fuchsia 四色全息色谱，零蓝色/靛色）
+- **飞升多周目**：终局「接触」后保留蓝图开启新周目，星图天文台 18 个天赋跨周目永久生效
+- **实时巡航玩法**：Canvas 2D 飞船操控 + 8 种实体 + 3 层视差星空，打破纯放置节奏
+- **角色 RPG 深度**：四维属性（探索力/智慧/勇气/灵感）影响所有游戏系统
+
+---
+
+## 游戏系统（10 大系统）
+
+| # | 系统 | 简介 |
+|---|------|------|
+| 1 | 放置采矿 | 中央晶体球 Canvas 粒子系统 + 主动脉冲 + 连击加成 |
+| 2 | 谐振解码 | 原创路径谜题，100% 可解率 |
+| 3 | 技术树 | 三层科技解锁，提升产能/解码/探险 |
+| 4 | 遗迹探险 | 肉鸽系统，6 种节点 + 程序化路径 + BOSS |
+| 5 | 星潮事件 | 6 种动态事件，全屏叠层 + 程序化音效 |
+| 6 | 星图天文台 | 飞升后 3 选 1 天赋 draft，18 个跨周目天赋 |
+| 7 | 回响编年史 | 跨周目叙事时间轴，5 纪元循环命名 |
+| 8 | 深空信标 | 每日挑战 + 本地排行榜 Top20 |
+| 9 | 深空巡航 | Canvas 2D 实时玩法，飞船操控/陨石躲避/星门通关 |
+| 10 | 角色属性 | 四维属性（探索力/智慧/勇气/灵感），飞升获得属性点 |
+
+---
+
+## 开发路线
+
+| 版本 | 核心内容 | 状态 |
+|------|---------|------|
+| 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.9 | 云存档 + 云排行榜 | 🔜 |
+| v1.0 | 全 5 纪元手写叙事 + 多人同步星潮 | 🔜 |
+
+---
 
 ## 文档
 
 - [`docs/01-调研报告.md`](docs/01-调研报告.md) — 游戏市场调研
 - [`docs/02-游戏设计文档.md`](docs/02-游戏设计文档.md) — GDD 策划设计
 - [`docs/03-技术架构.md`](docs/03-技术架构.md) — 技术架构
-
-## 核心特色
-
-- **解码共振谜题**：把放置游戏的「等待」变成有节奏的主动小谜题
-- **碎片涌现叙事**：故事从解码中自然浮现，不打断玩法
-- **深空全息美学**：晶体 + 粒子 + 共振波纹的差异化视觉
-- **飞升多周目**：终局「接触」后保留蓝图开启新周目
-
-## 开发路线
-
-- v0.1 放置 + 解码 + 技术树 + 图谱 + 飞升（当前）
-- v0.2 遗迹探险肉鸽
-- v0.3 音频 + 全局星潮 socket 事件
-- v0.4 云存档 + 排行榜
-- v0.5 全 5 纪元叙事 + 隐藏内容
+- [`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 信标
 
 ---
+
+## 本地开发
+
+```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.7"
+git remote add origin https://git.atdunbg.xyz/Super_Z/echo-nexus.git
+git push -f origin gh-pages
+```
+
+Gitea Pages 会自动从 `gh-pages` 分支提供静态网站服务。
+
+---
+
 © Super_Z · 持续开发中