unity-cli-usage

用途：这是 unity-cli 的基础引导技能，用于让其他 Unity 相关技能可靠运行。当没有其他 unity-* 技能匹配连接或安装问题时，会自动加载。适用于验证或安装 unity-cli、处理 system ping/instances list/instances set-active、不确定如何调用桥接工具或发现可用工具、以及工作流因 host/port、安装模式或连接故障受阻的情况。若有更具体的技能匹配（如场景创建用 unity-scene-create、C# 编辑用 unity-csharp-edit、编辑器状态检查用 unity-editor-tools），或只检查/修改项目文件而不调用 Unity，则不应使用。主要流程：优先使用 PATH 中已安装的 unity-cli，否则回退到仓库中的 cargo run --；用 unity-cli system ping 验证可达性；存在多个编辑器时用 unity-cli instances list 并用 unity-cli instances set-active host:port 选定目标。操作入口：存在类型化子命令时优先使用（如 system ping、scene create、instances list、instances set-active；reference * 系列见 unity-csharp-reference）；大多数桥接工具没有类型化封装，应使用 unity-cli raw <tool_name> --json '{...}'（等价别名 tool call）。这是调用桥接的主要方式，而非回退方案。用 unity-cli tool list 发现工具，用 unity-cli tool schema <tool_name> --output json 查看负载结构。链式自动化时使用 --output json。示例：检查连接运行 unity-cli system ping；切换到 6401 端口实例先 instances list --ports 6400,6401 再 instances set-active localhost:6401；查看打开场景内容用 unity-cli raw analyze_scene_contents --json '{}'。限制：资料未提供具体安装细节之外的收费、平台与价格信息；instances list/set-active 属于本地注册表操作，不是桥接工具封装。