用途 unity-pipeline 提供一组 unity 命令行，供 AI 智能体在 Unity 项目中自动化操作：编译、测试、求值、热替换方法、进入 Play 模式、管理多人场景和截图检查。命令按组组织，可用 unity command 列出分组，用 unity command <group> 查看组内命令，用 --query <term> 按名称、描述或标签过滤。
安装与验证 常用流程为：unity pipeline install（安装到当前项目，可用 --project-path 指定项目）、unity pipeline list（确认编辑器实例与服务可达）、unity status --until-ready（等待编辑器服务就绪）、unity command editor status（确认编辑器服务响应）。若编辑器已打开，需要在其刷新后才会加载该包，通常会等到窗口重新获得焦点；在此之前状态可能显示 STATUS_PIPELINE_LOAD_PENDING。
主要能力
- 自主编辑循环：使用 editor set_auto_tick 保持编辑器更新，修改磁盘上的 C# 源文件后执行 script recompile 并轮询 script recompile_status，再用 test list 和 test run 运行测试。退出码 2 表示参数错误，应修正命令行后重试；退出码 6 表示命令执行失败或无法连接编辑器，需要读取错误信息，不应原样重试。
- 运行期方法热替换：在运行中的游戏里修改方法体，使用 script.methodreload reload 应用，支持 --pdb 生成可绑定断点的符号；仅适用于 Mono 环境和 void 实例公有方法，需要事先给方法加上 [MethodReload] 并重新编译。
- 脚本运行与 C# 求值：script run 可运行版本化项目脚本中的静态入口点，支持异步入口和参数；script eval 可直接求值 C# 脚本，支持 --file、--runtime、--auto-import、--internals 和 --dry-run 等选项。
- Play 模式与多人场景：editor.playmode start/pause/stop 管理单人 Play 模式；场景命令支持列出、创建、添加/移除玩家、启动、查询状态和停止场景。场景命令需要 Unity 6000.3+ 以及 com.unity.multiplayer.playmode 包；MPPM 最多四个玩家槽，槽 0 固定为主编辑器，因此场景最多三个克隆玩家。
- 多角色设置：multiplayer.role 和 settings.multiplayer_roles 命令用于查看与设置客户端/服务端角色、GameObject 与组件角色以及构建角色，需要 Unity 6000.6+。
- 截图捕获：capture game_view、capture scene_view、capture editor_window 可将视图保存为 PNG 或内联返回，用于视觉结果检查。
使用方式与注意事项 命令通过 --project-path 指定项目，多个项目同时打开时需要显式传入主项目路径；克隆玩家各自运行独立服务，可直接按其项目目录访问，没有转发命令。命令长时间无响应可能是模态对话框阻塞了主线程，可用 editor status 查看是否返回 blocked_by_dialog。仅运行于 Player 的命令需要开发版 Player，不能只在编辑器中执行。