OpenGame – 港中文開源的端到端網頁遊戲智能體框架

OpenGame是什麼

OpenGame 是香港中文大學 MMLab 開源的首個端到端網頁遊戲智能體框架，通過自然語言提示自動生成可玩的網頁遊戲。框架核心 Game Skill 由 Template Skill（項目骨架模板庫）與 Debug Skill（動態調試協議）組成，搭載專爲遊戲引擎訓練的三階段代碼模型 GameCoder-27B，配合 OpenGame-Bench 動態評估基準，系統性解決跨文件不一致與邏輯缺陷難題。

OpenGame的主要功能

• 端到端遊戲生成：接收自然語言設計需求，自動輸出完整可構建、可運行的網頁遊戲項目，涵蓋從概唸到成品的全流程。
• 遊戲技能系統（Game Skill）
  • Template Skill：基於物理機制分類（如橫版重力、俯視角連續運動、離散網格等），自動選擇並實例化穩定的項目模板家族，確保跨文件結構一致。
  • Debug Skill：維護動態調試協議，累積錯誤簽名、根因與驗證修復方案，實現系統性集成錯誤修復而非孤立語法補丁。
• 遊戲設計文檔（GDD）自動生成：將自然語言需求轉化爲技術化 GDD，動態加載引擎 API 約束，確保機制在選定框架下可行。
• 多模態資產生成：調用圖像、音頻、視頻生成模型，依據 GDD 資產清單自動合成背景、角色動畫、音效及 tilemap 等資源。
• 三層閱讀策略代碼實現：通過漸進式加載 API 摘要、目標源碼與實現指南，結合模板方法模式（Hook-Driven）注入遊戲邏輯，避免上下文溢出。
• 驗證與自修正循環：通過無頭瀏覽器執行構建與測試，解析編譯輸出並迭代修復，直至遊戲可玩。

OpenGame的技術原理

• GameCoder-27B 三階段訓練：基於 Qwen3.5-27B 骨幹，通過持續預訓練（CPT，Phaser/JS 遊戲代碼與文檔）、監督微調（SFT，GPT-Codex 生成複雜設計提示與 MiniMax 合成高質量解答）及執行強化學習（RL，單文件模塊級單元測試反饋），建立遊戲引擎架構先驗與 API 使用模式。
• Physics-First 分類機制：根據物理約束與空間機制（如”無地面支撐的墜落”映射爲平台跳躍原型）對遊戲需求進行原型歸類，指導後續模板選擇。
• 模板方法模式（Hook-Driven Implementation）：代理複製模板文件並覆寫指定鉤子方法（如 setupCustomCollisions），在保留基礎生命週期管理確定性的同時注入特定邏輯。
• 動態代理進化：Template Skill 從單一元模板 M0 通過經驗累積進化爲包含五大家族（重力側視、俯視角連續運動、離散網格、路徑波、UI 驅動）的模板庫 L。Debug Skill 從執行失敗中記錄錯誤簽名、根因與驗證修復，形成 Living Debugging Protocol P，包含高頻不一致類別的預執行校驗。
• OpenGame-Bench 動態評估：通過無頭瀏覽器執行生成遊戲，結合 VLM（視覺語言模型）評判，從構建健康度（Build Health）、視覺可用性（Visual Usability）與意圖對齊度（Intent Alignment）三個維度評分，超越靜態單元測試。

如何使用OpenGame

• 環境準備：安裝 Node.js 20+，克隆倉庫並執行 npm install、npm run build、npm link，將 opengame 命令註冊到系統路徑。
• 配置 API 密鑰：設置 OPENAI_API_KEY 及可選的 OPENAI_BASE_URL、OPENAI_MODEL；同時配置多模態提供商密鑰（圖像、視頻、音頻、推理），如 DashScope、Doubao 等，參考 .env.example。
• 生成遊戲：創建空目錄，執行 opengame -p "Build a Snake clone with WASD controls and a dark theme." --yolo，代理將自動完成端到端構建。
• 本地運行：進入生成項目目錄，執行 npm install 與 npm run dev，在瀏覽器打開 http://localhost:5173 即可遊玩。
• 高級配置：可通過 settings.json（用戶級 ~/.qwen/settings.json 或項目級 .qwen/settings.json）及 CLI 參數調整行爲；設置 GAME_TEMPLATES_DIR 與 GAME_DOCS_DIR 可用絕對路徑在任意位置創建遊戲。

OpenGame的關鍵信息和使用要求

• 開源協議：開源項目，基於 qwen-code 擴展構建。
• 運行模式：當前爲命令行 Headless 模式，一鍵提示詞驅動生成。
• 模型依賴：支持 OpenAI 兼容 API，可選 GameCoder-27B（本地部署）或 Claude Sonnet 4.6 等後端。
• 多模態要求：需自行配置圖像、視頻、音頻生成服務的 API 密鑰，框架不內置默認提供商。
• Node.js 版本：要求 Node.js 20 以上。