OpenGame架构深度解析CLI、Core与工具系统如何协同工作【免费下载链接】OpenGameOpenGame: Open Agentic Coding for Games项目地址: https://gitcode.com/gh_mirrors/op/OpenGameOpenGame是一个面向终端的开源游戏 Agent 框架输入一句自然语言 Prompt它就能端到端生成可玩的 Web 游戏。本文带你快速拆解它的OpenGame 架构CLI 包负责面对面Core 包负责动脑子工具系统负责动手干三者协作完成从 Prompt 到可玩游戏的全过程。3 层架构总览一句话看懂分工OpenGame 由两个核心包加一套工具体系组成官方架构图解见 architecture.md层模块角色代码位置 前台层CLI 包处理输入、渲染输出、管理会话与主题packages/cli/ 后台层Core 包构建 Prompt、调度模型 API、管理状态packages/core/ 执行层工具系统读写文件、执行命令、生成游戏资产packages/core/src/tools/这种前端/后端分离是典型的模块化设计CLI 只关心用户体验Core 只关心模型编排工具则可以自由扩展——未来换一套界面比如 IDE 插件也不用重写后端。CLI 包终端里的前台接待CLI 包是所有用户指令的入口核心职责有四块输入处理支持直接文本、斜杠命令/help、/model、file文件引用和!commandshell 快捷执行Headless 无头模式opengame -p ...一条命令跑完整个游戏生成流程适合 CI 和批量生成输出渲染终端语法高亮、主题定制JSON/Stream-JSON 结构化输出方便程序对接配置管理命令行参数、环境变量、settings.json多层配置合并。无头模式的执行主流程实现于 nonInteractiveCli.ts它根据输出格式创建 JSON 适配器注册 SIGINT/SIGTERM 信号实现优雅退出然后把用户输入交给 Core 的模型客户端逐回合执行。Core 包幕后大脑如何驱动模型Core 包是 OpenGame 的后台引擎收到 CLI 转发的请求后做三件事构建 Prompt拼接会话历史 工具定义、调用模型 API、执行工具并回传结果。其中最关键的是回合循环——每轮模型可能返回文字回答也可能发起一次工具调用。这一循环的事件类型定义在 turn.ts 中包括ToolCallRequest工具调用请求、ToolCallConfirmation执行前审批、LoopDetected死循环检测等十余种事件CLI 就是靠订阅这些事件来渲染进度的。模型侧通过内容生成器抽象接入不同后端OpenAI 兼容 API、Anthropic、Gemini 等配置见 config/。换模型只需改环境变量代码零改动。工具系统Agent 的手和脚工具系统定义在 packages/core/src/tools/每个工具遵循Builder 构建 Invocation 执行的两段式设计先校验参数再决定是否需要用户确认最后执行——设计基类见 tools.ts。内置工具可分为三类文件操作read_file、write_file、edit、grep_search、glob、list_directory—— 让 Agent 读懂并改写代码库环境操作run_shell_command需审批、web_fetch、web_search游戏专用classify_game_typegame-type-classifier.ts、generate_game_assets图/视频/音频资产生成、generate_tilemap自动切图、generate_gdd游戏设计文档。全部工具名常量集中登记在 tool-names.ts。除了内置工具Core 还通过 tool-registry.ts 支持MCP 协议——连接外部 MCP 服务器即可动态发现并挂载新工具扩展性拉满。协作流程一次游戏生成如何跑通以opengame -p 做一个贪吃蛇为例完整链路是CLI 接棒解析参数与配置进入无头模式nonInteractive/Core 编排构建含工具定义的 Prompt发给模型工具接力模型依次调用classify_game_type→read_file模板 →write_file/edit写代码 →run_shell_command跑沙箱验证审批拦截涉及写文件/跑命令的操作触发ToolCallConfirmationHeadless 下自动提权为auto-edit循环直到可玩结果回传模型继续推理直到游戏端到端可运行CLI 打印产物路径。这个生成—运行—修复循环正是 OpenGame 的Game Skill核心模板技能负责搭稳定骨架调试技能负责系统性修复集成错误实现见 agent-test/含模板库 templates/ 与调试协议 debug-skill/。设计亮点新手值得留意的 4 个细节配置分层清晰优先级为 命令行参数 环境变量 项目设置 用户设置 默认值参考 docs/developers/architecture.md安全默认值只读工具免审批写操作默认需确认shell 命令在无头模式下默认禁用--yolo才放开事件驱动渲染Core 只发事件、CLI 只画界面两者解耦日志与 UI 互不干扰资产管线独立图像/视频/音频供应商可分别配置OPENGAME_IMAGE_PROVIDER等见 api-keys.md。总结OpenGame 架构的精妙之处在于分工明确的事件驱动流水线CLI 管交互Core 管编排工具管执行游戏专用工具与 MCP 让能力无限延伸。想动手深入建议从 README.md 的 Quick Start 入手再对照 docs/users/overview.md 与本文提到的源码路径逐层阅读——30 分钟就能跑通你自己的第一个生成游戏。【免费下载链接】OpenGameOpenGame: Open Agentic Coding for Games项目地址: https://gitcode.com/gh_mirrors/op/OpenGame创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考