SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场opengame-agentic-game-creation

opengame-agentic-game-creation

编程与开发

查看项目

更新于 10-15 15:14

技能介绍

用途

OpenGame 是一个开源的 TypeScript 智能体框架，用于从单条自然语言提示端到端地生成完整可玩的网页游戏（HTML/JS/CSS）。它面向希望用智能体方式完成网页游戏生成、调试与自动化评估的场景。

主要能力

  • 接收高层级游戏设计提示词，产出可在浏览器中运行的游戏（HTML/JS/CSS）。
  • Template Skill：维护一个持续增长的模板骨架库，用于搭建稳定的项目架构；支持按提示词语义匹配模板、从模板脚手架化新项目，以及把成功作品保存为新模板。
  • Debug Skill：维护一份「已验证修复」活协议（debug-protocol.json），系统性地修复跨文件集成错误；支持迭代修复循环，并在成功后将新的已验证修复自动写入协议。
  • OpenGame-Bench：通过无头浏览器执行加 VLM 评判，在三个维度上评分——Build Health（能否编译并无错运行）、Visual Usability（UI 元素是否可见、可读、可交互）、Intent Alignment（生成游戏是否匹配原始提示词的设计意图），并提供 150 条游戏提示词基准。
  • 支持任何 OpenAI 兼容的 LLM 后端（GPT-4o、Claude、GameCoder-27B 等），也支持自托管端点。

使用方式

前置条件：Node.js >= 20.0.0；一个 OpenAI 兼容的 API 密钥（或自托管 GameCoder-27B 端点）。

安装：

git clone https://github.com/leigest519/OpenGame.git
cd OpenGame
npm install
cp .env.example .env

.env 配置：

OPENAI_API_KEY=$OPENAI_API_KEY
OPENAI_BASE_URL=https://api.openai.com/v1   # or your custom endpoint
MODEL_NAME=gpt-4o                            # or gamecoder-27b, claude-3-5-sonnet, etc.
VLM_API_KEY=$VLM_API_KEY
VLM_BASE_URL=https://api.openai.com/v1
VLM_MODEL_NAME=gpt-4o
OUTPUT_DIR=./output
MAX_DEBUG_ITERATIONS=5

主要 CLI 命令：

npm run generate -- --prompt "Build a top-down shooter where a spaceship avoids asteroids"
npm run generate -- \
  --prompt "Create a tower defense game with 3 enemy types" \
  --model gpt-4o \
  --output ./my-games
npm run bench -- --prompts ./bench/prompts.json --output ./bench-results
npm run evaluate -- --game-dir ./output/my-game
npm run serve -- --game-dir ./output/my-game
npm run templates -- --list
npm run templates -- --add ./output/my-game --name platformer-base

也提供编程式 API：通过 OpenGameAgent 编排生成，配合 GameSkill、TemplateSkill、DebugSkill；TemplateSkill 可直接用于匹配、脚手架化与保存模板；DebugSkill 可配合 BuildRunner 运行修复循环；OpenGameBench 可对单个游戏或一批提示词进行评估。

适用场景

  • 从文本提示快速生成可玩网页游戏原型。
  • 用模板库与调试协议提升生成架构稳定性、降低跨文件集成错误。
  • 对生成游戏做自动化质量评估（构建健康度、视觉可用性、意图对齐）。
  • 使用自托管 GameCoder-27B 或任意 OpenAI 兼容模型进行游戏生成。

限制

  • 需要 Node.js >= 20.0.0 及 OpenAI 兼容 API 密钥或自托管端点；缺失项暂未提供。
  • OpenGame-Bench 无头浏览器评估需安装 Chromium/Chrome（如 npx playwright install chromium）。
  • 调试循环在达到最大迭代次数后可能仍无法修复，需检查 debug-protocol.json 或 build.log 并人工补充修复条目。
  • 模板匹配依赖提示词语义相似度，模板越多样匹配越准。
  • 收费、价格信息暂未提供。
  • 许可：Apache-2.0。