1块钱买不了上当！

哥们，你要是有codex且是gpt会员话，可以直接让codex改我源码做适配2.4的版本，你不用会，全程自然语言和他沟通就行，因为我一开始做这个就肯定是用新不用旧的想法

gpt自己生图，花的是你gpt账号上的token，其他各种agent生出的图，都是用ai生图的，他们可能还会走中间赚你钱，没必要，自己冲个gpt会员就行。当然了，目前最强的模型我觉得是claude，但是Claude会封中国的帐号，目前没有什么好的解决方法，太严格了，我已经被封了3个号了，所以GPT是次选最好的模型了

好吧 我以为接的还有免费的生图模型 哈哈哈哈

哈哈，免费模型生的图也不能看啊

如果有空的话，我会做一下，最近要忙个人的事了，其实挺麻烦的，我做出来还要测试，等我个人事务忙完我做下老版本的看看，但是我说实话，现在ai太发达了，基本上像这种小插件直接无脑和codex说，让codex改就行了，自用不需要考虑那么多的。

有兄弟私信我说第一次发布写的太潦草了，我这边把上传商城审核的文案拿过来了，应该更详细点，然后也添加了联系方式，主要是QQ群吧，有兄弟使用遇到问题的可以加群反馈下，我有空修下，主要也是看看实际让别人用会出什么问题，虽然我用了一台新电脑从下载到安装再到使用都测试过了，但确实也不能保证其他人就能用。

然后已经上架cocos商店啦，1元钱，友友们可以从github下载先用，确实帮助你解决问题了，可以回商店购买支持一下，哈哈。顺便提一嘴，因为我个人不是太懂3D游戏开发，或许这个插件也能做3D游戏，我没试过，友友们可以试一试。

Cocos AI Copilot

一款深度融入 Cocos Creator 工作流的 AI 游戏开发助手 —— 不只回答代码问题，还能读取场景、操作节点、处理游戏资源、检查运行结果，并通过 Preview 帮你验证实际效果。

Cocos AI Copilot 将 Codex 的 Agent 能力、Cocos 编辑器工具、游戏资源工作流与项目运行验证整合到同一个扩展中。

你可以直接描述想完成的游戏功能，Copilot 会结合当前项目的 Scene、Hierarchy、资源和脚本状态制定步骤，在获得授权后执行操作，并把修改记录、资源产物、运行结果和错误信息统一展示在会话中。

功能特性

• 真正理解当前 Cocos 项目
  不只是根据聊天内容猜测项目结构。Copilot 可以通过 Cocos Runtime 查询当前场景、节点层级、组件、资源和运行状态，减少手动复制代码、节点名称和报错信息。

• 直接操作场景与节点
  支持查询 Scene 和 Hierarchy、读取节点详情、创建或修改节点、调整组件属性，并在操作后重新读取结果，确认编辑器中的实际状态。

• 面向任务的 Agent 工作流
  你可以提出“制作一个可运行的 2D 小游戏”“为角色加入音效”“调整界面布局”等目标。Copilot 会拆解任务、调用对应工具、检查执行结果，并在遇到异常时给出恢复方案。

• 游戏资源完整交付
  支持图片裁剪、切片、透明边处理、尺寸调整、格式检查与导入；支持音频处理、资源导入、AudioClip 确认和运行绑定。资源不只写入磁盘，还会继续检查 Cocos AssetDB 是否正确识别。

• 图片与音频聊天卡片
  处理完成的图片、截图和音频可以作为会话产物展示。你可以直接查看图片、试听音频并确认资源是否符合预期。

• Preview 运行验证
  支持启动和检查项目预览、读取运行错误、截图、发送输入并观察画面变化。验证目标是确认核心功能、交互和运行状态，不会为了“自动通关游戏”无限重复尝试。

• 修改记录与 Review
  会话中的文件和资源修改会形成可查看的变更记录。Copilot 会区分只读检查、文件修改和资源操作，帮助你确认 Agent 实际改动了什么。

• 任务排队与中途调整
  在任务执行过程中可以补充要求或调整方向。新消息会与当前任务状态关联，减少重复创建会话和重新解释上下文。

• 失败恢复与准确状态
  区分单次尝试失败、自动恢复成功和最终失败。中间某一步出错但后续已经修复时，不会简单把整个任务标记成失败。

• 可扩展 MCP 服务
  除内置 Cocos 能力外，还可以配置其他 MCP 服务。对于需要目标应用的服务，可分别设置脚本运行环境、MCP 服务入口和目标应用程序。

