Repository navigation
FairyGUI Agent Bridge 现在提供 74 个 MCP 工具,支持通过 MCP 或 CLI 创建和编辑 FairyGUI 界面。本次发布汇总 v0.8.6 以来的改进,主要验证环境为 FairyGUI Editor 6.1.4 / macOS。
本版新增
- 直接创建 List 和 Loader:新增
fgui_insert_list/fgui_insert_loader,以及insert-list/insert-loaderCLI 命令。 - List 初始条目:支持五种布局、行列间距、默认组件和逐条资源 URL,以及标题、图标和选中态覆盖。保存验证覆盖条目数量、有效资源 URL 和覆盖字段。
- Loader 布局:支持空 URL、工程内图片或 MovieClip,以及六种填充方式、对齐、固定尺寸和仅缩小选项。
- 创建前校验与持久化验证:参数和资源先校验;几何精度损失显式回报。支持保存、XML 回读和关闭重开比对,默认不保存,不进入 Agent 撤销栈,未保存时可放弃修改。
- 重新组织使用文档:README 以 GitHub 用户的安装、连接验证、常见用法和兼容性为主;完整工具说明移至 使用参考。
自 v0.8.6 以来的其他主要更新
- 界面搭建:创建文本、设置字重/描边/阴影,分组、复制对象与调整层级;支持 List/Group 布局、Relation、Controller 和 gearDisplay。
- 组件复用:支持 Button/Label 实例的扩展级文案与样式覆盖,以及保留实例布局的源组件替换。
- 资源管理:查询引用与依赖、预览并执行全工程引用替换;删除、改名、移动和复制包内资源;查找未使用与重复资源。
- 动效:只读 Transition 校验,新增/修改关键帧和复制 Transition。
- 图集与导入:按真实打包约束分析图集、设置包级发布配置、纠正多余的
alone标记;支持图片导入前等比缩放与图集前置分析。 - 分支与验证:列出、创建、切换分支并校验写入归属;支持递归对象树比对和显式整数几何语义。
验证
- 该发布提交的 GitHub CI 已通过。
- Python 回归 66/66;模拟宿主回归 301/301;TypeScript 编译与生成文件同步校验通过。
- 本次 List/Loader 功能在 FairyGUI Editor 6.1.4 macOS 隔离工程中 83/83 检查通过,包括 MCP/CLI 调用、23 条非法输入拒绝、未保存后放弃,以及 27 个对象跨完整 Editor 进程重启后的结构与条目检查。
- 本次编辑器验收报告。
升级
在 Bridge 仓库中更新服务和工程插件:
uv run python scripts/sync_to_project.py \
--pull --project /ABSOLUTE/PATH/TO/FAIRYGUI-PROJECT --apply如需同时更新 Skill,追加 --skill-root /PATH/TO/YOUR-CODE-REPOSITORY。更新插件后重新打开 FairyGUI 工程,并确认 fgui_status 返回版本匹配。
当前范围
List/Loader 创建限于当前文档根组件;Loader 不接受外部 URL 或组件资源。完整组复制与组成员操作尚未支持。Windows、Unity 运行时和发布产物尚未完成验收。
完整变更:v0.8.6 → v0.8.25