悦悦居智能 · 项目平台产品展示 · 开发日记 · 进度追踪
此项目暂未在产品展厅公开展示,你正在通过直链访问。在 管理看板勾选「在产品展厅展示」即可公开。
M
进行中游戏引擎

MagicEngine 悦居魔法引擎

从 0 构建 AI 原生游戏引擎:预算感知 + AI 进编译链,用「编译目标」而非「导出按钮」覆盖 4MB 微信小游戏到 PS5;P0 用一款真实上线的小游戏证明效率假设(Gate 0 六项指标 ≥4 项通过)

42%

开发成果 2/25

项目简介

北京悦居智能科技中心自研游戏引擎,代号 MagicEngine。

【工程量 · 2026-10-31 11:45 构建快照】1,282 个文件 / 442,850 行:源码 234,112 行 · 文档 60,285 行 · 脚本与配置 148,453 行,另有 186 个二进制资产。规模:20 个 crate / 3178 个测试 / interface 契约 17 份 / docs 顶层 21 篇 md(ADR 29 份另计:docs/adr 27 + tools/adr 2)。口径:git ls-files 实测、不含生成物;site/ 虽然已进版本库,仍排除在工程量外——它整站是 web/ 与 docs/ 的渲染结果,算进去等于把同一份手写内容数两遍。每次构建重算,python3 build_board.py --scale 打印同一句,看板页与这里逐字比对,不一致即构建失败;CI 每轮也打印这一行(不靠记性)。

【定位】不做「另一个全能引擎」——UE5 是二十年数千人年的积累,正面比画质必输。定位是「预算感知 + AI 进编译链」的引擎,护城河在 MIR(带预算注解与生成溯源的内容图)与跨端编译,不在渲染器本身。

【核心抽象 · MIR】内容以带类型、带预算注解、带生成溯源的图结构存在,文本可 diff。AI 只能通过 mir.query / patch / measure 三个接口改它,每次改动即一次 commit —— 产出可 review、可回滚、可复现。硬校验由确定性代码判定,LLM 永不参与硬约束判定。

【关键洞察 · AI Bake】工具期云端生成 → 编译成确定性数据 → 运行期零推理。这样 4MB 小游戏也能是「AI 引擎」,不必在端上跑模型。

【跨端】Rust 内核 + C ABI + C++ 后端,RHI 边界必须是 C ABI(主机 SDK 全 C++ 且受 NDA)。编译目标按「后端能力」分级而非按「平台名」:微信小游戏 iOS 侧有原生 Metal 后端(compute/indirect/UAV 可用),Android 侧仍是 WebGL2(无 compute),同一款游戏要出两份 lower 结果。

【已落地】架构基线 docs/ 21 篇顶层 md + 17 份机读契约(rhi.ffi.h 文档 v26 / ABI 8;v6 是当年的冻结基线,此后每版按版本表追加,唯一上游是 interface/MANIFEST.json 里那份 why);四 Agent 扇区模型 + 越界守卫;MIR 全链路(lexer / parser / AST / 校验 / 二进制 mirb / 63 码 11 域,往返判据 encode(decode(b))==b)+ lower pass + chain::compile;CLI 15 个子命令(new / fmt / validate / build / pack / size / atlas / survey / sym / bench / doctor / diff / run / bake / verify;pack 产出 dist/ 目录 + pack.json 包体账,四档预算,自校验不符 exit 70);网站三页:首页 / 公开看板 /board/(更新标记层:绿=没看过 · 蓝=看过 · 红点=往哪看)/ 架构总览 /arch/(分层图从 cargo metadata 派生,与 docs/01 §6.1 逐项对账,对不上即构建失败);网站产物 site/ 进版本库(语义=最近一次发布的快照),线上可反查 commit:https://magic-engine.filebreeze.cn/deploy.txt ;CI 68 步 · 3178 个测试,含看板、协商板、站点可构建三重校验;Gate 0 六项仪表盘(tools/report/gate0.py,四态 pass/fail/unknown/gap,恒 exit 0);SfxForge 程序化音效(12 配方 / 32 资产);中文点阵文本链(离线烘 606 字 16×16 1 位点阵,ASCII 与汉字同图集,coin-run = 「铜钱江湖」整套界面文案在跑);生成式音频适配层 genai.py(11 后端登记)。

【P0 计划】2026-11-02 起 40 周,20 个双周迭代(S0–S19,含 ADR-0018 加的 S18/S19),产能按四个泳道记(A 架构编译链 / B 引擎渲染 / C 工具平台 / D 内容),计划内 636 人日 / 155 个任务,产能口径每迭代 34 人日(20 迭代 ⇒ 上限 680 人日)。当前只有 3 台机器(2026-10-22 起):A1 一台兼 D 泳道、A2 第二台、A3 第三台;A1 是唯一合并者。三个不可压缩项共约 8 周(包体攻坚 3-4 周、真机兼容 3 周、平台审核 1-3 周)。

【止损线】Gate 0 六项指标 <4 项通过即止损;三个降级方案预定触发:A 基准 / B 单人 MVP / C 只做工具(把 AI 挂到 Cocos 上,8 周止损)。

开发历程 150 条

查看全部开发日记 →

周期

2026-10-22 → 2027-04-30