• 自动识别其他 Cocos MCP
  可以发现当前 Cocos 编辑器扩展中已经配置、并提供 Cocos 操作工具的 MCP 服务，在“其他 Cocos MCP”区域展示其连接状态和工具数量。

• 四套内置工作方法
  内置 Cocos MCP 工作流、Cocos UI 组合、2D 图片工具和 Preview 调试方法，帮助 Agent 按照更稳定的步骤执行任务，而不是无边界地反复尝试。

主要能力支持情况

说明：

• 图片本地工具主要负责处理、导入和交付已有图片内容，不代表扩展自身内置图片生成模型。
• FamiStudio 等第三方程序不包含在本扩展中，需要用户自行安装并按照对应 MCP 服务说明配置。
• 模型能力、账号权限和使用额度由用户本机安装的 Codex 及其登录账号决定。
• 工具数量可能随扩展升级而调整，以实际版本中的“Copilot 内置能力”页面为准。

使用说明

1. 安装扩展

在 Cocos Creator 扩展管理器中安装并启用 cocos-ai-copilot。

安装后建议重新加载扩展或重启一次 Cocos Creator，确保主进程、面板和 Runtime 完整启动。

2. 准备 Codex

请先在电脑上安装受支持版本的 Codex，并完成登录。

当前版本要求：

• Codex 0.160.1 或更高稳定版本。
• 扩展不会把 Codex 程序打包进插件。
• Copilot 会自动查找用户电脑中已经安装的 Codex。
• 如果自动查找失败，可以在设置中手动选择 Codex 程序位置。

3. 打开 Copilot

通过 Cocos Creator 顶部菜单打开 Cocos AI Copilot 面板。

首次启动时，扩展会依次检查：

• Cocos Runtime 是否正常；
• Codex 是否已经发现；
• app-server 是否能够启动；
• Cocos MCP 工具是否完成连接；
• 内置 Skills 是否准备完毕。

可以前往：

设置 → Runtime → 检查运行状态

查看实际使用的 Codex 版本和当前连接状态。

4. 配置模型服务

在“设置 → 模型服务”中选择或填写所需的模型服务配置。

模型是否可用、可使用哪些模型以及账户额度，由用户自己的 Codex 环境和账号决定。

5. 开始任务

你可以直接描述目标，例如：

• 读取当前场景并说明节点结构；
• 创建一个带按钮和计分显示的游戏界面；
• 为角色添加移动、跳跃和碰撞逻辑；
• 把图片处理成适合 Cocos 使用的资源；
• 导入一段音频并绑定到指定节点；
• 启动 Preview，检查游戏能否运行；
• 根据运行错误定位可能的问题。

建议在任务中同时说明：

• 想实现的玩法；
• 允许修改的场景或目录；
• 是否允许创建脚本和资源；
• 期望的画面或交互效果；
• 验收标准。

6. 查看执行过程

任务执行过程中，面板会显示：

• Agent 当前判断和计划；
• Cocos 工具调用；
• 文件与资源修改；
• 图片、音频和截图产物；
• Preview 验证结果；
• 中间失败、恢复状态和最终结果。

不要仅根据“工具已经调用”判断任务完成，建议同时查看最终场景、资源、Preview 和 Review 结果。

外部 MCP 服务配置

Cocos AI Copilot 支持配置额外的 MCP 服务。

对于本地 JavaScript MCP，常见配置包括：

• 名称：服务在 Copilot 中显示的名称。
• MCP 服务入口：例如服务提供的 index.js 文件。
• 脚本运行程序：用于运行 JavaScript 服务的 Node.js。扩展会优先自动查找，必要时可手动选择。
• 目标应用程序：MCP 需要操作的本地软件，例如 FamiStudio.exe。
• 工作目录：MCP 服务启动时使用的目录。
• 高级运行环境：环境变量和系统变量继承设置，普通用户通常不需要修改。

以 FamiStudio MCP 为例：

• MCP 服务入口选择服务提供方的 index.js；
• 目标应用程序选择本机的 FamiStudio.exe；
• Node.js 优先使用自动发现；
• 如果服务要求通过环境变量接收目标程序路径，Copilot 会根据该服务的配置进行传递。

不同 MCP 的启动方式可能不同，请以服务提供方的安装说明为准。

内置能力页面

“设置 → Cocos MCP”分为两个区域。

Copilot 内置能力

