像 Unity 一样，检查和修改正在运行的 Cocos2d-x 游戏。

CocosEditor 将 Game、Assets、Hierarchy、Inspector 和 Logs 集成在同一个工作区中。
它通过 Runtime Editor SDK 连接真实的游戏进程，让场景定位、节点检查和属性调整
直接发生在游戏运行时，而不是停留在一份离线的场景副本中。

下载最新版 ·
查看全部版本 ·
反馈问题

如果 Releases 页面暂无可下载文件，表示当前还没有公开发布的稳定版本。

CocosEditor 主工作区：在 Game 中观察和选择节点，在 Hierarchy 中定位运行时场景
层级，在 Inspector 中查看与修改属性，通过 Assets 浏览项目资源，并在 Logs 中跟踪
编辑器与游戏运行时输出。

核心能力

熟悉的 Unity 式工作区

• Game：显示正在运行的游戏画面，并支持从画面中选择节点。
• Hierarchy：展示游戏进程中当前场景的实际节点树。
• Inspector：查看所选节点的组件和属性，并编辑受支持的属性。
• Assets：集中浏览和查找项目资源。
• Logs：集中查看编辑器与游戏运行时日志，支持按通道和等级筛选、搜索、暂停显示
  以及自动滚动，便于将画面、节点状态和运行信息放在一起排查。

这些面板共享同一份选择状态。在 Game 或 Hierarchy 中定位节点后，可以立即在
Inspector 中检查它，并通过 Logs 对照运行时反馈，而不必在游戏窗口、外部日志、
代码和资源目录之间反复切换。

修改的是正在运行的游戏

通过 Runtime Editor SDK 连接游戏后，Hierarchy 展示的是游戏进程中正在运行的节点，
Inspector 的修改也会直接反映到 Game 画面中。位置、缩放、可见性、颜色、文字等
已接入属性可以在运行时检查和调整。

连接游戏 → 选择节点 → 检查属性 → 修改数值 → Game 实时反馈

让项目工具成为编辑器的一部分

Extension SDK 支持使用 C# 开发编辑器扩展。项目可以将自己的菜单、窗口、资源工具
和工作流程集成到 CocosEditor 中，而不必为每个内部工具单独维护一套桌面程序。

图中工具由 C# Extension SDK 开发，并作为扩展窗口直接运行在 CocosEditor 工作区中。

让 AI 通过 MCP 使用编辑器能力

CocosEditor 内置 MCP Server，可连接支持 MCP 的 AI 客户端。AI 不只能够回答代码问题，
还可以通过编辑器提供的工具查询运行时场景、定位节点、检查属性，并执行受支持的
编辑与自动化操作。

AI 客户端 → MCP Server → CocosEditor → 游戏运行时

客户端配置、工具分类、参数、安全约束和常用调用流程请参阅
MCP 接口文档。

安装 CocosEditor

系统要求

• Windows 10 1809（Build 17763）或更高版本
• x64 操作系统
• .NET 10 Desktop Runtime x64

安装步骤

1. 从 Releases 下载
   CocosEditor-<version>-win-x64.zip。
2. 将压缩包完整解压到独立且可写的目录，例如 D:\Tools\CocosEditor。
3. 运行 Cocos2dxEditor.exe。

请勿直接在压缩包中运行，也不要用新版本手动覆盖正在运行的旧版本。

下载哪个文件？

普通用户只需下载编辑器安装包。SDK 文件仅供扩展或运行时接入开发使用。

文件	用途
CocosEditor-<version>-win-x64.zip	CocosEditor 完整安装包
CocosEditor-ExtensionSdk-<version>.zip	开发 C# 编辑器扩展
runtime-editor-sdk-<version>-windows-x86.zip	将 Cocos2d-x 3.9 Win32 游戏接入 Runtime Editor
checksums.sha256	手动核对下载文件的 SHA-256
update-manifest.json / .sig	编辑器自动更新使用的清单和数字签名

GitHub 自动生成的 Source code (zip) 和 Source code (tar.gz) 只包含本仓库的
公开文件，不包含 CocosEditor 源代码，也不是编辑器安装包。

自动更新与文件校验

CocosEditor 可以在程序内检查并安装同架构的新版本。更新前会验证签名、文件大小、
SHA-256 和包内文件清单；验证失败的更新包不会被安装。

如需手动核对下载文件，可在 PowerShell 中运行：

Get-FileHash .\CocosEditor-<version>-win-x64.zip -Algorithm SHA256

请将结果与同一 Release 中的 checksums.sha256 对照。手动核对哈希只能确认下载
文件是否一致，不能替代编辑器执行的数字签名验证。

开发者 SDK

SDK 与 CocosEditor 一同发布，并使用相同的版本号。为避免公共 API、协议或运行时
依赖不兼容，请优先使用与编辑器版本完全一致的 SDK。

Extension SDK

CocosEditor-ExtensionSdk-<version>.zip 用于开发编辑器侧 C# 扩展，目标框架为
.NET 10，程序集架构为 AnyCPU。包内提供公共程序集、开发文档和最小示例。

Runtime Editor SDK

runtime-editor-sdk-<version>-windows-x86.zip 用于接入 Cocos2d-x 3.9 Win32 游戏，
包含公共 C/C++ 头文件、Debug/Release 库、MSBuild 配置、接入文档和示例。

文件名中的 x86 指目标游戏进程的架构。x64 编辑器可以通过进程间通信连接 Win32
游戏，不会把 x86 原生 DLL 加载到编辑器进程中。

接入前请阅读：

• Runtime Editor SDK 接入指南
• 供 Agent 使用的接入 Skill

如果希望 Agent 代为接入，可把目标项目目录和 SDK ZIP（或解压目录）告诉 Agent，
并让它读取当前页面链接的 Skill。Skill 会要求 Agent 先核对版本、Win32 架构、实际
.vcxproj 和生命周期调用链；默认只做静态验证，不会自行编译、运行或提交代码。

问题反馈

如遇到安装、启动、更新或 SDK 兼容问题，请提交
Issue，并尽量附上：

• CocosEditor 版本
• Windows 版本
• 错误信息或日志
• 可复现步骤

许可说明

本仓库是 CocosEditor 的发布仓库，不是开源源码仓库。软件及 SDK 的使用以对应版本
附带的许可条款或最终用户许可协议为准。