SuperAPI AI 工具集

unity-project-bootstrap

编程与开发

查看项目

更新于 11-12 22:38

技能介绍

用途 unity-project-bootstrap 面向“从零新建 Unity 项目并让 bridge 可用”这一类任务:用户希望得到一个全新工程,安装并连通 bridge,准备好第一个可运行场景,并能通过一次可见的 Play 模式检查确认真实可运行。它只覆盖缺席项目的引导;若只是修复已有项目的连接、只在已有项目中创建场景、只做 Play 模式输入模拟或只管理包,应使用对应的其他技能。

主要能力

  1. 项目创建:依据请求确定绝对项目路径、Editor 版本与模板/渲染管线;未指定管线时使用最小内置 3D 项目并说明该选择,保留用户显式选择,不替换已存在的项目,也不静默更改 Editor 版本。
  2. bridge 安装与连接:等待创建/导入结束,核对 Packages/manifest.json 与 ProjectSettings/ProjectVersion.txt;在安装 bridge 前关闭刚创建的 Editor,以便配置 Input System 激活而无需重启对话框,且不影响其他项目的 Editor。
  3. 连通校验:运行 unity-cli --project-path <project> --output json setup --launch-editor,多 Editor 场景下选择未占用端口并让 setup 与后续命令使用同一 --port;要求 ok: true、editor.projectMatches: true 与匹配的 bridge 版本,并用 unity-cli system ping 对同一项目/端口做校验。
  4. 包解析核对:bridge 将 Input System 作为依赖引入,应在 Packages/packages-lock.json 中确认解析结果,不随意安装最新版本;用户要求的其他包按所选 Editor 的兼容版本添加。
  5. 初始场景:用 unity-scene-create 创建并保存最小场景,默认包含相机与平行光,检查层级后加入可见 Cube;默认路径 Assets/Scenes/Bootstrap.unity,仓库 E2E 运行使用 Assets/Scenes/Generated/E2E/Bootstrap.unity。
  6. 运行验证:进入 Play,确认 get_editor_state,抓取 Game 视图并检查图像,要求 Cube 可见、无编译/运行时错误、是真实 Game 截图而非 OS 回退;停止 Play 后确认场景仍已保存再报告成功。

使用方式 创建后在该项目内按所选端点执行命令(必要时附加相同的 --project-path / --port):unity-cli system ping、unity-cli scene create Bootstrap --path Assets/Scenes/、unity-cli raw get_hierarchy --json '{"includeComponents":true}'、unity-cli raw create_gameobject --json '{"name":"BootstrapCube","primitiveType":"cube"}'、unity-cli raw save_scene --json '{"scenePath":"Assets/Scenes/Bootstrap.unity"}'、unity-cli raw play_game --json '{}'、unity-cli raw get_editor_state --json '{}'、unity-cli raw capture_screenshot --json '{"captureMode":"game","width":1280,"height":720,"osFallback":false}'、unity-cli raw read_console --json '{"count":20}'、unity-cli raw stop_game --json '{}'。

适用场景 需要新建 Unity 2022.3 或 Unity 6 等项目并安装、确认 bridge 的场景;请求横跨项目创建、初始包与首个可运行场景的场景;项目目录为空或不存在的场景。

限制 setup/连接失败时应使用 doctor、导入/编译日志与 editor.hint 排查,不要盲目重试或另建项目;没有 setup 的 CLI 版本改用 bridge install 并按 unity-cli-usage 校验 ping。工具目录中不存在的操作应报告缺口并关联独立 issue,不在本流程中新增 CLI/bridge 功能;空场景的设备状态不能证明游戏输入可用;不编造版本、包或截图结果,最终报告需列出 Editor/CLI/bridge 版本、项目路径、已解析包、ping、保存的场景与截图路径以及剩余失败。