展示当前项目可用的：

• Cocos Runtime Tools；
• 图片 Local Tools；
• 音频 Local Tools；
• Built-in Skills。

这里显示的是扩展已经准备好的能力清单。

其他 Cocos MCP

自动识别当前 Cocos 编辑器扩展中已配置、并提供 Cocos 操作能力的 MCP 服务。

该区域只负责识别和展示，不会擅自修改或删除其他扩展。用户不再需要某个服务时，应在对应扩展中关闭或卸载。

权限与安全

Cocos AI Copilot 会根据操作类型请求相应权限。

• 查询场景和资源通常属于只读操作。
• 修改脚本、场景或资源时，需要相应的写入权限。
• 高风险操作不会因为模型提出建议就自动视为安全。
• Review 和撤销能力取决于具体变更类型、文件当前状态和可用证据。
• 如果文件在 Agent 修改后又被用户或其他程序改动，系统不会强行覆盖最新内容。
• 第三方 MCP 的行为和权限由对应服务实现，请只连接可信来源提供的服务。

建议在重要项目中继续使用 Git 或其他版本管理工具，并在执行较大任务前保存项目。

引擎与环境要求

• Cocos Creator 3.8.8。
• Windows x64。
• 本机已经安装并登录 Codex。
• Codex 0.160.1 或更高稳定版本。
• Node.js 环境（最好使用最新版）。
• 使用外部 MCP 时，需要安装对应程序和运行环境。

当前发布版本已在 Windows x64 与 Cocos Creator 3.8.8 环境完成验证。

未明确列出的操作系统、Creator 大版本和预发布版 Codex，不代表一定不可使用，但不属于当前正式验收范围。

适用场景

• 使用 Cocos Creator 制作 2D 游戏原型；
• 快速了解陌生项目的场景和节点结构；
• 批量完成重复的节点与资源操作；
• 辅助创建和修改 TypeScript 游戏脚本；
• 处理并导入图片、音频等游戏资源；
• 通过 Preview 检查玩法、画面和运行错误；
• 将已有 MCP 服务接入 Cocos 开发流程；
• 学习 Cocos 场景、资源与脚本之间的关系。

更新日志

0.1.0

• 发布单扩展版本 cocos-ai-copilot。
• 集成 Cocos Runtime、Codex app-server 接入和 MCP 工具调用。
• 内置 Cocos MCP、图片工具、音频工具及四套 Skills。
• 支持 Scene、Hierarchy、Node、资源、脚本和 Preview 工作流。
• 支持图片、音频与截图产物进入聊天卡片。
• 支持外部 MCP 服务配置和其他 Cocos MCP 自动识别。
• 支持 Codex 自动发现与手动程序位置兜底。
• 修复本机系统代理影响 Cocos MCP 握手的问题。
• 优化 WebSocket 不可用时的快速 HTTP 回退。
• 优化首次资源导入、AssetDB 就绪等待和音频状态反馈。
• 区分中间尝试失败、恢复成功与最终失败。
• 优化 Preview 自动验证预算，取消“必须自动完整通关”的发布条件。
• 完成 Windows 新电脑、全新项目和真实发布包验证。

常见问题 FAQ

Copilot 面板打不开怎么办？

确认扩展目录完整，并重新加载扩展或重启 Cocos Creator。

如果控制台出现主模块缺失，请先删除不完整的旧安装目录，再重新解压或安装完整发布包，不要直接覆盖残留文件。

Runtime 显示未运行怎么办？

前往“设置 → Runtime”点击“检查运行状态”。

确认：

• Codex 已安装并登录；
• Codex 版本符合要求；
• 没有安全软件阻止子进程启动；
• 扩展目录文件完整；
• 当前 Cocos 项目具备读写权限。

设置页显示工具数量正常，但新会话无法调用 Cocos 工具怎么办？

工具清单存在不代表当前会话的 MCP 握手一定成功。

请检查 Runtime 状态，并重新启动 Copilot。扩展已经针对本机代理导致的 127.0.0.1 连接失败进行了处理；如果问题仍然存在，请保留运行状态和错误日志用于排查。

为什么第一次请求比后续请求慢？

首次请求可能需要启动 Codex app-server、建立模型连接、加载 MCP 工具和初始化会话。

后续请求通常会复用已经准备好的运行环境。如果首次请求长时间没有响应，请检查网络、模型服务与代理环境。

为什么图片或音频文件已经存在，仍然显示等待确认？

