用途:安装并校验其他 winui-* 技能所依赖的前置条件。WinApp CLI 0.7 通过 winapp new 负责 WinUI 模板的发现与安装,不要单独安装模板包;项目目标框架可能要求比 CLI 最低版本更新的 .NET SDK。
主要能力:先一次性检测 .NET SDK(最低 8.0.100)、WinApp CLI(需已发布 0.7.0 及以上,预发布版不满足)、开发者模式(注册表 AppModelUnlock 的 AllowDevelopmentWithoutDevLicense 为 1),打印状态表;按需安装或升级,并输出单一最终汇总。技能是幂等的:只装所缺项。
安装方式:安装 WinApp CLI 这类每用户前置项无需询问,但需告知用户;.NET SDK、开发者模式、Native AOT 构建工具等需管理员权限或大型工具链的操作必须先征得同意。缺 winapp 用 winget install --id Microsoft.WinAppCli --exact --silent --accept-package-agreements --accept-source-agreements,低于 0.7.0 用 winget upgrade 同参数;.NET SDK 用 winget install --id Microsoft.DotNet.SDK.10 --exact --silent --accept-package-agreements --accept-source-agreements。任何 winget 操作后刷新 PATH 并重新检测版本。
适用场景与限制:Native AOT 发布/运行还需 Visual Studio 或 Build Tools 的 Desktop development with C++ 及 Windows SDK;Windows Sandbox 运行与 UI 自动化需 Windows 11 24H2+、硬件虚拟化、可用的 Sandbox 客户端,仅 Pro/Enterprise/Education 支持,不含 Home。启用 Windows Sandbox 需用户自行操作(管理员并重启)。不要安装 Visual Studio 本体,不要动用户的 AI 编码工具,不要整体提权,不静默重试失败安装。
若当前环境有 winui-dev 编排代理,可用如 copilot --agent winui:winui-dev -p "build me a WinUI 3 markdown editor" 启动新会话;否则在当前环境新会话中执行 WinUI 任务,按需加载相关 winui-* 技能。某项未通过时只报告对应流程的就绪状态,不宣称项目已就绪。