SuperAPI AI 工具集

syncfusion-winforms-ui-builder

编程与开发

查看项目

更新于 10-16 05:58

技能介绍

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. 阶段 1:意图分析——解析查询、识别窗体/控件类型与功能、明确后端需求
  2. 阶段 2:项目检测——自动检测框架、.NET 版本、主题与项目结构
  3. 阶段 2A:框架一致性防护(快速失败)——强制为 WinForms 项目类型,如混入 WPF/WinUI/MAUI/控制台控件或命名空间则阻断
  4. 阶段 3:布局分析与控件映射(用户确认点 #1,需运行脚本)——读取 control-mapping.json,运行 BM25 脚本,将后端动作映射到各控件
  5. 阶段 4:主题与设计系统(用户确认点 #2)——锁定 Syncfusion WinForms 视觉样式、色表、4px DIP 网格间距、1.25 字体比例
  6. 控件技能提取(代码生成前的阻断性前置条件)——校验所有控件均为已验证状态,提取命名空间、NuGet 包、属性与事件并持久化
  7. 阶段 5B-1 类型安全强制、5B-2 资源校验(在生成设计器代码前运行,自动修复)
  8. 阶段 5:安全代码生成(UI + 后端完整实现)
  9. 阶段 6:NuGet 依赖管理
  10. 阶段 7:设计时编译验证(自动修复循环,最多 5 次迭代)
  11. 阶段 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();若跳过,警告将出现评估水印。