接入 AGC 内置插件宿主并补齐 Cocos 编辑器能力 (#338)
Project CI / Repository checks (push) Successful in 2m45s
Project CI / Frontend tests (push) Successful in 3m27s
Project CI / Backend tests (push) Successful in 6m18s
Project CI / Native shell tests (push) Failing after 13m52s

客户端新增随包提供的插件宿主和 Cocos Creator 集成:识别并导入 Cocos 项目,通过内置桥接操作已打开的编辑器,无需安装项目 MCP 扩展。DirectProject 现在公开 36 个独立 cocos_* 工具,保留通用 JavaScript 执行入口。

- 通用插件 SDK、命令/能力/面板注册、编辑器适配器和跨进程内置插件开关。
- Cocos 场景、节点、组件、Prefab、UI、Layout/Widget、资源、保存、撤销、日志与预览调试;目录和实现由 JS/native 共用。
- 编辑事务回读、失败回滚、后续手动修改保护及不确定结果禁止重放;预览截图通过 MCP image 返回。
- DirectProject 跳过无关专业 Agent 历史,将项目打开和历史读取中的同步 I/O 移出窗口线程,消除 Cocos 执行与项目文件锁的错误耦合。

验证:
- 合并 master 后:类型/配置检查、编码检查、Rust 格式检查和提交钩子通过。
- 合并 master 后:Cocos 项目打开、插件面板和开发启动定向测试 10 通过、2 跳过;DirectProject MCP 测试 17 通过、1 项真实 Creator opt-in 忽略;插件宿主测试 9/9。
- 插件行为测试 17/17;native 测试 20/20,4 项 opt-in 测试默认忽略。
- 真实 Creator 3.8.8 的 36/36 操作 smoke,以及客户端 MCP tools/list、tools/call、UI/撤销和预览截图,在功能实现阶段已验证通过;本次 master 合并后未重复真实 GUI smoke。

验证边界:发行安装包和远端 CI 尚未验收。

Reviewed-on: #338
Co-authored-by: kdletters <kdletters@qq.com>
Co-committed-by: kdletters <kdletters@qq.com>
This commit was merged in pull request #338.
This commit is contained in:
2026-09-13 14:48:55 +08:00
committed by 段舒康
parent b12a81e9c2
commit 4a46f89c9b
117 changed files with 15158 additions and 320 deletions
+5
View File
@@ -12,7 +12,9 @@ export const REQUIRED_WORKSPACES = Object.freeze([
'apps/preview-deployer-web',
'packages/image-canvas-core',
'packages/image-canvas-react',
'packages/agc-plugin-sdk',
'packages/shared',
'plugins/agc-cocos-editor',
'tools/spine-json-export-validator',
]);
@@ -24,7 +26,9 @@ const WORKSPACE_NAMES = Object.freeze({
'apps/preview-deployer-web': '@genarrative/preview-deployer-web',
'packages/image-canvas-core': '@genarrative/image-canvas-core',
'packages/image-canvas-react': '@genarrative/image-canvas-react',
'packages/agc-plugin-sdk': '@genarrative/agc-plugin-sdk',
'packages/shared': '@genarrative/shared',
'plugins/agc-cocos-editor': '@genarrative/agc-plugin-cocos-editor',
'tools/spine-json-export-validator':
'@genarrative/spine-json-export-validator',
});
@@ -45,6 +49,7 @@ const REQUIRED_LOCAL_DEPENDENCIES = Object.freeze({
'packages/image-canvas-react/package.json': [
'@genarrative/image-canvas-core',
],
'plugins/agc-cocos-editor/package.json': ['@genarrative/agc-plugin-sdk'],
});
const DEPENDENCY_FIELDS = Object.freeze([
+3
View File
@@ -20,7 +20,9 @@ const workspaceNames = {
'apps/preview-deployer-web': '@genarrative/preview-deployer-web',
'packages/image-canvas-core': '@genarrative/image-canvas-core',
'packages/image-canvas-react': '@genarrative/image-canvas-react',
'packages/agc-plugin-sdk': '@genarrative/agc-plugin-sdk',
'packages/shared': '@genarrative/shared',
'plugins/agc-cocos-editor': '@genarrative/agc-plugin-cocos-editor',
'tools/spine-json-export-validator':
'@genarrative/spine-json-export-validator',
};
@@ -34,6 +36,7 @@ const localDependencies = {
},
'apps/mobile-shell': { '@genarrative/shared': '0.1.0' },
'packages/image-canvas-react': { '@genarrative/image-canvas-core': '0.1.0' },
'plugins/agc-cocos-editor': { '@genarrative/agc-plugin-sdk': '0.1.0' },
};
afterEach(() => {
+6
View File
@@ -1777,6 +1777,7 @@ class DevRunner {
env,
stdio: ['ignore', 'pipe', 'pipe'],
shell: process.platform === 'win32',
windowsHide: process.platform === 'win32',
},
);
@@ -2096,6 +2097,7 @@ class DevRunner {
env: mergedEnv,
stdio: ['ignore', 'pipe', 'pipe'],
shell: process.platform === 'win32',
windowsHide: process.platform === 'win32',
},
);
@@ -2171,6 +2173,7 @@ class DevRunner {
env: mergedEnv,
stdio: ['ignore', 'pipe', 'pipe'],
shell: process.platform === 'win32',
windowsHide: process.platform === 'win32',
},
);
@@ -2259,6 +2262,7 @@ class DevRunner {
env,
...createDevServerSpawnOptions(),
shell: process.platform === 'win32',
windowsHide: process.platform === 'win32',
},
);
@@ -2303,6 +2307,7 @@ class DevRunner {
env,
...createDevServerSpawnOptions(),
shell: process.platform === 'win32',
windowsHide: process.platform === 'win32',
},
);
@@ -3260,6 +3265,7 @@ function runForeground(command, args, { cwd, env, label }) {
env,
stdio: ['inherit', 'pipe', 'pipe'],
shell: process.platform === 'win32',
windowsHide: process.platform === 'win32',
});
child.stdout?.on('data', (chunk) => capture(chunk, process.stdout));