SuperAPI AI 工具集

unity-cli-command

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:通过 C# Console 命令协议在 Unity Editor 中运行框架命令,用命令行方式完成编辑器内的结构化操作,适合自动化与脚本化控制 Unity 项目。

主要能力:内置命令按命名空间组织,包括 editor(状态、播放模式、菜单、窗口、控制台)、gameobject(查找、创建、销毁、获取、修改、设置父级、复制)、component(增删改查序列化字段)、transform(获取/设置位置旋转缩放)、material(创建、获取、分配)、prefab(场景实例操作与直接编辑 .prefab 资源)、project(场景列表/打开/保存、选择、资源列表/导入/重导入)、asset(移动、复制、删除、建文件夹)、scene(层级树)、screenshot(Scene View / Game View 截图)、profiler(录制、停止、状态、保存)、session(REPL 会话)与 command(列出命令)。

使用方式:命令形式为 python "$HOME/.unity-cli-plugin/current/cli/cs.py" command --json --project "$(pwd)" <namespace> <action> ['<args-json>']。建议始终加 --json,返回信封为 { "ok": bool, "exitCode": int, "summary": str, "data": {...} },以 ok / exitCode 判断成功。Vector3 等参数用 {"x":0,"y":1,"z":3} 对象,数组参数用 JSON 数组。写入 .cs 文件或修改磁盘资源后需刷新:python "$HOME/.unity-cli-plugin/current/cli/cs.py" refresh --wait --exit-playmode --json --project "$(pwd)"。命令选择顺序为 command → snippet → 临时 cs exec。自定义命令可先查 cs catalog list --json,缓存缺失时用 list-commands --type custom 实时查询,必要时 cs catalog sync --json。

适用场景:需要在 Unity Editor 中批量或自动化执行对象、组件、场景、预制体、资源与截图等操作时。

限制:多数命令仅限编辑器环境,session/* 与 command/list 在编辑器和运行时均可用,运行时需 --mode runtime --port 15500。首次使用需先运行 unity-cli-setup 技能安装。REPL 会话在域重载时会被清空。具体收费、价格与平台支持资料暂未提供。