用途:安全地操作独立的 unity CLI,用于安装、配置、自动化、排障以及从 Unity Hub CLI 迁移工作流。由于该 CLI 属实验性,命令面可能随版本变化,因此以已安装 CLI 的帮助信息为权威依据。
识别正确工具:先确认可执行文件是独立 Unity CLI,可运行 command -v unity、unity --version、unity --help。不要与 Unity Editor 命令行参数、已弃用的 Unity Hub CLI 及其 -- --headless 包装、Unity Gaming Services CLI(ugs)、Unity Version Control(cm)、Package Manager 命令或同名第三方程序混淆。
必要预检:确定操作系统与架构;运行 unity --version、unity --help 及相关命令的 --help,嵌套命令需用完整路径(如 unity projects clone --help);优先使用已安装帮助而非记忆语法;判断操作是只读还是改变状态;核对平台可用性与实验性提示。
命令选择流程:从帮助暴露的最窄只读检查命令开始;从已安装帮助解析别名、版本选择器、路径、架构、模块与必填值;仅在帮助明确提供时使用预览或 dry-run;自动化中以独立参数构建 argv,不将发现值插入 shell 代码;状态变更前说明目标与影响,获得授权后执行,并检查退出码、用只读命令验证结果。
自动化与结构化输出:使用帮助明确支持的结构化格式;分离 stdout 与 stderr,stdout 作数据解析,stderr 留作诊断;即使有结构化输出也要检查退出码;不解析动画进度输出;CI 中避免交互提示,仅在帮助暴露时使用非交互与确认选项;需要可复现时固定 CLI 与 Editor 版本;绝不记录凭据、令牌、序列号、离线许可材料或服务账号密钥。
平台处理:安装、选择 Editor 架构、修改路径或模块前先确定 OS 与架构,不跨平台移植标志,除非目标平台帮助暴露该标志。
状态变更操作:安装/升级/卸载 CLI 或 Editor、增删模块、注册 Editor 或改默认与全局安装路径、创建/导入/克隆/链接/取消链接/删除/升级项目、移除凭据或改认证状态、激活/归还/修改许可、清缓存、改代理/语言/分析/持久配置等,均视为状态变更或破坏性操作,须先说明并用完整命令路径加 --help 检查,未经明确授权不得执行。
排障:记录 OS、架构、command -v unity、unity --version、完整 argv、退出码、stdout、stderr;重跑完整路径加 --help;使用只读诊断命令;检查 PATH、权限、代理/网络、凭据存储、非交互设置、Editor/版本/模块解析与平台支持;分享前脱敏。若帮助解析不完整、输出结构异常或命令可能意外改变状态,应停止。
限制:资料未提供具体命令清单、参数细节、收费与价格信息,需以本地已安装帮助为准。