WorldX Agent Forge:让 Codex 用一句话搭出一个本地 AI 世界
https://github.com/HuangLittleOrange/worldx-agent-forge
让 AI 写一个小游戏已经不稀奇,但通常只得到几段代码和一张临时页面。地图、角色素材、世界规则和运行环境还是散的,想继续玩就得自己收拾。
WorldX Agent Forge 把这件事做成了一个 Codex Skill。你描述“核战后的超市”或“海盗船上的日常生活”,Codex 负责写世界设定、生成地图和角色图片,再由脚本装配成一个能在本机打开的 WorldX 互动世界。
它生成的不是传统关卡
这个 Skill 内置了开源项目 WorldX 的运行时。WorldX 有地图查看器、角色状态、事件、记忆和时间线系统。生成完成后,浏览器访问 http://localhost:3200/,可以看到角色在地图中活动,也能查看剧情事件和世界状态。
推荐的 Codex Asset Mode 会先让 Codex 写出 world-design.json,再调用 Codex 自带的图片生成工具制作一张俯视地图和每个角色的立绘。脚本负责处理尺寸、sprite sheet 和目录结构,最后启动前后端并切换到新世界。
所以这里的“一句话生成游戏”更接近生成一个可观察、可继续模拟的 AI 沙盒,不是自动做出战斗、关卡、数值成长俱全的商业游戏。好处是素材和世界文件都会保存在本地,可以继续改设定、换图或重新装配。
Asset Mode 省掉了一组图片 API
按推荐流程使用时,不需要另外配置 OpenRouter 或第三方图片模型 Key。原因不是脚本自己会画图,而是 Codex Agent 在对话里调用内置图片工具,再把结果交给本地装配脚本。当前 Codex 环境如果没有图片生成能力,这条流程就走不通。
世界加载之后,如果只浏览地图和设定,可以先不配文本模型。想点击“开始运行”,让角色持续决策、对话并形成记忆,仍要填写 SIMULATION_BASE_URL、API Key 和模型名称。角色资料及模拟上下文会发送给所选模型服务,“本地运行”不等于完全离线。
第一次启动还会在内置 runtime 的多个子目录执行 npm install。仓库确实把 WorldX 源码一起带上了,但依赖仍要联网下载,也会占用一笔磁盘空间。
本地服务的边界要特别留意
我检查代码时发现,WorldX 后端使用 server.listen(PORT),没有显式绑定 127.0.0.1;Express 还开启了宽松 CORS,接口本身没有认证。后端包含推进模拟、修改时间线和保存模型设置等写操作。若系统防火墙允许,同一局域网里的其他设备可能访问 3100 端口。
模型 Key 会明文写进 runtime 根目录的 .env,界面只做遮罩显示。比较稳妥的做法是仅在可信电脑使用,不要把端口映射到公网;运行前把后端改为只监听 localhost,并限制 .env 文件权限。停止使用时也应执行项目提供的 stop 命令。
还有一个许可证问题
仓库公开了全部代码,内置的 WorldX runtime 带有 MIT License;但 WorldX Agent Forge 仓库根目录目前没有 LICENSE,GitHub 也未识别到项目许可证。因此不能把整个 Skill 直接称为“MIT 开源项目”,二次分发或修改发布前最好先向作者确认授权。
我运行了仓库自带的 self_test.mjs,打包结构和内置 runtime 检查通过;这项测试不生成图片,也不代表完整世界创建已经实测成功。它适合愿意折腾 Codex Skill、想快速搭一个 AI 角色沙盒的人。若只是做普通网页小游戏,直接让 coding agent 写一个小项目可能更轻。