Skip to main content
Glama
fgui-agent-bridge

fgui-agent-bridge

by Wilson520403

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FGUI_PROJECT_PATHNoPath to the FairyGUI project (alternative to --project or fgui_use_project).
FAIRYGUI_EDITOR_PATHNoPath to the FairyGUI Editor executable (e.g., /Applications/FairyGUI-Editor.app on macOS or C:\Tools\FairyGUI-Editor\FairyGUI-Editor.exe on Windows).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

先读取工程、包和对象树,再执行修改。文档属性和对象修改默认不保存;创建组件或按钮会新增包资源,导入/替换图片、声音和 MovieClip 会写入磁盘,调用前必须确认包、目录、名称和冲突策略。Transition 编辑与已有 MovieClip 更新支持 Agent undo/redo;新建/删除资源不能完整撤销,且资源写入不能由 fgui_discard_document 回滚。动画预览只改变 Editor 当前状态,不保存资源默认属性。只有用户明确要求时才调用保存工具。发布前先调用 fgui_get_publish_settings,并确认用户要求的包范围后再调用 fgui_publish。

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
fgui_statusA

读取本地 FairyGUI 工程选择和桥接心跳,不主动唤醒编辑器。

fgui_pingA

唤醒 FairyGUI Editor 并验证桥接协议、版本和能力。

fgui_use_projectA

为当前 MCP 会话选择 .fairy 文件、FairyGUI 工程目录或仓库目录。

fgui_get_projectC

读取当前 FairyGUI 工程信息。

fgui_list_packagesA

列出当前 FairyGUI 工程中的全部包。

fgui_list_branchesA

列出工程分支及活跃分支;可附带每个包的分支根与资源。

refresh=True 先从磁盘重扫。分支资源目录为 assets_/,活跃分支不会让编辑器自动改道保存。

fgui_create_branchA

创建分支并为每个包建立分支根;走工程原生 API,立即落盘且不可撤销。

switch_to=True 创建后切换活跃分支;有未保存文档时需同时 save_open_documents=True。

fgui_switch_branchA

切换活跃分支;name 传空字符串切回主干。

只改变编辑器分支上下文。真机 6.1.4 上文档保存与资源创建不会自动改道,Bridge 的写操作按 branch 参数或活跃分支显式寻址。

fgui_list_itemsA

列出指定包中的资源,可按 FairyGUI 资源类型过滤。

省略 branch 时跟随当前活跃分支,branch="" 表示主干。返回的分支视角中, 分支资源覆盖同名主干资源;只读操作可以读取非活跃分支,不需要先切换。

fgui_open_documentA

按包名和资源名打开 FairyGUI 组件文档。

省略 branch 时跟随当前活跃分支,branch="" 表示主干。只读打开不要求该分支处于活跃状态, 但后续写该文档前仍需切换。

fgui_create_componentB

在指定包中新建组件文档;默认打开但不保存,重名时默认拒绝。

save=True 保存包与工程后默认比对 package.xml(分支写入比对 package_branch.xml)条目;组件类资源没有可靠的 asset 重载手段,external_reload 不可用,strength 上限为 disk。

fgui_import_imageB

从绝对本地路径导入图片;这是磁盘写入操作,支持拒绝、自动改名或替换同名图片。

max_size 是长边上限(像素,1~32768):源图长边超过它就先等比缩放再入库,响应里的 scaled 回报缩放前后尺寸与缩放比,atlasPrecheck 给出按真实图集约束的前置判定(fit 为 fits/exceeds/unknown,unknown 不等于放行)。

save=True 保存包与工程后默认比对 package.xml(分支写入比对 package_branch.xml)条目和资源文件;external_reload=True(需 save=True)卸载并重新加载 asset 再比对,响应 strength 为 reload / disk / none。

fgui_import_fontB

从绝对本地路径导入字体;这是磁盘写入操作,支持拒绝、自动改名或替换同名字体。

save=True 保存包与工程后默认比对 package.xml(分支写入比对 package_branch.xml)条目和资源文件;external_reload=True(需 save=True)卸载并重新加载 asset 再比对,响应 strength 为 reload / disk / none。

fgui_create_buttonB