文件写入磁盘、Cocos AssetDB 识别、生成正确资源类型以及 Runtime 实际可用，是不同状态。

Copilot 会继续等待编辑器确认；如果超过合理时间，会保留已经生成的文件并提示人工检查，不会无限重试。

为什么中间出现失败，但最终任务仍然成功？

Agent 可能在第一次尝试失败后调整参数或切换可用方法。

Copilot 会区分：

• 单次尝试失败；
• 已恢复；
• 最终失败。

详情中会保留诊断证据，最终状态则以任务目标是否完成为准。

为什么 Preview 没有自动通关游戏？

Copilot 是游戏开发助手，不是自动通关机器人。

Preview 验证主要检查：

• 游戏能否启动；
• 关键输入是否有效；
• 画面是否发生预期变化；
• 是否存在关键运行错误；
• 核心玩法是否具备人工验收条件。

完整通关应根据游戏类型和用户要求决定，不是所有任务的必要条件。

外部 MCP 为什么显示“可用”而不是“已连接”？

部分 stdio MCP 只在实际调用时启动，不会长期保持常驻进程。

“可用”表示配置和工具可以使用；只有已经完成实时连接的服务才会显示“已连接”。

可以在 macOS 上使用吗？

当前正式验收环境为 Windows x64 与 Cocos Creator 3.8.8。

其他系统不在当前正式支持范围内，请不要仅根据能够安装判断全部功能已经兼容。

使用与购买须知

• 本扩展提供游戏开发辅助能力，不保证模型生成内容天然正确。
• 场景、脚本和资源修改应由用户结合 Review、Preview 和版本管理进行确认。
• Codex、模型服务、第三方 MCP、FamiStudio 等外部软件或服务不包含在本扩展内。
• 外部软件的安装、账号、授权、网络和使用费用由对应提供方决定。
• 实际可使用的模型和额度取决于用户自己的 Codex 环境与账号。
• 使用第三方 MCP 前，请确认服务来源可信，并阅读其权限和使用说明。
• 请在购买或安装前确认 Cocos Creator、操作系统和 Codex 版本符合要求。
• 如商城对虚拟商品退款、授权或售后另有统一规则，应以商城正式规则为准。

联系我们

如遇到安装、连接、项目兼容或功能使用问题，请在反馈时尽量提供：

• Cocos Creator 版本；
• Windows 版本；
• Codex 版本；
• 扩展版本；
• Runtime 状态页面截图；
• 错误日志；
• 可以稳定复现问题的操作步骤。

联系方式：

• 邮箱：923480732@qq.com
• QQ群：1071896462
• Cocos 论坛：https://forum.cocos.org/t/topic/177666/20

关键词

Cocos Creator 插件、Cocos AI、AI 游戏开发、AI Coding、Codex、Agent、MCP、游戏开发助手、场景编辑、节点操作、Hierarchy、资源导入、AssetDB、图片处理、音频处理、Preview、游戏调试、代码生成、开发者工具、编辑器扩展

感谢用户的内容

感谢你选择并使用 Cocos AI Copilot。

开发者工具真正的价值，不是替用户完成几个孤立动作，而是让需求、修改、资源、运行和验证形成一条清楚、可检查的工作流。

如果你在真实项目中遇到兼容问题、状态表达不清、工具调用失败，或者对新的 Cocos 工作流有想法，欢迎通过上方联系方式反馈。每一个能够稳定复现的问题，都会帮助我们把 Copilot 打磨得更可靠、更易用。

兄弟 你这个不能用第三方聚合网站API啊…

群号好像不对

不好意思，群刚建，默认不可搜索，我刚开下来了

嗯，没考虑那么多，因为我不喜欢用中转站，中转站太坑了，各种套路，说是支持最新模型，说不定后台给你接的是低端模型，因为从我个人角度来讲，GPT会员是最直接的，Claude因为我总是被封号，也没做，国内LLM也只有deepseek稍微能看点，所以就没做中转站API

我现在让codex跑一下，加个这个功能吧，更新了和你说

兄弟更新了，可以先去github上下载新版试试看，我也更新了帖子

商店里我支持你了 ,兄弟 真厉害

大佬，现在都用ChatGPT了，啥时候支持啊

？一直支持啊，我都更到v0.1.7喽

一般情况下不需要你操作，保证电脑上是最新版gpt客户端就行，能自动连接

npm install -g @openai/codex
这个安装后重新打开就好了
估计gpt桌面版他找不到