上：隅角咖啡馆——3D AI NPC 对话 + 长期记忆 + AI 导演 ｜ 下：自然语言生成粒子世界
📹 完整 54 秒官方演示 · EN subtitled
OriEra 不是又一个游戏引擎。我们要做的是：在 PC、手机、网页、AR 眼镜（以及未来的脑机接口）上，跑一个能被 AI 驱动、能持续自我演化、用户可以用自然语言创造内容的实时 3D 世界。
架构上是 11 层分层结构，五端一等公民接入，脑机接口在 v1 只留位不接硬件。
🌐 https://oriera-engine.github.io/engine/
13 个可玩 demo，浏览器直接打开：
| Demo | 展示 | 打开 |
|---|---|---|
| 01 Hello Triangle | L1 PAL + WebGPU 清屏三角形 | ▶ |
| 02 ECS Spawn | 20 万粒子 SoA ECS | ▶ |
| 03 Physics Sandbox | 重力 + 碰撞 + 鼠标拖拽 | ▶ |
| 04 Agent Chat | 自然语言控制粒子 | ▶ |
| 05 glTF Model | Three.js 加载 Duck 模型 | ▶ |
| 06 Agent × Physics | 聊天指挥物理世界 | ▶ |
| 07 WebGPU 1M Particles | 100 万粒子 GPU compute | ▶ |
| 08 ECS Visualizer | 交互式 ECS 检视器 | ▶ |
| 09 Full Architecture | L0–L7 全链路架构可视化闭环 | ▶ |
| 10 Word Spirit 言灵世界 | AI 原生小游戏：自然语言改写物理法则 | ▶ |
| 11 Corner Café 隅角咖啡馆 | 3D AI NPC：大模型对话 + 长期记忆 + AI 导演 | ▶ |
| 12 Memory Atlas 记忆星图 | 离线 NPC 记忆写入、检索与时间衰减可视化 | ▶ |
| 13 Generative Gallery 生成式画廊 | 一句话主题 → L8 文生图/文生 3D → L4 热替换装帧小 3D 世界 | ▶ |
graph TB
subgraph L11["L11 应用层"]
UGC[UGC 创作生态 / 同源编辑器]
end
subgraph L10["L10 交互层"]
XR[多模态感知: 手/眼/语音/体/BCI预留]
end
subgraph L9["L9 Agent"]
AGT[认知闭环 / MCP 工具 / AI 导演]
end
subgraph L8["L8 生成式 AI"]
GEN[文生3D / 空间约束 / 校验修复]
end
subgraph L7["L7 推理运行时"]
INFER[端云协同 / 模型生命周期 / Trace]
end
subgraph L6["L6 子系统"]
SUB[物理 / 动画 / 空间音频 / 网络同步]
end
subgraph L5["L5 渲染内核"]
REND[Render Graph / 混合几何: 网格+3DGS+NeRF]
end
subgraph L4["L4 资产管线"]
ASSET[ResourceHandle / 六段式 AI 生成]
end
subgraph L3["L3 对象模型"]
ECS[ECS / WorldObject / Scene / Signal 总线]
end
subgraph L2["L2 核心系统"]
CORE[调度器 / 分层内存 / 确定性回放]
end
subgraph L1["L1 平台抽象"]
PAL[OriGFX / 输入 / 存储 / 网络 / OpenXR]
end
UGC --> XR --> AGT --> GEN --> INFER --> SUB --> REND --> ASSET --> ECS --> CORE --> PAL
XCT[横切: 观测 · 安全 · 计量 · 调试] -.-> L11 & L10 & L9 & L8 & L7 & L6 & L5 & L4 & L3 & L2 & L1
层 ↔ crate 对照、依赖规则与一帧数据流见 docs/ARCHITECTURE.md；
每层的机器可读清单（provides/requires/budgets/degrade）在 manifests/。
| 端 | 目录 | 状态 |
|---|---|---|
| PC (Win/macOS/Linux) | platforms/pc/ |
✅ 骨架 |
| Mobile (iOS/Android) | platforms/mobile/ |
📋 规划 |
| Web (Wasm + WebGPU) | platforms/web/ |
✅ demo 已跑 |
| AR 眼镜 (visionOS / 骁龙 / WebXR) | platforms/ar_glasses/ |
📋 重点适配 |
| 脑机接口（预留） | platforms/bci_reserved/ |
🔒 仅预留 bit 位与 proto，v1 不实现 |
上层代码只读 Capabilities 位图，不写 #[cfg(target_os)]——加新端只改一个文件。
| 层 | 首选技术 |
|---|---|
| 引擎主语言 | Rust（L1–L7、L9 实时层） |
| Web 分发 | Wasm + WebGPU（wgpu 统一后端） |
| 对象模型 | ECS（SoA 布局，TypedArray 参考实现已跑） |
| 渲染 | wgpu / WebGPU，未来支持 3DGS 神经渲染 |
| 物理 | Jolt（Rust），Web 参考实现已跑 |
| Agent | LangGraph + MCP 协议（v1 规则解析，未来接 LLM） |
| 契约 | Protobuf + JSON Schema 2020-12 |
| 构建 | Cargo workspace（JS 侧编辑器/SDK 落地时再引入 pnpm） |
直接打开 https://oriera-engine.github.io/engine/
git clone https://github.com/OriEra-engine/engine.git
cd engine
npx serve .
# 浏览器打开 http://localhost:3000cargo run -p oriera-pc # PC 端清屏窗口
cargo test --workspace # 跑全部单元测试
cargo clippy --workspace -- -D warnings我们欢迎任何形式的贡献——修 bug、写文档、加 demo、提 RFC。
OriEra Studio（Windows 桌面端）把引擎打包成双击即用的形态：内置全部示例离线运行、按硬件推荐并植入模型、五步生成自己的 AI 原生游戏原型——无需科学上网、无需 GitHub、无需命令行。遇到问题可以直接从 Studio 桌面端把反馈（自动附环境信息）提交到本仓库 issues。下载 v0.3.0。
10 月 31 日截止前，本仓库所有 good first issue 均参与 Hacktoberfest（每个任务都写了涉及文件与验收标准，15 分钟指南带你走完全流程）：
👉 挑选你的第一个 issue · 15 分钟提交你的第一个 PR
第一次来？ 15 分钟提交你的第一个 PR → 挑一个 good first issue （每个任务都写了涉及文件和验收标准）。
| 想做什么 | 入口 |
|---|---|
| 理解架构 | ARCHITECTURE.md |
| 参与开源全景（不写代码也行） | OPEN_SOURCE_GUIDE.md |
| 书 ↔ 仓库对照 | BOOK_MAP.md |
| 提问 / 聊天 | Discussions（中英文都行） |
| 改架构 / 动契约 | 先在 Ideas 区 开 RFC，7 天评论期 |
| 加一个 demo | 复制 examples/_template/，10 分钟出活 |
| 报安全问题 | SECURITY.md（不要开公开 issue） |
Apache License 2.0 — 专利授权条款，云厂商友好。
如果 OriEra 让你看到 AGI 时代基础设施的另一种可能，
请给这个仓库一个 ⭐ Star —— 你的关注决定这条开源路线能走多远。
