SuperAPI AI 工具集

unity-cli

部署与运维

查看项目

更新于 10-15 17:25

技能介绍

用途:Unity CLI 是一个实验性(beta)命令行工具,用于在用户本机 shell 中操作已绑定的 Unity 项目,其价值在于 Unity 编辑器关闭时也能工作;它不是 REST 技能,不通过 REST 服务器执行。

授权门槛:使用前必须检查 <projectRoot>/Library/UnitySkills/cli_config.json,文件缺失、不可读或 enabled 为 false 时该模块不适用。enabled 为 true 时以 cliPath 作为可执行文件,并遵循 features 中的开关(coldStart、openArgs、cliTest、cliRun、cliBuild)。cliRun / cliBuild 在旧版配置中缺失即视为关闭。全局注册表 ~/.unity_skills/registry.json 仅用于存活性检查,不作为授权依据。

主要能力:coldStart 可启动未运行的编辑器,命令为 <cliPath> open "<projectPath>" --args -unityskills-coldstart;openArgs 可在启动时传入场景等参数,如 --args -openscene "Assets/Scenes/Main.unity";cliTest 执行无界面测试,如 <cliPath> test "<projectPath>" --mode EditMode --filter <pattern> --output test-results.xml --timeout 1800;cliRun 做一次性批处理,如 <cliPath> run "<projectPath>" --timeout 1800 -- -executeMethod Your.Static.Method -quit;cliBuild 做无界面构建,可按 Build Profile、内置桌面目标或自定义 C# 构建方法选择路径。另有 status、editors、doctor、projects verify 等预检命令。

使用限制:编辑器已运行时不得使用 run、build 或冷启动,改用 REST 技能;错误处理需结合 JSON 信封、errors[].code 与 stderr,退出码 0 成功、2 参数错误、6 操作失败或无结论、7 服务不可达。命令表面在不同版本间变化,建议先查看 --version 与 <command> --help。不得擅自安装 CLI 或修改服务器与配置。构建命令有脏工作区保护,签名等敏感信息由用户自行处理。

资料未提供:具体安装步骤、定价、支持平台清单与性能数据暂未提供。