[Github] OpenGame – 基于 Phaser 的 AI 网页游戏生成框架

OpenGame 是香港中文大学 MMLab 开源的 AI 网页游戏生成框架：它让编码代理读取游戏提示词，选择模板、写入 Phaser 项目并在浏览器运行后继续调试。它适合希望研究“代理如何完成一整个小游戏工程”的开发者，不等于输入一句话就能稳定产出可商用成品。

它怎样生成游戏

项目把工作流拆成 Template Skill 与 Debug Skill。前者根据需求选择基础模板并组织代码，后者启动项目、观察运行结果，再修改错误。仓库中的示例提示词往往会写清玩法、操作方式、美术风格、界面元素和胜负条件，因此“提示越具体，结果越可控”比“一句话生成游戏”更接近项目的实际用法。

OpenGame 当前主要面向 Web 游戏，README 展示的流程围绕 Phaser 项目展开。若目标是 Unity、Unreal 或原生移动游戏，不应把这套工作流当作可直接替代的生产管线。

安装与启动

官方说明要求 Node.js 20 或更高版本。项目没有提供稳定版 Release，当前安装方式是从源码构建并把命令链接到本机：

git clone https://github.com/leigest519/OpenGame.git
cd OpenGame
npm install
npm run build
npm link
opengame -p "制作一个带计分和重新开始按钮的俯视角躲避游戏" --yolo

npm link 会注册全局命令；不想污染全局环境时，可在容器、测试机或单独的 Node 版本环境中试用。运行前也应先查看仓库最近的提交与 Issue，因为源码安装不会自动获得传统发行版的兼容性保证。

Prompt 要写到什么程度

建议至少写清五类约束：游戏循环、键鼠或触控操作、失败与得分规则、所需页面状态、允许使用的素材来源。比如“做一个游戏”无法说明镜头、碰撞和结束条件，而“60 秒一局、方向键移动、碰到障碍扣血、三条命、结算页可重开”更容易被转成可验证的任务。

先生成最小玩法，再逐项增加音效、关卡和动画，比一次塞入全部需求更容易定位错误。任何第三方图片、字体和音频仍需由使用者核对授权，生成流程不会替你取得商业许可。

模型 API 与素材密钥

OpenGame 使用兼容 OpenAI 接口格式的模型配置，主要环境变量包括 OPENAI_API_KEY、OPENAI_BASE_URL 与 OPENAI_MODEL。素材生成可再配置独立的 OPENGAME_* 提供方。不同服务即使声称兼容，也可能在工具调用、上下文长度或返回格式上有差异，遇到异常应先用最小请求确认接口。

密钥只应放在本地环境变量或密钥管理器中，不要写进 Prompt、仓库、截图或前端代码。生成过程中还可能把提示词和代码发送给所选 API 服务，处理未公开项目时需要先确认服务商的数据政策。

当前开放边界

项目 README 介绍了 GameCoder-27B 与 OpenGame-Bench，但同时注明模型权重链接和评测流程仍将后续发布。这意味着现阶段可以审查和运行的是 OpenGame 框架源码，不能把尚未公开的权重或评测管线当成已经可下载的组成部分。

截至 2026 年 8 月 1 日，GitHub 仓库采用 Apache-2.0 许可证，约有 2,769 个 Star、398 个 Fork，未归档；仓库没有正式 Release。Star 是关注度指标，不代表稳定性、安全审计或商用适配结论。

运行前的权限检查

--yolo 会让代理在更少确认的情况下执行 Shell 命令和修改文件。初次试用应放在没有真实密钥和业务源码的隔离目录，确认将执行的命令、网络访问和文件范围，再决定是否启用该模式。不要在包含生产凭据、SSH 密钥或个人文档的工作目录直接运行自治代理。

项目入口与参考资料

• OpenGame GitHub 仓库
• OpenGame 论文页面

先阅读 README 的安装和安全说明，再以一个可随时删除的小游戏目录验证流程；如果只是想快速做一个无需维护代码的小游戏，成熟的可视化编辑器可能更省时间。