SuperAPI AI 工具集

unity-cli-setup

编程与开发

查看项目

更新于 10-16 02:31

技能介绍

用途:这是 unity-cli 的一次性初始化设置技能,用于把 Unity C# Console 包安装进当前 Unity 项目,并引导一个与具体智能体无关的稳定 CLI 路径。

主要能力与用法:

  1. 引导 CLI(仅首次需要)。运行 python "${CLAUDE_PLUGIN_ROOT}/cli/cs.py" install-cli || python "../../cli/cs.py" install-cli,该命令会把 CLI 复制到 $HOME/.unity-cli-plugin/current/,之后所有命令都使用这一稳定路径;插件升级后副本会自动刷新。
  2. 安装 Unity 包。先让用户选择安装方式:git(推荐,把 git URL 写入 manifest.json,由 Unity 自行解析)或 local(把仓库克隆到项目中,用于开发/调试,优先使用已有本地包路径,否则默认 Packages/)。随后运行 python "$HOME/.unity-cli-plugin/current/cli/cs.py" setup --project "$(pwd)" --method <local|git>。默认固定到与插件版本匹配的最新 vMAJOR.MINOR.* 标签,追加 --no-pin 则从 HEAD 安装;使用 local 方式时克隆处于固定标签的 detached HEAD,如需在克隆中开发需自行 git checkout main。
  3. 验证。安装成功后让用户打开 Unity 编辑器,等待 Package Manager 解析 com.zh1zh1.csharpconsole,确认后运行 unity-cli-status 技能检查状态。

限制与注意:若 setup 以非零退出码失败,应立即停止,不要重试或手动 git clone,需先解决网络、代理或 git 配置问题。若输出包含版本不匹配警告,应询问用户是否现在更新,确认后追加 --update 重新运行 setup。状态命令只是检查,不代表服务一定可达,服务仅在编辑器内 C# Console 运行时才可达。