Unity CLI 2022 技术修改适配

认识 Unity CLI：在终端里操作 Unity

开发越来越多地发生在终端——脚本里、CI 里，乃至 AI 代理手中。Unity CLI 顺势而生：一个快速、统一的 unity 命令，把 Unity 由外及内地带进终端——安装与管理编辑器、用脚本驱动运行中的编辑器，甚至无需重新编译即可在工程内执行 C#。

---

本仓库提供经过最小修改的 Unity CLI 安装脚本，用于解决官方安装地址被重定向到国区 CDN 并安装了老版本 0.1.x（缺少 pipeline / command 等命令）的问题。

• 唯一功能改动：当显式指定安装版本号时，跳过 SHA-256 校验。原因是官方“浮动清单”（latest-beta.json）里的校验值属于清单自身的（旧）版本，与你指定的新版本二进制并不匹配。二进制本身仍从 Unity 官方 CDN 按版本号路径下载。
• 本仓库不包含修改版的 com.unity.pipeline 包，也不分发任何 Unity 二进制文件。com.unity.pipeline 在 Unity 2022 下的适配方式见下文。

---

🛠️ 安装 Unity CLI

✅ 官方安装方法

# macOS / Linux
curl -fsSL https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.sh | UNITY_CLI_CHANNEL=beta bash

# Windows (PowerShell)
$env:UNITY_CLI_CHANNEL='beta'; irm https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.ps1 | iex

安装完成后，运行 unity --version 确认版本。

⚠️ 修改版安装方法（网络被重定向时）

如果安装后仍是旧版 0.1.x，说明官方下载地址可能在你的网络里被重定向了。此时请改用「指定版本号 + 本仓库的公开安装脚本」，安装已验证的 1.0.0-beta.2：

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/rocwood/unity-cli-2022-mod/main/cli/install.sh | UNITY_CLI_CHANNEL=beta UNITY_CLI_VERSION=1.0.0-beta.2 bash

# Windows (PowerShell)
$env:UNITY_CLI_CHANNEL='beta'; & ([scriptblock]::Create((irm https://raw.githubusercontent.com/rocwood/unity-cli-2022-mod/main/cli/install.ps1))) -Target 1.0.0-beta.2

---

📦 安装 Pipeline 包

✅ 官方安装方法（适用于 Unity 6.0+）

# 默认作用于当前目录
unity pipeline install

# 或指定工程路径：
unity pipeline install --project-path /path/to/your/unity/project

⚠️ Unity 2022 安装方法

com.unity.pipeline 官方包面向较新的 Unity 6.0+ 版本，Unity 2022 工程无法通过 CLI 安装或在 Package Manager 中添加。

• 打开任意一款 AI 编程工具（如 Codex/Claude Code）
• 让 AI 从 Unity Registry 抓取 com.unity.pipeline 源码放入工程
• 让 AI 修复 PhysicsMaterial 与 Material.rawRenderQueue 等 API 兼容性编译错误
• 让 AI 将 Runtime/Plugins/CodeAnalysis 下 Microsoft.CodeAnalysis*、System.Collections.Immutable、System.Reflection.Metadata 的 DLL .meta 转为兼容的v2格式
• 修复完成后即可在 Unity 2022 工程内正常使用。

---

🤖 安装技能和操作规范

安装 com.unity.pipeline 后，让 AI：

1. 从包内提取 .claude/skills/unity-pipeline，安装到当前工程的技能目录。

2. 下载 UNITY-GUIDE.md 到工程根目录。

3. 在 AGENTS.md 或 CLAUDE.md 中加入：

   进行 Unity 开发时，必须阅读并遵循 [UNITY-GUIDE.md](UNITY-GUIDE.md)。

---

⚖️ 免责声明

本仓库以 MIT 许可发布，但该许可仅适用于本仓库作者所做的修改及原创内容（安装脚本的改动、README 等文档）。本仓库中的 Unity CLI 安装脚本改编自 Unity Technologies 的官方安装器；Unity CLI 及其下载的二进制文件均为 Unity Technologies 的财产，仍受 Unity 适用的许可条款、服务条款及第三方许可证约束。

本仓库包含对 Unity 官方 CLI 安装脚本的最小修改版本，作为在 Unity 2022 环境下的兼容性与技术方案评估参考。本仓库不包含 Unity Pipeline 包本身，也不分发任何 Unity 二进制文件——安装脚本仅从 Unity 官方 CDN 下载官方发布的二进制。

本仓库无意替代 Unity Technologies 提供的任何官方软件或软件包。原始软件、脚本及其中的源代码、二进制文件和其他受保护材料，仍受其适用的许可条款、服务条款及第三方许可证约束。

本项目与 Unity Technologies 无关联，亦未获其赞助、认可或授权。“Unity”及相关名称、标识和商标均归 Unity Technologies 或其关联方所有；本仓库中对其的提及仅用于识别兼容目标，不构成任何商标使用许可。

本仓库按“现状”提供，不提供任何明示或默示保证，包括但不限于适销性、特定用途适用性、非侵权性、稳定性、安全性或与任何 Unity 版本的兼容性保证。使用者应自行测试，并自行承担使用本项目所产生的一切风险与责任。