[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82052":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":8,"pushedAt":8,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":13,"starSnapshotCount":13,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},82052,"worldx-agent-forge","HuangLittleOrange\u002Fworldx-agent-forge","HuangLittleOrange",null,"TypeScript",32,4,24,0,3,6,38.2,false,"main",true,[],"2026-06-12 04:01:36","# WorldX Agent Forge\n\nWorldX Agent Forge 是一个自包含的 Codex Skill。你可以在 Codex 里用一句话描述一个游戏世界，Codex 会生成世界设定、地图图片、角色图片，并把这些素材装配成一个可以在本地运行的 WorldX 互动模拟世界。\n\n这个项目内置了 WorldX 运行时，所以用户安装 skill 后不需要再单独下载 WorldX 项目。\n\n![Codex 生成结果](docs\u002Fimages\u002Fcodex-demo-result.png)\n\n![WorldX 运行画面](docs\u002Fimages\u002Fworldx-demo.png)\n\n## 项目介绍\n\nWorldX Agent Forge 的目标是把 Codex 变成一个“一句话生成 WorldX 游戏世界”的 agent。\n\n它包含：\n\n- `SKILL.md`：告诉 Codex 什么时候使用这个 skill，以及如何生成和装配世界。\n- `scripts\u002F`：启动、诊断、素材处理、WorldX 世界装配脚本。\n- `assets\u002Fworldx-runtime\u002F`：内置的 WorldX 开源运行时。\n- `references\u002F`：WorldX 路径、接口、排错说明。\n\n标准流程是：\n\n1. 用户在 Codex 里描述一个世界。\n2. Codex 写出 `world-design.json`。\n3. Codex 用内置图片生成能力生成地图和角色素材。\n4. 脚本把素材装配成 WorldX 世界目录。\n5. 内置 WorldX app 在本地启动，访问 `http:\u002F\u002Flocalhost:3200\u002F` 即可游玩和查看。\n\n## 基于 WorldX 开源项目\n\n本项目内置并适配了开源项目 [YGYOOO\u002FWorldX](https:\u002F\u002Fgithub.com\u002FYGYOOO\u002FWorldX)。\n\nWorldX 提供核心运行能力：\n\n- 前端世界查看器\n- 后端模拟服务\n- 世界和时间线加载\n- 角色状态与事件系统\n- 地图、角色、场景配置格式\n\nWorldX Agent Forge 在 WorldX 之上增加：\n\n- Codex Skill 工作流\n- Codex Asset Mode\n- Codex 生成素材后的本地装配流程\n- 启动、诊断、恢复脚本\n- 自包含 runtime，用户无需额外 clone WorldX\n\n内置 WorldX 代码位于：\n\n```text\nassets\u002Fworldx-runtime\u002F\n```\n\nWorldX 原始许可证位于：\n\n```text\nassets\u002Fworldx-runtime\u002FLICENSE\n```\n\n请在二次分发或修改时保留 WorldX 的 MIT License 声明。\n\n## 安装方法\n\n把仓库 clone 到 Codex skills 目录：\n\n```bash\nmkdir -p \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\"\ngit clone git@github.com:HuangLittleOrange\u002Fworldx-agent-forge.git \\\n  \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\"\n```\n\n如果你没有配置 GitHub SSH，也可以用 HTTPS：\n\n```bash\nmkdir -p \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\"\ngit clone https:\u002F\u002Fgithub.com\u002FHuangLittleOrange\u002Fworldx-agent-forge.git \\\n  \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\"\n```\n\n安装后重启 Codex，让 Codex 重新发现 skill。\n\n## 怎样使用\n\n重启 Codex 后，在对话里直接提到：\n\n```text\n$worldx-agent-forge\n```\n\n示例：\n\n```text\n用 $worldx-agent-forge 生成一个核战后超市，六个幸存者被困在里面。\n使用 Codex Asset Mode，不要用 OpenRouter。\n```\n\n或者：\n\n```text\n用 $worldx-agent-forge 生成一个海贼船上的日常生活模拟游戏。\n角色和画面使用原创设定，不要直接复刻已有版权角色。\n```\n\nCodex 会自动完成：\n\n1. 设计世界规则、角色、地点、互动元素。\n2. 生成地图图片。\n3. 生成角色图片。\n4. 把图片装配成 WorldX 需要的地图和角色 sprite sheet。\n5. 创建新的 WorldX 世界。\n6. 启动本地 WorldX app。\n7. 打开或提示你访问：\n\n```text\nhttp:\u002F\u002Flocalhost:3200\u002F\n```\n\n## 第一次运行会发生什么\n\n第一次启动时，skill 会在内置 WorldX runtime 中自动安装依赖：\n\n```bash\nnpm install\n```\n\n依赖会安装在：\n\n```text\nassets\u002Fworldx-runtime\u002Fnode_modules\u002F\nassets\u002Fworldx-runtime\u002Fclient\u002Fnode_modules\u002F\nassets\u002Fworldx-runtime\u002Fserver\u002Fnode_modules\u002F\nassets\u002Fworldx-runtime\u002Forchestrator\u002Fnode_modules\u002F\nassets\u002Fworldx-runtime\u002Fgenerators\u002Fnode_modules\u002F\n```\n\n这些目录已被 `.gitignore` 忽略，不会提交到仓库。\n\n## 常用命令\n\n你通常不需要手动运行这些命令，Codex 会按 skill 流程调用它们。排错时可以手动执行。\n\n自检：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fself_test.mjs\"\n```\n\n启动 WorldX：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fworldx.mjs\" start\n```\n\n查看状态：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fworldx.mjs\" status\n```\n\n停止 WorldX：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fworldx.mjs\" stop\n```\n\n诊断配置和端口：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fworldx.mjs\" diagnose\n```\n\n手动装配 Codex 生成的素材：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fworldx.mjs\" assemble-codex \\\n  --design \u002Fpath\u002Fto\u002Fworld-design.json \\\n  --map \u002Fpath\u002Fto\u002Fmap.png \\\n  --chars-dir \u002Fpath\u002Fto\u002Fcharacter-pngs \\\n  --prompt \"original user prompt\"\n```\n\n## 是否需要 API Key\n\n使用推荐的 Codex Asset Mode 时，不需要配置 OpenRouter 或第三方图片模型 API key。\n\nCodex Asset Mode 使用：\n\n- Codex 自己生成世界设定\n- Codex 内置图片生成能力生成地图和角色图\n- 本地脚本处理图片、sprite sheet 和 WorldX 世界目录\n\n不过，如果你想在 WorldX 里点击“开始运行”，让角色持续自动决策、对话和产生记忆，WorldX runtime 仍可能需要一个文本模型配置：\n\n```env\nSIMULATION_BASE_URL=\nSIMULATION_API_KEY=\nSIMULATION_MODEL=\n```\n\n这些运行时模型设置可以直接在 WorldX 页面右上角的“模型设置”里填写并保存。保存后再点击“开始运行”，角色会使用新的模型配置，不需要手动编辑 `.env`。\n\n如果你使用 WorldX 原始的 legacy provider pipeline，也就是直接调用：\n\n```bash\nnode \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\u002Fscripts\u002Fworldx.mjs\" create \"...\"\n```\n\n则需要配置：\n\n```env\nORCHESTRATOR_BASE_URL=\nORCHESTRATOR_API_KEY=\nORCHESTRATOR_MODEL=\n\nIMAGE_GEN_PROVIDER=\nIMAGE_GEN_BASE_URL=\nIMAGE_GEN_API_KEY=\nIMAGE_GEN_MODEL=\n\nVISION_BASE_URL=\nVISION_API_KEY=\nVISION_MODEL=\n```\n\n一般用户建议始终使用 Codex Asset Mode。\n\n## 目录结构\n\n```text\nworldx-agent-forge\u002F\n├── README.md\n├── SKILL.md\n├── agents\u002F\n│   └── openai.yaml\n├── assets\u002F\n│   └── worldx-runtime\u002F       # 内置 WorldX 开源运行时\n├── docs\u002F\n│   └── images\u002F               # README 示例截图\n├── references\u002F\n│   └── worldx.md\n└── scripts\u002F\n    ├── assemble_codex_world.mjs\n    ├── prepare_codex_assets.py\n    ├── self_test.mjs\n    └── worldx.mjs\n```\n\n## 更新\n\n进入 skill 目录后拉取最新版本：\n\n```bash\ncd \"${CODEX_HOME:-$HOME\u002F.codex}\u002Fskills\u002Fworldx-agent-forge\"\ngit pull\n```\n\n如果 Codex 已经打开，更新后建议重启 Codex。\n\n## English Summary\n\nWorldX Agent Forge is a self-contained Codex skill that turns a natural-language prompt into a runnable local WorldX simulation world.\n\nIt bundles and adapts the open-source [YGYOOO\u002FWorldX](https:\u002F\u002Fgithub.com\u002FYGYOOO\u002FWorldX) runtime under `assets\u002Fworldx-runtime\u002F`, then adds a Codex-first asset generation and assembly workflow around it.\n\nRecommended usage:\n\n```text\nUse $worldx-agent-forge to generate a fantasy ship daily-life simulation game.\nUse Codex Asset Mode.\n```\n\nCodex Asset Mode does not require OpenRouter or third-party image-generation API keys. Runtime character simulation may still require `SIMULATION_*` model settings if you want characters to continuously act and talk after the world is loaded.\n","WorldX Agent Forge 是一个自包含的 Codex Skill，允许用户通过一句话描述生成一个互动模拟游戏世界。项目核心功能包括使用 Codex 生成世界设定、地图和角色图片，并将这些素材装配成可在本地运行的 WorldX 世界。技术特点在于集成了 WorldX 的前端查看器、后端模拟服务以及角色状态与事件系统等，并提供了一套完整的从生成到装配再到启动的自动化流程。适合需要快速创建个性化互动模拟场景的开发者或游戏设计师使用。",2,"2026-06-11 04:07:35","CREATED_QUERY"]