联系作者：VX Unity3D_Developer ## 功能介绍 Cocos Agent Bridge 是一款面向 Cocos Creator 2.4.11 的本地编辑器扩展。安装后，它会在编辑器内启动一个仅监听 `127.0.0.1` 的本地 HTTP 服务，让外部 AI Agent、脚本工具或自动化流程可以用结构化命令操作当前打开的场景。它解决的核心问题是：AI 辅助开发时，传统屏幕识别和鼠标点击容易受分辨率、面板布局、语言环境影响；而通过本插件，Agent 可以直接调用编辑器扩展接口，在场景进程中完成节点、组件和资源相关操作，流程更稳定，也更适合批量生成 UI、搭建原型和快速验证页面布局。主要功能包括： - 场景读取：查看当前场景结构，支持读取完整节点树、节点路径、UUID、坐标、尺寸、缩放、旋转、锚点、组件列表等信息。 - 节点管理：创建节点、修改节点基础属性、删除节点、按路径/UUID/名称定位节点。 - 组件操作：为节点添加组件，或修改已有组件属性，支持 Cocos 内置组件类名与已注册类名。 - UI 快速生成：通过命令创建矩形、文本、按钮、输入框等常用 UI 节点，适合快速搭建登录页、设置面板、弹窗和原型界面。 - 精灵创建：查询资源后，可按 SpriteFrame UUID 创建 `cc.Sprite` 节点并绑定资源。 - 资源查询与导入：支持查询项目资源、查找指定资源、确保资源目录存在、导入本地文件、创建文本或 Base64 资源文件。 - 场景保存：命令完成后可请求 Cocos Creator 保存当前场景。 - 本地接口：默认服务地址为 `http://127.0.0.1:32117`，可通过 `COCOS_AGENT_BRIDGE_PORT` 修改端口。安装注意事项： - 当前版本面向 Cocos Creator 2.4.11 开发，建议在 Creator 2.4.x 项目中使用。 - 使用前请先在 Cocos Creator 中打开目标项目和目标场景。 - 插件必须放入项目的 `packages/agent-bridge` 目录，目录内需包含 `package.json`、`main.js`、`scene-walker.js` 等文件。 - 本插件不占用 Cocos Creator 主菜单；加载扩展后会自动启动本地桥接服务。 - 本地服务只监听 `127.0.0.1`，用于本机自动化流程，不建议暴露到公网或局域网。 - 执行创建、删除、属性修改等命令前，建议先备份场景或使用版本管理工具保存当前工程状态。 ## 使用教程 ### 1. 安装插件将下载后的插件目录复制到目标 Cocos Creator 项目的 `packages` 目录下： ```powershell Copy-Item -Recurse -Force <资源解压目录>\packages\agent-bridge <项目目录>\packages\agent-bridge ``` 复制完成后的目录结构示例： ```text <项目目录>/ assets/ packages/ agent-bridge/ package.json main.js scene-walker.js ``` 然后打开 Cocos Creator 2.4.11，进入目标项目，重新加载扩展或重启编辑器。 ### 2. 确认桥接服务已启动在命令行中执行： ```powershell node <资源解压目录>\cli\cocos-agent.js health ``` 如果返回类似以下结果，说明插件已经正常启动： ```json { "ok": true, "port": 32117 } ``` ### 3. 查看当前场景结构确保目标场景已经在 Cocos Creator 中打开，然后执行： ```powershell node <资源解压目录>\cli\cocos-agent.js scene-info --deep ``` 也可以只查看某个节点子树： ```powershell node <资源解压目录>\cli\cocos-agent.js list-nodes --root Canvas --deep ``` ### 4. 创建和修改节点创建一个名为 `Player` 的节点： ```powershell node <资源解压目录>\cli\cocos-agent.js create-node --name Player --parent Canvas --props "{""x"":0,""y"":0,""width"":120,""height"":120}" ``` 修改节点属性： ```powershell node <资源解压目录>\cli\cocos-agent.js set-node --node Canvas/Player --props "{""x"":100,""y"":50,""opacity"":220}" ``` 删除节点： ```powershell node <资源解压目录>\cli\cocos-agent.js delete-node --node Canvas/Player ``` ### 5. 添加和修改组件给节点添加 `cc.Label` 组件： ```powershell node <资源解压目录>\cli\cocos-agent.js add-component --node Canvas/Player --component Label --props "{""string"":""Hello Cocos""}" ``` 修改已有组件属性： ```powershell node <资源解压目录>\cli\cocos-agent.js set-component --node Canvas/Player --component Label --props "{""fontSize"":32,""string"":""Ready""}" ``` ### 6. 快速生成常用 UI 创建矩形背景： ```powershell node <资源解压目录>\cli\cocos-agent.js create-rect --name Panel --parent Canvas --width 480 --height 320 --fill "#1f2937" ``` 创建文本： ```powershell node <资源解压目录>\cli\cocos-agent.js create-label --name Title --text "登录" --parent Canvas/Panel --font-size 32 --color "#ffffff" ``` 创建按钮： ```powershell node <资源解压目录>\cli\cocos-agent.js create-button --name LoginButton --text "开始游戏" --parent Canvas/Panel --width 220 --height 64 --fill "#2f7df6" ``` 创建输入框： ```powershell node <资源解压目录>\cli\cocos-agent.js create-input --name AccountInput --placeholder "请输入账号" --parent Canvas/Panel --width 320 --height 54 ``` ### 7. 查询、导入和使用资源查询项目内的 SpriteFrame： ```powershell node <资源解压目录>\cli\cocos-agent.js query-assets --pattern "db://assets/**/*" --type sprite-frame ``` 查找指定资源： ```powershell node <资源解压目录>\cli\cocos-agent.js find-asset --name player.png --type sprite-frame ``` 导入本地资源到项目： ```powershell node <资源解压目录>\cli\cocos-agent.js import-asset --source <本地资源路径>\player.png --dest-url db://assets/agent-imports ``` 使用 SpriteFrame UUID 创建精灵节点： ```powershell node <资源解压目录>\cli\cocos-agent.js add-sprite --name PlayerIcon --asset-uuid xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --parent Canvas ``` ### 8. 保存场景完成操作后执行： ```powershell node <资源解压目录>\cli\cocos-agent.js save-scene ``` 建议在保存前回到 Cocos Creator 检查场景层级、节点位置和组件属性，确认符合预期后再提交工程变更。 ## 联系作者 - 使用反馈：可在 Cocos Store 当前商品页评论区留言，描述 Cocos Creator 版本、操作命令、报错信息和复现步骤。 - 问题定位建议：反馈时请附上 `health`、`scene-info` 或相关命令返回结果，便于快速判断是插件安装、场景状态、资源路径还是命令参数问题。 ## 更新声明 - 0.1.0 - 支持在 Cocos Creator 2.4.11 中启动本地 JSON/HTTP 桥接服务。 - 支持查看场景节点树、创建节点、修改节点、删除节点。 - 支持添加和修改组件。 - 支持创建矩形、文本、按钮、输入框等常用 UI 节点。 - 支持资源查询、资源查找、资源目录创建、资源导入和资源创建。 - 支持通过 SpriteFrame UUID 创建精灵节点。 - 支持请求保存当前打开的场景。 ## 购买须知本产品为虚拟数字商品，一经购买成功概不退款，请支付前谨慎确认购买内容、适用的 Cocos Creator 版本以及插件功能是否符合项目需求。