Agent Skills
返回列表
UnityOps 远程操控 Unity 编辑器

UnityOps 远程操控 Unity 编辑器

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2bb7cf23/unity-ops。

技能介绍

问题

当 Unity 工程已经打开或需要自动化驱动编辑器时,手动点击菜单、等待编译、保存场景和截图会让批处理很难做。Unity_Ops 把编辑器操作收敛为一条 TCP Socket 上的 JSON 协议,让外部脚本可以查询项目路径、刷新资产、加载场景、创建几何体、放置 FBX/Prefab 资产并截取固定视角。它适合需要把 Unity 编辑器动作纳入脚本流程的场景,而不需要人工重复执行菜单操作。

工作方式

技能首先检查 Unity 进程和工程根目录,再自动同步 UnityOpsListener.cs 与 CoreOperations.cs。如果文件存在差异,会要求选择保留 Skill 版本还是 Unity 工程版本;覆盖后会调用 RefreshAssets。随后检查 8888 端口:已监听则继续;未监听但 Unity 已打开时提示手动启动服务;未打开时自动查找 Unity 可执行文件、带 -startServer 参数启动,并轮询等待端口就绪。

可用命令包括:

  • 场景操作:SaveScene、NewScene、LoadScene
  • 模型操作:CreateModel、DeleteObject、PlaceAsset
  • 截图:CaptureScreenshot 支持 iso、top、front 视角
  • 辅助命令:RefreshAssets、Manual、GetAssetPath

边界

所有扩展命令必须写在 Unity 工程的 Assets/Editor/UnityOps/ 下,不能反向修改 Skill 目录中的 CS 源文件。该技能适合在可控环境中做编辑器自动化;涉及强制关闭 Unity、覆盖文件、未保存场景丢失时,需要先确认。

使用场景

  • 打开 Unity 工程后,检查 8888 端口并启动监听,再加载指定场景并保存。
  • 在场景中心创建 Cube、Sphere 等几何体,并设置位置、旋转和缩放。
  • 把 FBX 或 Prefab 资产放入场景,并指定名称和摆放参数。
  • 从等距、俯视或正视角度渲染场景截图,返回保存的绝对路径。

适合人员

  • 需要把 Unity 编辑器保存、加载和截图操作脚本化的编辑器自动化工程师。
  • 要批量创建几何体、放置 FBX/Prefab 资产并输出固定视角截图的场景搭建人员。
  • 需要让 AI Agent 通过 JSON 指令远程操作打开中的 Unity 项目的工具集成开发者。
  • 要检查 Unity 进程、端口和脚本同步,并自动启动 Unity 服务的本地环境工程师。