# Unity CLI / Pipeline

已安装的 CLI：`%LOCALAPPDATA%\Unity\bin\unity.exe`，版本 `1.0.0-beta.8`。工程依赖 `com.unity.pipeline 0.7.0-exp.1`。

```powershell
$cli = "$env:LOCALAPPDATA\Unity\bin\unity.exe"
& $cli status
& $cli command --project-path . --query ashfall --detail compact
& $cli command ashfall_setup --project-path .
& $cli command open_scene --project-path . --path Assets/Ashfall/Scenes/Frontier.unity
& $cli command editor_play --project-path .
& $cli command ashfall_start --project-path . --brood true
& $cli command ashfall_status --project-path .
& $cli command editor_stop --project-path .
& $cli command ashfall_build --project-path . --timeout 900
```

等待 `editor_play` 完成域重载再调用 `ashfall_start`。`ashfall_start` 创建新的单人世界，先归档已有存档。状态命令只返回位置、形态、连接和载具运动，不返回身份令牌。

视觉测试命令：

```powershell
& $cli command ashfall_view_fixture --project-path . --location transport --floor 1
& $cli command capture_game_view --project-path . --source screen --width 1440 --height 900 --save_path Screenshots/interior.png
```

`ashfall_view_fixture` 只用于单人模式的画面检查，移动测试角色到指定空间。它不作为玩家正常的进出机制。正常游戏使用步行入口和楼梯。

源文件修改后：

```powershell
& $cli command recompile --project-path .
& $cli command recompile_status --project-path .
```

只有 `completed` 且 `failed=false` 后才能继续构建或运行。后台可用 `set_autotick --enable true` 保持编辑器更新。

运行 Unity 测试：

```powershell
& $cli command run_tests --project-path . --mode editor --filter Ashfall.EditMode --filter_type assembly --async_tests true
& $cli command test_status --project-path .
& $cli command run_tests --project-path . --mode playmode --filter Ashfall.PlayMode --filter_type assembly --async_tests true
& $cli command test_status --project-path .
```

不要同时执行两轮测试。结果位于 `Temp/pipeline_test_status.json`。

## 本机验证版本说明

主工程保留计划要求的 `6000.3.24f1`。CLI 下载约 337 MB 后遭远端断开，`--resume` 未找到可恢复任务，6.3 尚未安装完成。

已有 `F:\Unity\6000.1.3f1\Editor\Unity.exe` 可用，因此验证在 `.tools/validation` 副本完成：游戏 C# 源码相同，兼容包调整为 URP 17.1.0、2D Animation 10.2.0、Test Framework 1.5.1。该副本的包锁文件保存在 `Docs/packages-lock.validation-6000.1.json`，不冒充主工程的 6.3 包锁。

使用当前打开的验证副本时，将上述命令的 `--project-path .` 改为 `--project-path .tools/validation`。6.3 安装完成后，需在主工程重新完成导入、编辑器测试、Play Mode 测试和 Windows 构建。