创建标准 FairyGUI Button 组件;状态图顺序为 up/down/over/selectedOver/disabled/selectedDisabled。

save=True 保存包与工程后默认比对 package.xml(分支写入比对 package_branch.xml)条目;组件类资源不支持 external_reload,strength 上限为 disk。

fgui_get_active_documentA

读取当前活动文档、修改状态和选择数量。

fgui_get_treeA

读取当前组件对象树;修改前应先取得稳定的对象 ID 或路径。

branch 指定时要求当前文档属于该分支;只读读取不要求该分支处于活跃状态。

fgui_import_soundA

从绝对本地路径导入声音资源;支持替换同名声音,属于磁盘写入。

save=True 保存包与工程后默认比对 package.xml(分支写入比对 package_branch.xml)条目和资源文件;external_reload=True(需 save=True)卸载并重新加载 asset 再比对,响应 strength 为 reload / disk / none。

fgui_create_movieclipB

用有序绝对图片路径创建或替换 MovieClip;图片序列由 FairyGUI 原生动画资源处理。

save=True 保存包与工程后默认比对 package.xml(分支写入比对 package_branch.xml)条目和资源文件;external_reload=True(需 save=True)卸载并重新加载 asset 再比对,响应 strength 为 reload / disk / none。

fgui_get_movieclipC

读取 MovieClip 的帧、FPS、Swing 和 RepeatDelay 设置。

fgui_update_movieclipB

更新已有 MovieClip;传入 frame_paths 时使用新的有序图片序列替换动画帧。

save=True 保存包与工程后默认比对 package.xml 条目和资源文件;external_reload=True(需 save=True)卸载并重新加载 asset 再比对,响应 strength 为 reload / disk / none。

fgui_remove_movieclipB

删除 MovieClip 包资源;这是不可逆资源操作,必须显式 force=True。

save=True 保存包与工程后默认比对 package.xml 确认条目已移除;删除没有诚实的重载基元,external_reload 不可用,strength 上限为 disk。

fgui_delete_package_itemA

删除包资源(组件/图片/字体/声音/MovieClip/目录);不可逆操作,必须显式 force=True。

编辑器原生 DeleteItem 不会拦引用:被引用的资源照样删,引用方会留下悬空 src。 默认检测到引用就拒绝并列出引用位置;确认要删就传 allow_dangling_references=True,响应会回报哪些引用会变悬空。 目标组件的文档正开着时默认拒绝;传 close_open_documents=True 让本工具关闭它(未保存改动一律拒绝)。 删除会连带删掉磁盘文件,不进 Agent 撤销栈。

fgui_rename_package_itemA

重命名包资源;磁盘文件同步改名,不可撤销。

new_name 不带扩展名(编辑器按资源类型补)。同名资源会被拒绝。 改名不会更新引用方文档的 fileName 属性(id 不变,运行时按 id 解析不受影响), 响应里的 staleFileNameSlots 会列出这些位置,需要时让那些文档经编辑器重新保存一次即可补齐。

fgui_move_package_itemA

把包资源移动到包内另一个目录;磁盘文件同步移动,不可撤销。

folder_path 是包内目录(如 "/ui/")。编辑器原生 MoveItem 要求目标目录已存在, 否则会抛原生异常;本工具默认按 create_folders=True 先建目录再移动,并在响应里回报是否新建了目录。 移动不会更新引用方文档的 fileName 属性(id 不变,运行时按 id 解析不受影响),响应里的 staleFileNameSlots 会列出这些位置。

fgui_duplicate_package_itemA

复制包资源;副本是新 id 的新资源,磁盘文件一并复制,原资源不受影响。

new_name 省略时用 "<原名>_copy"。conflict_policy 取 error(同名即拒绝)或 auto_rename(自动加后缀)。

fgui_list_transitionsA

读取当前组件的全部 Transition 及类型化关键帧。

fgui_get_transitionA

按名称读取当前组件的一个 Transition。

fgui_verify_transitionA

只读校验当前组件的 Transition:目标对象、关键帧值、嵌套引用与 XY 位置范围。

不修改文档、不保存。省略 name 时校验全部 Transition。summary.valid 只统计 error; position_outside_canvas 是 warning——滑入/滑出动画的越界坐标本身是合法的。

