用途:winapp-sandbox 在持久化的 Windows Sandbox 中运行、调试并 UI 自动化 Windows 应用,而不是直接在用户桌面执行。适用于一次性应用测试、来宾环境诊断等场景。构建、项目评估与还原仍在宿主机执行,不应把 Sandbox 当作不可信项目的隔离手段。系统只支持一个 Sandbox,其中的应用共享同一用户、桌面与状态。前提是 Windows 11 24H2+ 受支持版本及硬件虚拟化;来宾 winapp 支持 x64/Arm64,x86 应用需要来宾支持与匹配依赖。winapp 只检查宿主机前提,不自动启用功能、安装客户端、请求提权或重启。
主要能力与用法:基本启动为 winapp run . --on sandbox --detach,后续可用 winapp ui list-windows、winapp ui inspect、winapp ui invoke、winapp ui screenshot 等命令(均需 --on sandbox)检查与操作界面;--detach 用于运行后继续检查,--json 便于程序化消费结果。录制可用 winapp ui record --on sandbox 并配合 WINAPP_UI_WORKFLOW_ID 与 winapp ui yield 协调多步操作。证据采集包括 winapp target snapshot/screenshot/record sandbox。文件与来宾设置可用 winapp target push/exec/pull sandbox(目标路径须为相对管理区)。清理用 winapp unregister . --on sandbox,它不会停止 Sandbox。
限制:连接或重连可能短暂抢占焦点;已存在的 Sandbox 会被复用并改变,未经用户同意不要关闭或执行 wsb stop。录制与截图可能含敏感信息;输出默认交付到宿主机,需注意选择新路径、审阅 stopReason 与恢复提示。若设置未完成,需由用户自行启用 Windows 功能并重启,不要自动重启或把设置批准当作重启批准。具体收费、价格与更多平台支持资料暂未提供。