常见问题

Entelechy 是游戏引擎吗？

不完全是。它是一个运行时：Host 只知道内存、设备和时间，不知道“游戏”“光照”或“网格”。游戏、渲染器、物理、声音都是用 .ent Kernel 和 .esn 场景写成的程序，可复用的部分放在 packages/ 里。仓库里确实有完整的游戏示例（slg、arcade、voxel），以及通过协议对接 Godot 和 Blender 的桥接。

需要会 Rust 吗？

使用 Entelechy 不需要。所有示例都没有一行 Rust：你写 .ent 和 .esn，用 entelechy 命令运行。只有从源码构建、或者修改运行时本身时才需要 Rust（1.93 或更高）。

有预编译的发行版吗？

docs/USAGE.md 描述了发行包的目录结构（bin/entelechy、include/、lib/、*-wasm32-wasip1.wasm、*-web），但仓库目前是私有的，HANDOFF.md 写明没有计划中的发布。现在请从源码构建。

三个后端结果不一样，以谁为准？

以解释器（--backend cpu）为准。JIT 与它逐位一致，GPU 在舍入误差内一致。entelechy replay --round-apart 可以检查一个程序是否依赖于某种舍入方式。

改动出错会怎样？

不会怎样。编译或校验失败的改动会在 文件:行:列 被拒绝，正在运行的版本继续运行；求值失败的一帧不提交任何状态或文件写入。见热替换与校验。

AI 怎么接入？

通过创作协议：entelechy serve scene.esn 后，在 stdin/stdout 上收发 JSON lines；也可以 --listen 走 TCP/WebSocket，或者通过 C ABI 的 entelechy_request。任何模型、任何语言都可以，权限规则与 CLI、Player 相同。

能在浏览器里运行吗？

可以。Entelechy 可编译为 WebAssembly：JIT 在页面中生成 WebAssembly，GPU 后端运行在浏览器的 WebGPU 上（Chrome / Edge 137 及以上）。bridges/web/play.html 就是页面里的 Player。见嵌入与桥接。

为什么文档里的 GitHub 链接打不开？

仓库 Fynn-3D/entelechy 目前是私有的，只有有访问权限的账号才能打开源码链接。

本文档和仓库里的 docs/ 有什么关系？

仓库的 README.md、docs/*.md 是英文的权威文档。本站以它们和源码为依据重新组织成手册与参考，并补充中文说明；类参考由源码中的表格和 rustdoc 自动生成。两者不一致时以仓库为准，详见关于本文档。