Skip to content

v0.8.25

Latest

Choose a tag to compare

@Wilson520403 Wilson520403 released this 02 Nov 03:43

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-loader CLI 命令。
  • 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