一个有用的第一个提示可识别技术、应用行为、约束以及显示工作已完成的证据。 这减少了助手选择熟悉但不正确的Windows框架的可能性。
从接受条件开始
在请求代码之前,请定义预期观察到的内容:
- 项目为 x64 生成,不会出现错误或警告。
- 应用使用 WinUI 3,
Microsoft.UI.Xaml而不是 UWP 和Windows.UI.Xaml。 - 用户可以添加、完成和删除任务。
- 应用重启后,任务将保持不变。
- 每个输入和命令都有可访问的名称。
- 当窗口较窄时,命令将保持可用。
- 助手解释需要包标识或窗口初始化的任何 API。
这些标准将宽泛的请求转化为你和助手都可以执行的检查项。
为助手设定持久性约束
打开保存开发项目的文件夹,启动 AI 编码助手,并使用此提示:
Create a C# WinUI 3 desktop app named TaskTally.
Technology constraints:
- Use WinUI 3 and the current stable Windows App SDK.
- Use Microsoft.UI.Xaml namespaces. Don't use UWP, Windows.UI.Xaml,
WPF, Windows Forms, .NET MAUI, or third-party UI controls.
- Create a packaged app and build for x64.
- Start from the dotnet new winui-mvvm template.
- Use CommunityToolkit.Mvvm for observable properties and commands.
App requirements:
- Show a single-page task list.
- Let the user add, complete, and delete tasks.
- Save tasks as JSON in the app's local storage.
- Use ListView for the collection and InfoBar for save status.
- Include an empty state, keyboard access, accessible names, and a
layout that works at narrow window widths.
Working agreement:
- First show your implementation plan and the files you will change.
- Make one small, buildable change at a time.
- Build after each change and fix errors before continuing.
- Explain which Learn documentation supports any Windows API choice.
- Don't suppress warnings or replace packaged deployment with an
unpackaged workaround.
最后一节很重要。 它要求助手公开其假设并生成更易于检查的检查点。
查看拟议计划
在批准编辑之前,请检查计划是否包括:
- 一个任务,一个模型。
- 包含可观察集合和命令的视图模型。
- 存储服务。
- 该页面的 XAML。
- 如果需要,可为视图特定事件编写少量后台代码。
- 打包的 WinUI 应用的生成和启动步骤。
如果助手提出使用数据库、依赖注入、多页面或自定义控件,请让它修改其计划。 这些选项可以在较大的应用中有效,但它们会添加此初学者应用不需要的概念。
创建项目
助手应运行与以下命令等效的命令:
dotnet new winui-mvvm -n TaskTally
cd TaskTally
dotnet build -p:Platform=x64
如果使用Visual Studio,可以改为创建打包的 C# WinUI 项目并添加 MVVM 工具包。 保留项目名称 TaskTally ,使本教程中的命名空间匹配。
Note
打包的 WinUI 应用必须使用其包标识进行部署。 使用 Visual Studio、结合受支持的 WinUI 模板使用 winapp,或使用 dotnet run CLI。 不要直接启动生成出的 .exe。
检查生成的项目
询问:
Explain the purpose of App.xaml, MainWindow.xaml, MainPage.xaml,
Package.appxmanifest, and TaskTally.csproj. For each file, identify
the WinUI 3 or Windows App SDK setting that proves this isn't a UWP,
WPF, or MAUI project.
自行验证说明:
- 项目文件包含
<UseWinUI>true</UseWinUI>。 - 项目引用
Microsoft.WindowsAppSDK。 - XAML 代码使用 C# 中的
Microsoft.UI.Xaml类型。 -
Package.appxmanifest提供包标识。 - 目标框架包括Windows,例如
net10.0-windows10.0.26100.0。
在添加功能之前生成未更改的模板。 如果基线无法构建,请先解决环境问题或项目创建问题,然后再要求助手生成更多代码。