fgui_upsert_transitionA

声明式创建或完整替换一个 Transition;一次调用可由 fgui_undo/redo 原子回退。

save=True 保存后默认比对磁盘 XML 中的 节点;external_reload=True(需 save=True)关闭并重新打开文档再比对,响应 strength 为 reload / disk / none。

fgui_remove_transitionA

删除当前组件中的一个 Transition;可由 fgui_undo 恢复。

save=True 保存后默认确认磁盘 XML 不再包含该 Transition;external_reload=True(需 save=True)关闭重开后确认仍不存在,响应 strength 为 reload / disk / none。

fgui_add_transition_itemB

向 Transition 添加一个类型化关键帧轨道项。

save=True 保存后默认比对磁盘 XML 中该 Transition 的条目数;external_reload=True(需 save=True)关闭重开再比对,响应 strength 为 reload / disk / none。

fgui_update_transition_itemB

替换 Transition 指定索引的关键帧项;可用 fgui_undo/redo 回退。

save=True 保存后默认比对磁盘 XML 中该 Transition 的条目数;external_reload=True(需 save=True)关闭重开再比对,响应 strength 为 reload / disk / none。

fgui_remove_transition_itemA

删除 Transition 指定索引的关键帧项;可用 fgui_undo 恢复。

save=True 保存后默认比对磁盘 XML 中该 Transition 的条目数;external_reload=True(需 save=True)关闭重开再比对,响应 strength 为 reload / disk / none。

fgui_add_keyframesA

在 Transition 时间轴上创建关键帧;一次调用可由 fgui_undo/redo 原子回退。

每项需要 targetId(空表示根组件)、type 与 frame;value 省略时由编辑器采样对象当前状态。 label 可写说明文字。同一轨道同一帧已存在会整体拒绝,不会留下半写入。 save=True 保存后默认比对磁盘 XML 中该 Transition 的条目数;external_reload=True(需 save=True)关闭重开再比对。

fgui_set_keyframeA

修改一个已有关键帧;可用 item_index,或 target_id + track_type + frame 定位。

按 target_id/type/frame 还能定位 get_transition 隐藏的 Tween 合成端点(此时 itemIndex=null、syntheticEndpoint=true)。changes 支持 frame / label / tween / ease / repeat / yoyo / value / endValue。tween=true 只能用于已处于 Tween 关系中的关键帧 (Tween 起点,或插入已有 Tween 后形成的端点);普通关键帧之间建立 Tween 请用 fgui_upsert_transition。endValue 写入 Tween 端点;tween=false 不能同时给 endValue。 save=True 保存后默认比对磁盘 XML;external_reload=True(需 save=True)关闭重开再比对。

fgui_duplicate_transitionA

复制一个 Transition(含全部关键帧);可由 fgui_undo 回退。

6.1.4 的 DuplicateTransition 运行时不接受新名称参数,Bridge 会复制后再经文档模型改名; structureNormalized=true 表示副本结构经编辑器归一化,与源不完全一致。省略 new_name 时沿用编辑器自动命名。 save=True 保存后默认比对磁盘 XML 中副本的 节点;external_reload=True(需 save=True)关闭重开再比对。

fgui_preview_animationA

在 Editor 中播放、暂停、停止、跳帧或查询预览状态;预览不会保存到 FairyGUI 资源。

fgui_get_historyB

读取 Agent 属性事务栈和 FairyGUI 原生撤销状态。

fgui_select_objectB

通过对象 ID、对象树路径或唯一名称选择一个对象。

fgui_set_propertyB

修改白名单属性;该操作进入 Agent 属性 undo/redo 事务栈。

save=True 保存后默认比对磁盘 XML;external_reload=True 会在保存后关闭并重新打开文档再比对,需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_replace_object_resourceA

通过 Editor API 替换 Image/Loader 图片引用或组件实例的源组件(0.8.21+);保存后默认比对磁盘 XML。Button 状态暂不支持。

组件实例换源组件走编辑器原生命令 Document.ReplaceSelection:id/name/xy/relation/显式 size 全部保留, 没有显式 size 时尺寸跟随新源组件(FGUI 语义,preserve_size 对组件实例不适用)。 expected_type 省略时按目标对象推导(image/loader→image,组件实例→component),显式传入则作为断言。

