Syncfusion WinForms UI Builder 是一个仅面向 Windows 桌面(WinForms)的控件生成技能,通过编排 AI 智能体完成 8 个阶段的工作流,生成由 Syncfusion WinForms 控件驱动的、可用于生产的 UI 控件与配套后端代码。
用途
该技能用于根据用户请求生成完整的 WinForms 功能界面。其核心原则是:每个生成的界面必须端到端可用——UI 与后端逻辑相连、验证生效、导航正常工作,不接受部分逻辑或仅桩代码的输出。
主要能力
UI 层生成:
- 使用 Syncfusion WinForms 控件的 Windows Forms .cs + .Designer.cs 文件,以及配套 .resx 资源
- 无障碍标记(AccessibleName、AccessibleDescription、AccessibleRole、Tab 顺序,符合 WCAG 2.1 AA)
- DPI 感知的响应式布局(TableLayoutPanel / FlowLayoutPanel、AutoScaleMode)
- 客户端输入验证与事件处理
后端层生成:
- 包含业务逻辑的服务类(例如 AuthService、CustomerService)
- 仓储接口与内存实现
- 导航 / 窗体切换逻辑(模态、非模态、MDI)
- 数据模型、DTO 以及 presenter/绑定接口
不生成的内容:
- 真实数据库结构、ORM 迁移或 SQL
- 实时第三方 API 集成
- 认证基础设施(OAuth、JWT 签发)
- 除 SYNCFUSION_LICENSE_KEY 之外的环境密钥
使用方式
前置条件:
- WinForms 项目,目标为 .NET Framework 4.6.2+ 或 .NET 8+(
<UseWindowsForms>true</UseWindowsForms>) - Visual Studio 2022+ 并安装 ".NET desktop development" 工作负载
- Syncfusion WinForms 库(如缺失将自动安装):
dotnet add package Syncfusion.Core.WinForms - Node.js 14+(阶段 3 的 BM25 控件映射脚本所需)
执行流程(强制顺序):
- 阶段 1:意图分析——解析查询、识别窗体/控件类型与功能、明确后端需求
- 阶段 2:项目检测——自动检测框架、.NET 版本、主题与项目结构
- 阶段 2A:框架一致性防护(快速失败)——强制为 WinForms 项目类型,如混入 WPF/WinUI/MAUI/控制台控件或命名空间则阻断
- 阶段 3:布局分析与控件映射(用户确认点 #1,需运行脚本)——读取 control-mapping.json,运行 BM25 脚本,将后端动作映射到各控件
- 阶段 4:主题与设计系统(用户确认点 #2)——锁定 Syncfusion WinForms 视觉样式、色表、4px DIP 网格间距、1.25 字体比例
- 控件技能提取(代码生成前的阻断性前置条件)——校验所有控件均为已验证状态,提取命名空间、NuGet 包、属性与事件并持久化
- 阶段 5B-1 类型安全强制、5B-2 资源校验(在生成设计器代码前运行,自动修复)
- 阶段 5:安全代码生成(UI + 后端完整实现)
- 阶段 6:NuGet 依赖管理
- 阶段 7:设计时编译验证(自动修复循环,最多 5 次迭代)
- 阶段 8:代码插入与构建验证
阶段门控与阻断规则:阶段 2A 在框架不匹配时阻断;阶段 5A 在技能文件缺失或提取失败时阻断;阶段 6 在 skill-extraction.json 缺失时阻断。
适用场景
- 需要快速生成完整 WinForms 功能界面(如登录窗体、带排序筛选的客户数据表)的场景
- 需要同时产出 UI 与后端业务逻辑代码的项目
- 使用 Syncfusion WinForms 控件并需要无障碍支持与 DPI 感知布局的桌面应用
限制
- 仅适用于 WinForms 桌面项目,不支持 WPF/WinUI/MAUI 或控制台项目,且禁止混用不同框架的控件或命名空间
- 仅使用 Syncfusion WinForms 控件,不使用原生微软控件(如 TextBox 需用 TextBoxExt,Button 需用 SfButton,DataGridView 需用 SfDataGrid)
- 仅生成模拟数据,使用内存仓储与示例数据,不连接真实数据库或调用真实 API
- 不生成数据库结构、SQL、实时第三方 API 集成或认证基础设施
- 除用户明确提供的 SYNCFUSION_LICENSE_KEY 外不处理其他密钥
- 若缺少许可密钥,会提示获取免费社区许可或警告将出现评估水印;该技能本身的具体收费与价格信息暂未提供
- 采用无状态设计,对话历史是唯一的状态存储
许可密钥处理
技能会在 app.config/appsettings.json 或环境变量中检查 SYNCFUSION_LICENSE_KEY。若缺失,提示从 https://www.syncfusion.com/account/manage-trials 获取免费社区许可;若提供,则注入配置并在 Program.cs 中调用 Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense();若跳过,警告将出现评估水印。