SuperAPI AI 工具集

ue-graph-capture

设计与创作

查看项目

更新于 10-16 00:29

技能介绍

用途:ue-graph-capture 用于非交互式捕获 Unreal Engine 蓝图中的 EventGraph、Function Graph 和 Macro Graph,并输出完整 PNG 图片。

主要能力:通过 CLI 完成项目设置、环境检查、图表列举与图像捕获。支持 EventGraph、Function Graph、Macro Graph 等受支持图表类型;Timeline、Widget Designer、Anim Blueprint、Material、Niagara 等不受支持界面可能使用有明确边界的旧版回退方案,需与受支持捕获流程分开处理。

使用方式:所有命令均通过固定版本运行器执行:uvx --from "ue-graph-capture==0.1.0" ue-graph-capture <command> ...。需先确认 uv 与 uvx 可用,并用 --version 验证实际版本恰为 ue-graph-capture 0.1.0。若项目为权威源材料,应先复制或提取到临时工作区,再运行会修改项目的命令。对临时项目副本执行一次 setup --project <project.uproject>,随后执行 doctor --project <project.uproject>。图表名称未知时,用 list-graphs --project <project.uproject> --asset /Game/... 查询。捕获命令为 capture --project <project.uproject> --asset /Game/... --graph <exact graph name> --output <output.png>。完成后需验证输出为可读 PNG,并在生成清单时记录已验证的工具版本与捕获输入。

适用场景:需要以非交互方式批量或自动化获取蓝图图表截图,用于文档、审查或记录。

限制:setup 会修改项目并安装捕获插件,因此不得对权威 ZIP、仓库资产或源项目直接运行 setup;输出路径应尽量放在项目之外,避免生成的 PNG 成为项目源变更。资产需使用 Unreal 包路径(如 /Game/Blueprints/BP_Player),而非文件系统路径;图表名称必须与 list-graphs 报告完全一致。捕获流程应无需人工交互,当项目、资产、图表、编辑器或 PNG 无效时应以诊断信息失败。该包不是持久 PATH 或 pipx 依赖。