external_reload=True 会在保存后关闭并重新打开文档再比对,是唯一能证明「重新载入时值不丢」的验证;需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_query_referencesA

查询全工程里哪些位置引用了目标资源(只读,0.8.10+)。

走编辑器原生 DependencyQuery,返回的每条引用精确到「哪个包的哪个资源的哪个属性槽」: packageId / itemId / propKey / arrayIndex / valueType。改资源引用前先跑它,能直接回答 「换掉这张图会影响哪些节点」,也可作为 replace_object_resource 的影响面预览。

只读:不会保存、不会标记文档修改。max_items 限制返回条数(默认 200,上限 2000), 截断时 truncated=true 且 totalCount 仍为真实总数,不会静默丢弃。 skip_package_open=True 跳过「预先打开未打开的包」,更快但可能少算未打开包里的引用; 默认会先打开,代价记录在响应的 packages 字段里。

fgui_query_dependenciesA

查询目标资源依赖了哪些资源(只读,0.8.10+)。

走编辑器原生 DependencyQuery。seek_level 取 selection / samePackageButNotExported / samePackage(默认)/ all,决定依赖搜索范围;响应会回报实际生效的 seekLevel。

只读:不会保存、不会标记文档修改。max_items、skip_package_open 同 fgui_query_references。

fgui_find_unusedA

找出工程内没有任何引用位置的资源(只读,0.8.19+)。

返回每个未引用资源的包、路径、URL、文件大小,图片还附带尺寸。判断口径是 「当前工程内零引用」:导出资源可能被运行时按 URL 使用,默认仍会列出并标记 exported,删改前请确认;skip_exported=True 可排除它们。

packages 传包名或包 ID,省略时扫描全工程;types 可按 image / font / sound / movieclip / component 过滤;max_items 限制返回明细条数,unusedCount 仍是真实总数。

fgui_find_duplicateA

找出文件内容完全相同的资源,按 MD5 分组(只读,0.8.19+)。

适合清理重复导入的图片、字体和音效;组件 XML 也参与比较。每组返回文件大小、 条目和可回收字节数,按浪费体积从大到小排序。同名不同内容不算重复。

packages / types / include_branches 同 fgui_find_unused;max_groups 和 max_items_per_group 分别限制组数与组内明细条数,计数字段不受截断影响。

fgui_replace_referencesA

把全工程对某个资源的所有引用替换成另一个资源(0.8.11+)。

先预览、再执行,这是硬要求而不是建议:编辑器原生 ReplaceReferences 直接改包 XML, 立即落盘、不进 Agent 撤销栈、没有 save 兜底,也没有 external_reload 可做—— 响应里 undoable=false 就是这个意思。默认 execute=false 只出预览, 确认 totalCount 与 references 明细后再显式传 execute=True。

与 fgui_replace_object_resource 分工:那个改「某一个对象的某一个属性槽」, 走文档模型、可撤销、有 save/verify/external_reload 梯子;这个改「全工程引用图」, 走原生批处理、不可撤销。两者不要互相替代。

执行后按引用图回读验证(源资源残留引用必须为 0),verification.scope 会标明 "reference-graph"——这是引用图口径,不宣称属性级一致:原生批量替换不会同步 image 元素的 fileName,落盘后该属性短暂滞后,warnings 字段会显式报出槽位数量, 这些节点下次经编辑器保存时自动补齐。

max_items、skip_package_open 同 fgui_query_references。

fgui_get_text_styleC

读取 TextField/RichText 的统一文本样式。

fgui_set_text_styleB

设置 TextField/RichText 的统一文本样式。

external_reload=True 会在保存后关闭并重新打开文档再比对,是唯一能证明「重新载入时值不丢」的验证;需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_set_instance_overrideA

写组件实例的扩展级 override(同一个组件、不同实例不同文案/样式)。

