Unity-MCP 1.0 改用 RQL，AI 可批量查询和修改 Unity 场景

IvanMurzak 维护的社区项目 Unity-MCP 在 10 月 15 日发布 1.0.0，将 GameObject、组件、资源和场景的数据操作改为 RQL（Reflection Query Language）。接入 Claude Code、Cursor 等智能体后，开发者可以让它先筛选场景对象，再读取指定字段或批量修改属性。沿用旧工具名的自动化流程需要随之调整。

用一条查询检查一组对象

这次版本更新将原先分散的约 30 个数据与编辑器操作工具，收拢到 rql-query、rql-mutate 和 rql-schema 三个入口：分别负责读取、修改，以及查询可用类型和成员。

例如，要检查名字以 Prop_ 开头的道具及其位置，可以让智能体通过 rql-query 提交这样的查询：

objects | where name starts-with "Prop_" | select name transform.position

按RQL 参考文档，筛选和字段选择发生在编辑器里的实际对象上，返回给智能体的是筛选后的数据。这类入口可以用于整理关卡中的灯光、检查对象层级或寻找特定材质。脚本、截图、包管理和测试仍有各自的工具入口。

批量修改可以先预览

rql-mutate 的 dry_run: true 会列出预计修改的对象、属性和新旧值，供开发者查看；正式属性写入接入 Unity 的撤销操作。文档列出的默认修改上限是每次 20 个目标。

这里要区分两种操作：set 写入属性失败时会回滚已经写入的值；call 调用方法时，已经完成的调用不能统一回滚，结果会报告完成数量。批量改灯光参数和调用删除方法有不同的后果，执行前仍需查看目标列表。

升级后同步智能体的 Skills

迁移说明明确移除了旧的逐对象数据工具。固定调用 gameobject-*、assets-* 或 scene-* 的脚本，以及记住这些名称的 Skills，需要对照新的 RQL 入口更新；保留 JSON 格式选项也不会恢复旧工具。

项目安装文档提供自动生成 Skills 的入口。升级插件后，可以重新生成项目里的技能说明，再让智能体读取新的工具定义。先从只读查询和修改预览开始，比较容易看清它准备处理哪些对象。

截至 10 月 18 日，项目最新发布版已是 1.2.0；RQL 的主要迁移从 1.0.0 开始。Unity-MCP 插件本身沿用 Apache-2.0 许可，随包提供的 RQL 组件采用单独的 PolyForm Shield 许可，使用或分发时需分别查看对应条款。