Unity CLI(travlake)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1a99cb00/unity-cli-travlake。
技能介绍
要解决什么问题
在 Unity 项目里,很多操作仍要打开编辑器点菜单或挂在 Play 模式里试一遍:批量跑测试、从 CI 拉日志、或临时执行一小段 C# 查状态,往往要另写 Editor 脚本或手写自动化胶水。若你更习惯用终端驱动编辑器,而不是只在 GUI 里点,就需要一条直连 Unity 编辑器的 CLI,把常用能力收成固定子命令。
技能如何工作
Unity CLI(travlake)是面向编辑器的轻量命令行工具,按功能分成若干模块:
editor:控制播放、停止与刷新等编辑器状态。console:读取与过滤 Unity 控制台日志,便于脚本化排查。exec:在编辑器上下文中运行任意 C#,适合临时探针或一次性维护脚本。test:触发 EditMode / PlayMode 测试,便于本地或流水线里统一入口。screenshot:从编辑器侧截图,用于回归对比或文档。profiler:做性能分析,配合自动化或 nightly 场景。
资料中强调的亮点包括主线程冻结检测(排查卡死)、任意 C# 执行,以及工具自更新,减少长期维护时的版本漂移。
适用边界与注意点
该技能描述的是对 Unity 编辑器的控制能力,不是替代 Unity 运行时或独立 Server Build 的通用运维 CLI。exec 能跑任意 C#,务必在受信环境与明确项目上下文中使用;自动化测试与 profiler 结果仍依赖你项目自身的测试集与场景配置。无头 CI 是否可用,需结合你当前的 Unity 授权与批处理模式自行验证。
使用场景
- 在 nightly 流水线里用 `test` 子命令统一触发 EditMode 与 PlayMode,不必为每次集成单独写 Editor 菜单脚本。
- 玩家反馈卡顿复现时,用 `console` 过滤错误与警告,再配合 `profiler` 抓一帧性能数据。
- 维护大型场景时需要临时查组件状态,通过 `exec` 跑一小段 C# 而不是新建临时 MonoBehaviour。
- 发版前用 `screenshot` 对关键界面批量截图,和上一版资源做目视或 diff 对比。
适合人员
- 负责 Unity 项目 CI 的构建工程师,希望用固定 CLI 入口跑编辑器内测试与拉控制台日志。
- 客户端主程,需要在不驻场编辑器的情况下远程或脚本化控制播放、刷新与性能采样。
- 技术美术或工具向程序,要把截图与 profiler 接到自有流水线或 nightly 报告里。
- 排查编辑器主线程卡死的程序,想利用资料里提到的冻结检测与日志过滤缩短定位时间。