有兄弟私信我说第一次发布写的太潦草了，我这边把上传商城审核的文案拿过来了，应该更详细点，然后也添加了联系方式，主要是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 按照更稳定的步骤执行任务，而不是无边界地反复尝试。
主要能力支持情况
| 模块 |
主要能力 |
使用条件 |
| Cocos Runtime |
Scene、Hierarchy、Node、组件、资源和编辑器操作 |
安装扩展后由项目自动启动 |
| 场景操作 |
查询场景、创建节点、调整属性、检查结果 |
当前项目已正常打开 |
| 图片工作流 |
裁剪、切片、透明边处理、缩放、格式验证、资源导入 |
使用内置本地图片工具 |
| 音频工作流 |
音频检查、处理、导入、AudioClip 确认与绑定 |
使用内置本地音频工具 |
| Preview 验证 |
启动预览、截图、输入验证、错误检查 |
项目可以正常预览运行 |
| Review |
查看文件和资源变更、确认任务结果 |
根据当前任务实际变更生成 |
| 外部 MCP |
接入 FamiStudio 等第三方或自定义服务 |
需要用户提供相应程序或服务 |
| Codex Agent |
模型对话、任务规划、工具调用和会话管理 |
电脑已安装并登录兼容版本的 Codex |
说明：
- 图片本地工具主要负责处理、导入和交付已有图片内容，不代表扩展自身内置图片生成模型。
- 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 状态页面截图；
- 错误日志；
- 可以稳定复现问题的操作步骤。
联系方式：
关键词
Cocos Creator 插件、Cocos AI、AI 游戏开发、AI Coding、Codex、Agent、MCP、游戏开发助手、场景编辑、节点操作、Hierarchy、资源导入、AssetDB、图片处理、音频处理、Preview、游戏调试、代码生成、开发者工具、编辑器扩展
感谢用户的内容
感谢你选择并使用 Cocos AI Copilot。
开发者工具真正的价值，不是替用户完成几个孤立动作，而是让需求、修改、资源、运行和验证形成一条清楚、可检查的工作流。
如果你在真实项目中遇到兼容问题、状态表达不清、工具调用失败，或者对新的 Cocos 工作流有想法，欢迎通过上方联系方式反馈。每一个能够稳定复现的问题，都会帮助我们把 Copilot 打磨得更可靠、更易用。
）
）
。当然，你免费人家也不能说啥。我卖这个价当然有我的道理，就测试这块，我的插件目前支持3.7以上的版本，我就一定会掐头去尾多个版本做Windows、macos双系统冒烟测试。质量这块我是能保证的，产出质量方面至少比内测版本Pink强了。还是那句话，各取所需，你不需要请不要诋毁别人。我说的每一句都是实话。软件做的不是一锤子买卖，做的是服务。没有服务是免费的，免费的往往是最贵的。我就说这么多。 
