SuperAPI AI 工具集

unity-cli-refresh

编程与开发

查看项目

更新于 10-16 02:31

技能介绍

用途:在磁盘上写入或修改 .cs 文件或资源后,触发 Unity 重新扫描资源(AssetDatabase refresh)并等待脚本编译,使 Unity 重新编译。

主要能力:一条命令完成刷新、编译与域重载等待;可通过 --exit-playmode 在刷新前自动退出播放模式;--wait TIMEOUT 阻塞至刷新、编译、域重载周期完成(默认 120 秒,最大 600 秒)。域重载会重启 HTTP 服务并清空 REPL 会话,--wait 会处理重连。完成后可用 unity-cli-status 技能验证。

使用方式:cs 是 python "$HOME/.unity-cli-plugin/current/cli/cs.py" 的简写,路径固定,直接原样运行,不要切换目录。若尚未安装,先运行一次 unity-cli-setup 技能。推荐一步式命令:python "$HOME/.unity-cli-plugin/current/cli/cs.py" refresh --json --project "$(pwd)" --exit-playmode --wait 120。需要细粒度控制时可手动分步:先查播放模式 python "$HOME/.unity-cli-plugin/current/cli/cs.py" command --json --project "$(pwd)" editor playmode.status;若 isPlaying 为 true 需先退出,运行 python "$HOME/.unity-cli-plugin/current/cli/cs.py" command --json --project "$(pwd)" editor playmode.exit;再不带 --exit-playmode 触发刷新 python "$HOME/.unity-cli-plugin/current/cli/cs.py" refresh --json --project "$(pwd)" --wait 120。

适用场景:修改脚本或资源后需要 Unity 重新编译时。限制:需先安装 unity-cli 插件;等待时间上限 600 秒;域重载会中断 HTTP 服务与 REPL 会话。其他细节暂未提供。