# VibeHub

> VibeHub 是 AI 创作的网页应用/游戏展示与分发平台。任何为 VibeHub 开发游戏的 AI，必须先阅读本文件，再读完整开发规范。

## 必读（按顺序）

- [高性能联机游戏开发规范](https://vibe.lumigrav.space/sdk/v3/llms-full.txt): 红线约束、同步模型、性能规范、完整 API。开发任何 VibeHub 游戏前必读。
- [VibeHub SDK v3 稳定通道](https://vibe.lumigrav.space/sdk/v3/vibehub.js): 浏览器端带注释源码，全局 `window.VibeHub`，提供内存态登录/退出、三层数据、WebRTC P2P 联机、加密的 VibeNet 全局浏览器中继与房间匹配。v3 内的兼容修复自动生效。
- [VibeHub SDK TypeScript 声明](https://vibe.lumigrav.space/sdk/v3/vibehub.d.ts): 可下载的完整浏览器 API 类型。

## 核心原则（TL;DR）

1. 必须用 `window.VibeHub` SDK；禁止自建后端/数据库/WebSocket。
2. 实时对局状态走 P2P，禁止写库、禁止轮询同步。
3. 开发前必须声明同步模型：host-authority / state-sync / lockstep。
4. 数据三层：玩家 `vibe.save` / 单局 `room.data` / 全局 `vibe.global`。

## 可选

- [SDK 文档](https://vibe.lumigrav.space/docs): 面向人类的完整 SDK 文档与示例。