🎮 Isle Game Lab

一分钟内让你的创意变得可玩 ✨

一个基于 ECS (Entity-Component-System) 架构的现代化 Web 游戏开发框架。支持确定性游戏逻辑、实时回放和引擎无关的开发体验。

🚀 1分钟快速开始

# 克隆项目
git clone <your-repo>
cd isle-game-lab

# 安装依赖 (2-3秒)
npm install

# 启动开发服务器 (3-5秒)
npm run dev

# 打开浏览器访问 http://localhost:3000

✨ 现在就看到贪吃蛇游戏运行！ 其余功能只需修改 /src/gameplay/ 目录下的代码即可开始开发。

🏗️ 核心特性

✨ 特色功能	🎯 实际效果	📚 学习资源
ECS 架构	数据与逻辑分离，超高性能	.github/ecs-guidelines.md
Intent 系统	确定性游戏逻辑，支持录制回放	.github/ecs-guidelines.md#intent-
即时响应	PixiJS 8 WebGL 渲染，无延迟	src/presentation/adapters/
类型安全	TypeScript 5 全栈推导	tsconfig.json
现代工具链	Next.js 16 + React 19 + Vitest	.github/tech.md

📁 项目结构 (精简版)

src/
├── core/               # 🎯 框架核心
├── gameplay/           # 🎮 游戏逻辑 (这里开始开发!)
├── presentation/       # 🎨 UI 与渲染 (PixiJS 接入)
└── app/               # 🌐 Next.js 页面

🛠️ 核心操作

开发与测试

npm run dev           # 启动开发服务器
npm run test          # 运行测试用例
npm run type-check    # 检查类型错误

快速原型开发

1. 想加新功能？ → 编辑 /src/gameplay/systems/
2. 需要新组件？ → 添加到 /src/gameplay/components/
3. UI 交互？ → 修改 /src/presentation/ui/

📖 学习路径

🍼 新手 (5分钟构建你的第一个游戏)

1. 阅读 📋 组件设计规范
2. 查看 🏗️ 架构分层指南
3. 运行贪吃蛇示例，理解 ECS 流程

🚀 中级开发者 (增强现有功能)

1. 掌握 ⚡ ECS API 详解
2. 学习 🎯 Intent 驱动编程
3. 扩展蛇游戏或创建新玩法

🎮 高级开发者 (定制框架)

1. 研究 🧱 ECS 框架架构
2. 实现 💾 持久化系统
3. 为其他引擎适配框架

---

🔍 当前状态

• ✅ ECS 框架: 核心实现完成，支持实体管理、系统调度、事件机制
• ✅ 贪吃蛇示例: 可运行的基础版本 (正在调试渲染同步)
• 🔧 正在开发: 持久化层和高级 Intent 功能
• 📋 下个目标: 完善 UI 绑定和状态同步

---

🤝 贡献指南

我们欢迎各种形式的贡献！从修复拼写错误到重构核心代码。

开始贡献:

1. 查看 📝 代码规范
2. 阅读 ⚡ API 文档
3. Fork & 创建你的 feature branch

---

基于 MIT 许可证开源。创造有趣的游戏，让世界更美好！ 🌍