Files
Genarrative/apps/ai-game-creator-shell/src/services/pluginHost.ts
T
kdletters 4a46f89c9b
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
接入 AGC 内置插件宿主并补齐 Cocos 编辑器能力 (#338)
客户端新增随包提供的插件宿主和 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>
2026-09-13 14:48:55 +08:00

80 lines
2.0 KiB
TypeScript

import { resolveTauriInvoke } from '../app/tauri';
import type {
AgcExtensionSummary,
AgcPluginPanel,
AgcPluginSummary,
} from '../app/types';
export type PluginRpcParams = Record<string, unknown> | unknown[] | null;
function invokeOrThrow() {
const invoke = resolveTauriInvoke();
if (!invoke) throw new Error('需要在 Tauri App 内运行');
return invoke;
}
export async function listAgcPlugins() {
return invokeOrThrow()('list_agc_plugins') as Promise<AgcPluginSummary[]>;
}
export async function listAgcExtensions() {
return invokeOrThrow()('list_agc_extensions') as Promise<
AgcExtensionSummary[]
>;
}
export async function refreshAgcPlugins() {
return invokeOrThrow()('refresh_agc_plugins') as Promise<AgcPluginSummary[]>;
}
export async function startAgcPlugin(id: string) {
return invokeOrThrow()('start_agc_plugin', {
id,
}) as Promise<AgcPluginSummary>;
}
export async function stopAgcPlugin(id: string) {
return invokeOrThrow()('stop_agc_plugin', {
id,
}) as Promise<AgcPluginSummary>;
}
export async function reloadAgcPlugin(id: string) {
return invokeOrThrow()('reload_agc_plugin', {
id,
}) as Promise<AgcPluginSummary>;
}
/** 内置插件的可用开关;禁用后不能启动,对应 Agent 工具也不再出现。 */
export async function setAgcPluginEnabled(id: string, enabled: boolean) {
return invokeOrThrow()('set_agc_plugin_enabled', {
id,
enabled,
}) as Promise<AgcPluginSummary[]>;
}
export async function callAgcPlugin<T = unknown>(
id: string,
method: string,
params: PluginRpcParams = null,
) {
return invokeOrThrow()('call_agc_plugin', {
id,
method,
params,
}) as Promise<T>;
}
export async function readAgcPluginPanel(id: string, panelId: string) {
return invokeOrThrow()('read_agc_plugin_panel', { id, panelId }) as Promise<{
panel: AgcPluginPanel;
html: string;
}>;
}
export async function setAgcPluginProjectPath(projectPath: string | null) {
return invokeOrThrow()('set_agc_plugin_project_path', {
projectPath,
}) as Promise<void>;
}