SuperAPI AI 工具集

utmapp

通用与其它

查看项目

更新于 10-16 00:01

技能介绍

用途:在 macOS 上用脚本驱动 UTM 虚拟机应用,完成虚拟机生命周期管理、客户机内命令执行与文件传输,以及输入自动化。UTM 在 macOS 上提供 QEMU(跨架构全模拟,支持 HVF 加速、USB 直通、快照、端口转发、自定义 QEMU 参数)和 Apple Virtualization(原生快速,仅限 Apple Silicon 上的 macOS 客户机与现代 Linux)两种后端。

主要能力:utmctl 命令行工具支持 list、start(--disposable/--recovery)、suspend --save-state、stop(--request/默认强制/--kill)、status、clone、delete、version,以及客户机代理操作 exec、file push/pull、ip-address 和 USB connect/disconnect。AppleScript/JXA 负责创建虚拟机、修改配置、注入键盘与鼠标输入、重建共享目录。虚拟机以 .utm 目录包存放,配置为 config.plist,备份即复制该目录。

用法与限制:utmctl 位于 /Applications/UTM.app/Contents/MacOS/utmctl。脚本依赖 AppleScript 桥,必须在已登录的图形会话中运行,SSH 下会报权限错误。delete 无确认;stop 默认强制。Apple 后端不支持输入注入、USB、exec/file/ip-address。exec 等需 QEMU 客户机代理(Linux 安装 qemu-guest-agent)。不要对 macOS 客户机使用 utmctl clone(会共享机器标识),应改用 AppleScript duplicate。克隆命名需带时间戳或日期以免重名冲突。utmctl 的 -2700 错误需结合 utmctl status 判断是否为噪声。桥接网络在 macOS Sequoia 需授予 UTM 本地网络权限。