kdletters
4a46f89c9b
客户端新增随包提供的插件宿主和 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>
99 lines
2.8 KiB
TypeScript
99 lines
2.8 KiB
TypeScript
import { describe, expect, it, vi } from 'vitest';
|
|
|
|
import {
|
|
createJsonRpcStdioTransport,
|
|
createPluginHost,
|
|
PluginPanelRegistry,
|
|
} from './index';
|
|
|
|
describe('AGC plugin SDK', () => {
|
|
it('routes registrations and project/editor calls through the transport', async () => {
|
|
const request = vi.fn(async <T>(method: string, params?: unknown) => {
|
|
if (method === 'host.project.read')
|
|
return { path: params, content: 'ok' } as T;
|
|
return { registered: true } as T;
|
|
});
|
|
const host = createPluginHost({ request });
|
|
|
|
const disposePanel = await host.registerPanel({
|
|
id: 'panel',
|
|
title: 'Panel',
|
|
entry: 'panel.html',
|
|
});
|
|
expect(host.panels.list()).toHaveLength(1);
|
|
await host.project.read('game/index.html');
|
|
await host.rpc('scene.open', { path: 'Main.scene' });
|
|
disposePanel();
|
|
expect(host.panels.list()).toHaveLength(0);
|
|
|
|
expect(request).toHaveBeenCalledWith('host.registerPanel', {
|
|
id: 'panel',
|
|
title: 'Panel',
|
|
entry: 'panel.html',
|
|
});
|
|
expect(request).toHaveBeenCalledWith('host.project.read', {
|
|
path: 'game/index.html',
|
|
});
|
|
expect(request).toHaveBeenCalledWith('host.rpc', {
|
|
method: 'scene.open',
|
|
params: { path: 'Main.scene' },
|
|
});
|
|
expect(request).toHaveBeenCalledWith('host.unregisterPanel', {
|
|
id: 'panel',
|
|
});
|
|
});
|
|
|
|
it('notifies UI subscribers when panels are mounted or removed', () => {
|
|
const registry = new PluginPanelRegistry();
|
|
const changed = vi.fn();
|
|
registry.subscribe(changed);
|
|
const dispose = registry.register({
|
|
id: 'panel',
|
|
title: 'Panel',
|
|
entry: 'panel.html',
|
|
});
|
|
expect(registry.list()).toHaveLength(1);
|
|
dispose();
|
|
expect(registry.list()).toHaveLength(0);
|
|
expect(changed).toHaveBeenCalledTimes(2);
|
|
});
|
|
|
|
it('keeps bidirectional request ids separate and dispatches handlers', async () => {
|
|
let input: (chunk: string) => void = () => undefined;
|
|
const output: string[] = [];
|
|
const transport = createJsonRpcStdioTransport({
|
|
stdin: {
|
|
on: (_event, listener) => {
|
|
input = listener;
|
|
},
|
|
},
|
|
stdout: {
|
|
write: (chunk) => {
|
|
output.push(chunk);
|
|
},
|
|
},
|
|
});
|
|
transport.registerHandler?.('echo', (params) => params);
|
|
const request = transport.request('host.project.read', { path: 'game.js' });
|
|
input(
|
|
JSON.stringify({
|
|
jsonrpc: '2.0',
|
|
id: 1,
|
|
method: 'echo',
|
|
params: { echo: true },
|
|
}) + '\n',
|
|
);
|
|
await new Promise((resolve) => setTimeout(resolve, 0));
|
|
expect(JSON.parse(output[1] ?? '{}')).toEqual({
|
|
jsonrpc: '2.0',
|
|
id: 1,
|
|
result: { echo: true },
|
|
});
|
|
input(
|
|
JSON.stringify({ jsonrpc: '2.0', id: 1, result: { content: 'ok' } }) +
|
|
'\n',
|
|
);
|
|
expect(await request).toEqual({ content: 'ok' });
|
|
});
|
|
});
|