SuperAPI AI 工具集

new-windows-app

编程与开发

查看项目

更新于 11-02 16:28

技能介绍

用途:该技能提供一个可直接构建运行的原生 Windows 应用模板,基于 WinUI 3、C# 和 .NET 10,包含核心库、测试与打包安装脚本,适合作为新 Windows 桌面应用的起点。

主要能力:模板为 .NET 解决方案,含 WinUI 3 应用、Core 库和 xUnit 测试;build.ps1 将应用构建到 %LOCALAPPDATA%\Programs<AppName> 并创建开始菜单项;Directory.Build.props 将构建输出放在仓库与 OneDrive 之外。附带图标处理(SVG 渲染为 .ico 和 .png)、快照模式(每页生成浅色与深色 PNG 及布局文件)、自测模式(--selftest 逐项 PASS/FAIL)、种子数据(APP_SEED=1)、智能体日志(APP_LOG)、4 epx 间距体系与网格检查工具。

使用方式:先确认 dotnet --list-sdks 为 10.0 或更高、系统为 Windows 11 或 Windows 10 19041 及以上;缺少 SDK 可用 winget install Microsoft.DotNet.SDK.10 后重开终端。运行 scripts/new-app.ps1 并指定 -Name 与 -Parent 生成项目(会复制模板、填入名称、git init 并提交);随后 cd 项目目录执行 ./build.ps1 -Open 构建并打开。模板工具均为 PowerShell 脚本,Git Bash 中需通过 powershell -File 调用;若脚本执行被禁用,需用户自行设置执行策略。可用 dotnet test、tools/selftest.ps1、tools/snap.ps1 运行检查与快照。若存在 docs/BRIEF.md,按其主类型重命名 Item 和页面。

适用场景:快速搭建带 SQLite 存储、设置页、导航与列表详情页的 WinUI 3 桌面应用;需要智能体参与构建、快照和迭代的开发流程;希望以未打包(unpackaged)方式秒级重建并重启应用;构建由多个规格组成的套件应用(见 suite.md)。

限制:模板采用未打包形式;需要包标识(如共享目标、启动任务、资源管理器上下文菜单、Windows AI API)时应改用稀疏包。发布(dotnet publish)可能缺少未打包 WinUI 应用的 .pri 与编译 XAML,应使用 build.ps1 安装。PowerShell 执行策略不可由智能体自行更改;项目应尽量避开 OneDrive 目录。