只支持扩展级覆盖,这是编辑器与 FGUI 运行时共同支持的那一层: 源组件是 Button 扩展时可写 title(text 是别名)、icon、selectedTitle、selectedIcon、 titleColor(#RRGGBB 六位,alpha 会被编辑器丢掉)、titleFontSize;Label 扩展可写 title、icon、titleColor、titleFontSize。落盘形态是实例节点里的扩展子节点 <component ...><Button title="..."/></component>,运行时按同一组字段消费。

边界(真机 6.1.4 实测):编辑器不支持逐子对象覆盖——改实例内部子对象只改到内存, 磁盘不落盘;这类需求请改用 insert_text 直接建对象,或把样式固化成组件类型。 源组件没有扩展时也会被拒绝。

external_reload=True 会在保存后关闭并重新打开文档再比对,是唯一能证明「重新载入时值不丢」 的验证;需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_verify_documentA

只读验证 target 的 expected 属性;默认比对磁盘 XML,不保存。无 expected 时仅返回快照。

expected 为纯属性对象时比对单个 target(必须提供 object_id/object_path/object_name)。expected 含 children 时执行对象树比对,可省略 target(默认根组件):每个节点用 id/name/type 断言或定位,children 为子节点 spec 数组;childrenMode 默认 "exact"(按位置全等,数量必须一致),"subset" 表示每个 spec 按 id/name/index 定位一个子节点、允许多余节点。

external_reload=True 会关闭并重新打开当前文档再比对——这是只读操作仍能达到的最强持久化证明。本命令不会保存,因此文档存在未保存改动时会拒绝执行。

fgui_set_list_layoutA

修改 List 对象的布局与滚动属性(0.8.8+)。fields 支持:

layout(single_column/single_row/flow_horizontal/flow_vertical/pagination)、 selectionMode(none/single/multiple/multiple_singleclick)、lineGap、columnGap、 defaultItem(ui:// 组件资源)、autoItemSize、align/vAlign(含 none)、 selectionController(控制器名)、foldInvisibleItems、clearOnPublish、 scrollItemToViewOnClick、overflow(visible/hidden/scroll)、margin("l,t,r,b")。

external_reload=True 需 save=True,关闭重开文档后重新比对;strength 标明验证强度。

fgui_set_group_layoutA

修改 Group 对象的布局属性(0.8.8+)。fields 支持:

advanced、layout(horizontal/vertical 或 hz/vt)、lineGap、columnGap、 excludeInvisibles、mainGridMinSize、mainGridIndex、autoSizeDisabled、collapsed。 layout/lineGap/columnGap/excludeInvisibles 仅对 advanced=true 的高级组有效。

external_reload=True 需 save=True,关闭重开文档后重新比对;strength 标明验证强度。

fgui_set_relationB

整体替换对象的 Relation 绑定(0.8.8+)。relations 每项为:

{"target": {"id"/"path"/"name"} 或 null(null/缺省 = 父组件), "sidePair": "left-left,right-right" 或 "pairs": [{"source": "right", "target": "right", "percent": false}]}

sidePair 方向名:left/center/right/leftext/rightext/width(水平), top/middle/bottom/topext/bottomext/height(垂直);percent 追加 % 后缀。

external_reload=True 需 save=True,关闭重开文档后重新比对;strength 标明验证强度。

fgui_set_gear_displayA

设置对象的 gearDisplay 联动(0.8.8+):指定控制器与可见页面。

controller=None 或空字符串清除联动;pages 为页面 id 或名称列表(也接受 "0,1" 逗号串), 省略 pages 保持现有页面不变。

external_reload=True 需 save=True,关闭重开文档后重新比对;strength 标明验证强度。

fgui_list_controllersB

列出当前文档根组件的全部 Controller(0.8.8+)。

fgui_set_controllerA

创建、修改或删除当前组件的 Controller(0.8.8+)。

create=True 创建不存在的控制器;remove=True 删除;pages 整体替换页面集 (会重新分配页面 id,gearDisplay 中的页面引用需重新核对);add_pages 追加; selected_index/selected_page 设置选中页。

external_reload=True 需 save=True,关闭重开文档后重新比对;strength 标明验证强度。

fgui_create_groupA

将至少两个根组件下未锁定、未分组对象组成组(0.8.24+)。

targets 每项仅含 id/name/path 一个定位键。原生操作把成员移到显示列表末尾。 返回成员归属和前后顺序;不进 Agent 撤销栈。save 保存整个当前文档; external_reload 需 save=True,关闭重开验证顺序、名称和成员归属。

fgui_duplicate_objectA

原生复制一个根组件下未锁定、未分组的普通对象(0.8.24+)。

保留序列化属性、资源引用、Relation/Gear/扩展覆盖,生成新 ID,追加到末尾。 dx/dy 是相对源坐标偏移,默认原位;几何向零截断并返回 rounded。 不支持组或组成员,不进 Agent 撤销栈。save 保存整个当前文档; external_reload 需 save=True,并验证副本序列化内容和显示列表。

fgui_adjust_depthA

将一个根组件下未锁定、未分组对象移到绝对层级 index(0.8.24+)。

index 从 0 开始,0 是最底层;不能越界或落入分组块。 返回完整前后顺序,不进 Agent 撤销栈;save 保存整个当前文档。 external_reload 需 save=True,关闭重开验证持久化顺序。

fgui_insert_textA

在当前文档根组件下创建文本对象(0.8.20+);结构操作不能由 Agent 属性事务栈撤销。

文本是 FGUI 的裸节点、不是包资源,所以只能用 insert_text 造,不能用 insert_object。 style 支持:font / fontSize / color / align / vAlign / autoSize / letterSpacing / lineGap / width / height / bold / italic / underline / strokeSize / strokeColor / shadowX / shadowY / shadowColor。 其中 width/height 会自动把 autoSize 切成 none(否则编辑器在保存时按文字自然尺寸重算,写进去的尺寸会被改写)。 投影偏移(shadowX/shadowY)会自动打开投影开关:偏移不伴随开关时编辑器不会落盘。

save=True 保存后默认比对磁盘 XML;external_reload=True 会在保存后关闭并重新打开文档再比对,需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_get_list_itemsB

只读当前根组件下的 List 条目(0.8.26+),按原顺序返回完整数组。

items 的空 url 表示继承 defaultItem,effectiveUrls 返回实际组件 URL。 items 可直接用于 set_list_items;unsupportedItemData 非空时整批更新会拒绝。

fgui_set_list_itemsA

整批替换已有 List 的条目(0.8.26+);数组顺序即条目顺序,[] 清空。

最多 1000 项,支持 url/title/icon/name/selectedTitle/selectedIcon;省略的字段清空。 省略 default_item 保留默认组件,空串清除它。条目的空/省略 url 继承最终默认组件。 先校验全部输入;限当前根组件下未锁定的 List,须退出时间轴与组内编辑。 不进 Agent 撤销栈;默认不保存,未保存可 discard,save 保存整个文档。 原生应用失败尝试恢复原条目并回报 rolledBack;保存/验证失败不自动回滚。 external_reload 要求 save=True 且 verify=True。

fgui_insert_loaderA

在当前文档根组件下创建 Loader(0.8.25+)。

url 可空,或引用工程内图片/MovieClip;不接受外部 URL。 固定 autoSize=false,x/y/width/height 向零截断并回报 rounded。 默认不保存;不进 Agent 撤销栈,未保存可 discard。save 保存整个文档。 external_reload 要求 save=true 且 verify=true。

fgui_insert_listA

在当前文档根组件下创建 List,支持布局、默认条目组件和初始条目(0.8.25+)。

default_item 与条目 url 必须引用组件;每项省略 url 时使用 default_item。 items 最多 1000 项,可写 url/title/icon/name/selectedTitle/selectedIcon,图标须引用图片。 x/y/width/height 向零截断,尺寸须大于 0;间距须为整数。 支持保存、XML 条目回读与关闭重开验证。不进 Agent 撤销栈,未保存可 discard。 save 保存整个文档;external_reload 要求 save=true 且 verify=true。

fgui_insert_objectA

插入已有 ui:// 资源;结构操作不能由 Agent 属性事务栈撤销。

save=True 保存后默认比对磁盘 XML;external_reload=True 会在保存后关闭并重新打开文档再比对,需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_remove_objectA

删除非根对象;需要可靠回退时使用 fgui_discard_document。

删除按「缺失性验证」处理:save=True 保存后确认磁盘 XML 不再包含该节点;external_reload=True 关闭重开后确认目标仍不存在,需要 save=True。响应中的 strength 字段标明验证强度:reload / disk / none。

fgui_undoA

优先撤销 Agent 属性事务;事务栈为空时回退到 FairyGUI 原生撤销。

fgui_redoA

优先重做 Agent 属性事务;事务栈为空时回退到 FairyGUI 原生重做。

fgui_save_documentA

显式保存当前 FairyGUI 文档,并清空 Agent 属性事务栈。

fgui_save_allA

显式保存所有 FairyGUI 文档、已打开包和工程,并清空 Agent 属性事务栈。

fgui_get_publish_settingsA

读取工程发布目录、格式、图集、代码生成和包级覆盖设置。发布前应先调用。

fgui_analyze_atlas_fitA

按图集打包器的真实约束(PackSettings / 全局 AtlasSetting)判断每张图能否入图集。

只读,不改任何资源。返回每张图的 fit(fits / exceeds / unknown)、卡住它的约束 (maxWidth / maxHeight / squareSide)以及与旧的大图硬编码规则的差异统计 (disagreements)——发布时仍按旧规则标记 folderAtlas=alone,本工具只暴露差异, 供决定是否切换。

fgui_clear_atlas_markersA

清除磁盘 package.xml 中错误的 atlas="alone" 标记(只处理按真实约束装得下的图片)。

默认只预览,execute=True 才写;可用 item_ids / item_names 限定目标。 这是带外修改:绕过编辑器对象模型,不可撤销、不进 Agent 撤销栈。执行前会保存 当前包并备份 package.xml,写后回读磁盘并 Dispose + 重开包。包内有未保存文档时 直接拒绝;有已保存的打开文档时,需要显式 close_open_documents=True 才会关闭它们。

只清除错误标记,不写任意图集归属;装不下或无法判定的 alone 标记会保留并在 held 里说明原因。

fgui_set_publish_settingsA

按包写入发布与图集设置:输出路径、代码生成、图集约束(PackSettings)与排除列表。

走对象模型(包级设置没有 DocElement 入口),响应里 writePath 会显式声明 object-model:它不进组件文档的撤销栈,也不走组件的持久化验证梯子。

只写你确实要改的字段——未提供的字段保持编辑器当前值,不会被重置。 atlasList 是全量替换语义:传进来的数组就是落盘的最终列表,不做增量合并; 省略该字段则完全不碰图集设置。packSettings 里未提供的键取编辑器新建对象的默认值。

external_reload 是保存后关闭重开包的回读,属于同进程重开,不等于跨重启持久化。

fgui_publishA

按工程发布设置导出 FairyGUI 包。默认发布当前文档所属包并先保存;可选择指定包或全部包。

fgui_discard_documentA

放弃当前文档全部未保存修改并重新加载磁盘版本。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.2/5.0

Scored across 76 tools

Disambiguation3/5

The tool set has clear domain groupings, but several near-neighbor tools create real misselection risk: insert_object vs insert_text/insert_loader/insert_list, add_keyframes vs add_transition_item vs set_keyframe vs update_transition_item, and delete_package_item vs remove_object vs remove_transition vs remove_movieclip. The descriptions often explain the boundaries, but an agent must read carefully to avoid choosing the wrong operation.

Naming Consistency5/5

Every tool uses the fgui_ prefix and snake_case, with predictable verb_noun forms such as fgui_create_component, fgui_get_tree, fgui_set_property, and fgui_verify_document. The few diagnostic names like fgui_ping and fgui_status are minor exceptions within an otherwise highly consistent convention.

Tool Count1/5

With 76 tools, the surface is far beyond the typical 3-15 range and is heavily fragmented into specialized variants for resources, transitions, verification, branches, and object creation. Even for a feature-rich FairyGUI editor bridge, this volume creates excessive selection and maintenance overhead for an agent.

Completeness4/5

The surface is very broad: project selection, branches, packages/items, documents, object trees, properties, transitions, movie clips, lists/groups, publishing, references, and verification are all represented. There are some notable gaps, such as package-level create/delete and branch deletion, but most core workflows have coverage.

Maintenance

ActivityNo data
ResponsivenessOutdated data