李慕婉-仙逆-造相Z-Turbo跨平台开发.NET框架集成与桌面应用开发想象一下你正在为一个创意团队或内容工作室开发一款内部工具。设计师们需要一个快速将文字灵感转化为概念图的途径但他们不熟悉命令行更希望在一个熟悉的、像Photoshop或Word那样的桌面窗口里点点鼠标就能完成。这时候如果能将强大的“李慕婉-仙逆-造相Z-Turbo”模型封装成一个Windows桌面应用无疑会极大提升他们的工作效率。今天我们就来聊聊如何用.NET框架主要是C#来搭建这样一个桥梁。我们将创建一个Windows桌面程序它拥有一个友好的图形界面让用户输入描述、调整参数然后一键调用远端的模型API最后把生成的精美图片直接展示在应用里。整个过程我们会用到WPF或WinForms来设计界面用HttpClient与模型服务通信并用异步编程来保证应用流畅不卡顿。1. 项目构思与环境搭建在开始敲代码之前我们先明确一下要做一个什么样的东西。核心目标是一个Windows桌面应用用户输入文本提示词选择或调整一些生成参数比如图片尺寸、生成数量点击按钮后应用将请求发送给“造相Z-Turbo”的API等待生成完成后把图片下载并显示在应用的界面上。1.1 技术栈选择对于.NET桌面开发我们有两个主流选择Windows Forms (WinForms)和Windows Presentation Foundation (WPF)。WinForms更传统开发速度快控件拖拽简单直观适合快速构建功能性的工具。WPF更现代支持更丰富的UI效果如动画、复杂布局采用XAML标记语言分离界面和逻辑适合需要更精美界面或复杂数据绑定的应用。本文将以WPF为例进行讲解因为它的数据绑定和MVVM模式在处理这类“请求-响应-显示”的场景时非常清晰。但核心的API调用逻辑在WinForms中是完全通用的。首先确保你安装了Visual Studio 2022或更高版本并勾选了“.NET桌面开发”工作负载。1.2 创建WPF项目并引入必要包打开Visual Studio创建一个新的“WPF应用”项目命名为比如ZTurboImageGenerator。我们需要通过NuGet包管理器安装一个用于处理JSON的库因为和API通信主要使用JSON格式。在解决方案资源管理器中右键点击项目选择“管理NuGet程序包”。搜索并安装Newtonsoft.Json这是一个非常流行且易用的JSON库。2. 设计用户界面我们的界面不需要太复杂但需要包含几个核心区域提示词输入区一个多行文本框让用户输入详细的图片描述。参数配置区一些控件用于设置图片宽度、高度、生成数量等。控制区一个“生成”按钮和一个可能用于取消的按钮。结果显示区一个用于显示生成图片的Image控件以及一个可能显示状态或日志的文本框。下面是一个简单的MainWindow.xaml设计框架Window x:ClassZTurboImageGenerator.MainWindow xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml Title造相Z-Turbo 图像生成器 Height600 Width800 Grid Margin10 Grid.RowDefinitions RowDefinition HeightAuto/ RowDefinition Height*/ RowDefinition HeightAuto/ /Grid.RowDefinitions !-- 参数输入区 -- GroupBox Grid.Row0 Header生成参数 Margin0,0,0,10 StackPanel TextBlock Text提示词 (Prompt): Margin5/ TextBox x:NamePromptTextBox AcceptsReturnTrue TextWrappingWrap Height60 Margin5 VerticalScrollBarVisibilityAuto/ WrapPanel Margin5 TextBlock Text宽度: VerticalAlignmentCenter Margin5,0/ TextBox x:NameWidthTextBox Width60 Text512 Margin5,0/ TextBlock Text高度: VerticalAlignmentCenter Margin20,0,5,0/ TextBox x:NameHeightTextBox Width60 Text512 Margin5,0/ TextBlock Text数量: VerticalAlignmentCenter Margin20,0,5,0/ TextBox x:NameNumImagesTextBox Width40 Text1 Margin5,0/ /WrapPanel /StackPanel /GroupBox !-- 图片显示与日志区 -- Grid Grid.Row1 Margin0,0,0,10 Grid.ColumnDefinitions ColumnDefinition Width*/ ColumnDefinition Width3*/ /Grid.ColumnDefinitions !-- 日志框 -- GroupBox Grid.Column0 Header操作日志 Margin0,0,5,0 TextBox x:NameLogTextBox IsReadOnlyTrue VerticalScrollBarVisibilityAuto FontFamilyConsolas FontSize10/ /GroupBox !-- 图片显示框 -- GroupBox Grid.Column1 Header生成结果 Margin5,0,0,0 ScrollViewer VerticalScrollBarVisibilityAuto HorizontalScrollBarVisibilityAuto Image x:NameGeneratedImage StretchUniform/ /ScrollViewer /GroupBox /Grid !-- 控制按钮区 -- StackPanel Grid.Row2 OrientationHorizontal HorizontalAlignmentCenter Button x:NameGenerateButton Content开始生成 Width100 Height30 Margin5 ClickGenerateButton_Click/ Button x:NameCancelButton Content取消 Width80 Height30 Margin5 IsEnabledFalse/ /StackPanel /Grid /Window这个界面提供了基本的输入和显示功能。LogTextBox用于反馈状态GeneratedImage用于展示生成的图片。3. 核心逻辑与模型API通信这是应用最核心的部分。我们需要编写一个服务类专门负责与“造相Z-Turbo”的REST API进行对话。3.1 定义API请求与响应模型首先根据模型API的文档这里假设一个通用结构我们定义C#类来对应JSON数据。在项目中创建一个Models文件夹并添加两个类。ApiRequest.cs:using Newtonsoft.Json; namespace ZTurboImageGenerator.Models { public class ImageGenerationRequest { [JsonProperty(prompt)] public string Prompt { get; set; } string.Empty; [JsonProperty(negative_prompt)] public string NegativePrompt { get; set; } string.Empty; [JsonProperty(width)] public int Width { get; set; } 512; [JsonProperty(height)] public int Height { get; set; } 512; [JsonProperty(num_images)] public int NumImages { get; set; } 1; // 可以根据API文档添加更多参数如steps, guidance_scale等 [JsonProperty(steps)] public int Steps { get; set; } 20; [JsonProperty(seed)] public int? Seed { get; set; } null; } }ApiResponse.cs:using Newtonsoft.Json; namespace ZTurboImageGenerator.Models { public class ImageGenerationResponse { [JsonProperty(images)] public Liststring? ImageBase64List { get; set; } // API可能返回Base64编码的图片字符串 [JsonProperty(error)] public string? Error { get; set; } [JsonProperty(status)] public string? Status { get; set; } } }3.2 实现API调用服务创建一个Services文件夹添加ImageGenerationService.cs。这里我们将使用HttpClient进行网络请求并采用异步编程模式。using Newtonsoft.Json; using System; using System.Net.Http; using System.Text; using System.Threading; using System.Threading.Tasks; using ZTurboImageGenerator.Models; namespace ZTurboImageGenerator.Services { public class ImageGenerationService { private readonly HttpClient _httpClient; private readonly string _apiBaseUrl; // 例如: http://your-model-server-address:port private CancellationTokenSource? _cancellationTokenSource; public ImageGenerationService(string apiBaseUrl) { _apiBaseUrl apiBaseUrl.TrimEnd(/); _httpClient new HttpClient(); // 可以在这里设置默认请求头如Authorization、User-Agent等 // _httpClient.DefaultRequestHeaders.Add(Authorization, Bearer YOUR_API_KEY); _httpClient.Timeout TimeSpan.FromMinutes(5); // 图像生成可能较耗时 } public async TaskListbyte[]? GenerateImagesAsync(ImageGenerationRequest request, IProgressstring? progress null, CancellationToken cancellationToken default) { _cancellationTokenSource CancellationTokenSource.CreateLinkedTokenSource(cancellationToken); try { progress?.Report(正在准备请求...); var requestJson JsonConvert.SerializeObject(request); var content new StringContent(requestJson, Encoding.UTF8, application/json); string apiEndpoint ${_apiBaseUrl}/generate; // 根据实际API端点调整 progress?.Report($正在向 {apiEndpoint} 发送请求...); var response await _httpClient.PostAsync(apiEndpoint, content, _cancellationTokenSource.Token); progress?.Report($收到响应状态码: {response.StatusCode}); if (!response.IsSuccessStatusCode) { var errorBody await response.Content.ReadAsStringAsync(); progress?.Report($请求失败: {response.StatusCode} - {errorBody}); return null; } var responseBody await response.Content.ReadAsStringAsync(); var apiResponse JsonConvert.DeserializeObjectImageGenerationResponse(responseBody); if (apiResponse null) { progress?.Report(解析API响应失败。); return null; } if (!string.IsNullOrEmpty(apiResponse.Error)) { progress?.Report($API返回错误: {apiResponse.Error}); return null; } if (apiResponse.ImageBase64List null || apiResponse.ImageBase64List.Count 0) { progress?.Report(API响应中未包含图像数据。); return null; } progress?.Report($成功接收到 {apiResponse.ImageBase64List.Count} 张图像数据正在解码...); var imageBytesList new Listbyte[](); foreach (var base64String in apiResponse.ImageBase64List) { // 移除可能存在的Base64前缀如 data:image/png;base64, var cleanBase64 base64String.Contains(,) ? base64String.Split(,)[1] : base64String; var imageBytes Convert.FromBase64String(cleanBase64); imageBytesList.Add(imageBytes); } progress?.Report(图像解码完成); return imageBytesList; } catch (TaskCanceledException) { progress?.Report(生成任务已被用户取消。); return null; } catch (HttpRequestException ex) { progress?.Report($网络请求异常: {ex.Message}); return null; } catch (Exception ex) { progress?.Report($处理过程中发生未知错误: {ex.Message}); return null; } finally { _cancellationTokenSource?.Dispose(); _cancellationTokenSource null; } } public void CancelCurrentGeneration() { _cancellationTokenSource?.Cancel(); } } }这个服务类封装了所有与API交互的细节序列化请求、发送POST请求、处理响应、解码Base64图片数据以及异常处理和取消操作。4. 界面与后台逻辑绑定现在我们需要在MainWindow的后台代码MainWindow.xaml.cs中将界面控件与服务逻辑连接起来。4.1 初始化与事件处理首先在窗口类中声明服务实例并在构造函数中初始化实际API地址应从配置文件中读取。using System; using System.IO; using System.Windows; using System.Windows.Media.Imaging; using ZTurboImageGenerator.Models; using ZTurboImageGenerator.Services; namespace ZTurboImageGenerator { public partial class MainWindow : Window { private readonly ImageGenerationService _generationService; private bool _isGenerating false; public MainWindow() { InitializeComponent(); // TODO: 从app.config或用户设置中读取API地址 string apiUrl http://localhost:7860; // 示例地址请替换为实际地址 _generationService new ImageGenerationService(apiUrl); Log(应用程序已启动。请配置正确的API服务器地址。); } private void Log(string message) { Dispatcher.Invoke(() { LogTextBox.AppendText($[{DateTime.Now:HH:mm:ss}] {message}\n); LogTextBox.ScrollToEnd(); }); } private async void GenerateButton_Click(object sender, RoutedEventArgs e) { if (_isGenerating) { MessageBox.Show(当前已有任务正在运行请等待完成或取消。); return; } // 1. 从界面获取参数 var request new ImageGenerationRequest { Prompt PromptTextBox.Text.Trim(), Width int.TryParse(WidthTextBox.Text, out int w) ? w : 512, Height int.TryParse(HeightTextBox.Text, out int h) ? h : 512, NumImages int.TryParse(NumImagesTextBox.Text, out int n) ? n : 1, // 可以在这里添加更多从界面获取的参数 }; if (string.IsNullOrWhiteSpace(request.Prompt)) { MessageBox.Show(提示词不能为空); return; } // 2. 更新UI状态 _isGenerating true; GenerateButton.IsEnabled false; CancelButton.IsEnabled true; GeneratedImage.Source null; // 清空上一张图片 Log($开始生成图像: \{request.Prompt}\ (尺寸: {request.Width}x{request.Height})); // 3. 创建进度报告器 var progress new Progressstring(msg Log(msg)); try { // 4. 调用服务异步生成 var imageDataList await _generationService.GenerateImagesAsync(request, progress); // 5. 处理结果 if (imageDataList ! null imageDataList.Count 0) { // 显示第一张图片 using (var ms new MemoryStream(imageDataList[0])) { var bitmap new BitmapImage(); bitmap.BeginInit(); bitmap.CacheOption BitmapCacheOption.OnLoad; bitmap.StreamSource ms; bitmap.EndInit(); bitmap.Freeze(); // 跨线程使用需要Freeze GeneratedImage.Source bitmap; } Log($成功生成并显示了 {imageDataList.Count} 张图像。); // 可以扩展功能保存所有图片到本地 } else { Log(图像生成失败未收到有效数据。); } } finally { // 6. 恢复UI状态 _isGenerating false; GenerateButton.IsEnabled true; CancelButton.IsEnabled false; Log(当前任务结束。); } } private void CancelButton_Click(object sender, RoutedEventArgs e) { _generationService.CancelCurrentGeneration(); Log(已发送取消请求。); } } }这段代码完成了以下工作收集参数从文本框等控件中获取用户输入的提示词和参数。状态管理在生成期间禁用生成按钮启用取消按钮防止重复提交。异步调用使用async/await调用我们的GenerateImagesAsync方法并传入一个IProgressstring来实时更新日志框。这确保了UI线程不会被阻塞应用在生成过程中依然可以响应。结果处理将API返回的字节数组转换成WPF的BitmapImage并设置为Image控件的源从而在界面上显示出来。异常与取消妥善处理可能发生的异常和用户取消操作。5. 总结与扩展思路通过以上步骤我们成功构建了一个能够集成“造相Z-Turbo”模型的.NET桌面应用原型。这个应用虽然界面简单但涵盖了桌面应用集成AI模型的核心流程友好的参数输入、稳定的网络通信、异步后台处理以及直观的结果展示。在实际使用中你可能会发现一些可以增强的地方。比如增加一个配置窗口来设置API服务器地址和密钥实现一个图片列表来展示批量生成的所有结果而不仅仅是第一张添加图片保存到本地、历史记录查看、参数预设模板等功能。还可以引入更高级的MVVM框架如Prism、MVVM Toolkit来更好地分离界面和业务逻辑让代码更易于维护和测试。这种将云端或本地AI能力“拉近”到用户日常办公环境中的模式对于很多团队来说非常实用。它降低了使用门槛将AI变成了一个随手可用的工具。希望这个基于.NET的实例能为你打开一扇门你可以根据具体的业务需求定制出更强大、更专业的AI赋能桌面应用。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。
李慕婉-仙逆-造相Z-Turbo跨平台开发：.NET框架集成与桌面应用开发
发布时间：2026/7/31 11:01:51
李慕婉-仙逆-造相Z-Turbo跨平台开发.NET框架集成与桌面应用开发想象一下你正在为一个创意团队或内容工作室开发一款内部工具。设计师们需要一个快速将文字灵感转化为概念图的途径但他们不熟悉命令行更希望在一个熟悉的、像Photoshop或Word那样的桌面窗口里点点鼠标就能完成。这时候如果能将强大的“李慕婉-仙逆-造相Z-Turbo”模型封装成一个Windows桌面应用无疑会极大提升他们的工作效率。今天我们就来聊聊如何用.NET框架主要是C#来搭建这样一个桥梁。我们将创建一个Windows桌面程序它拥有一个友好的图形界面让用户输入描述、调整参数然后一键调用远端的模型API最后把生成的精美图片直接展示在应用里。整个过程我们会用到WPF或WinForms来设计界面用HttpClient与模型服务通信并用异步编程来保证应用流畅不卡顿。1. 项目构思与环境搭建在开始敲代码之前我们先明确一下要做一个什么样的东西。核心目标是一个Windows桌面应用用户输入文本提示词选择或调整一些生成参数比如图片尺寸、生成数量点击按钮后应用将请求发送给“造相Z-Turbo”的API等待生成完成后把图片下载并显示在应用的界面上。1.1 技术栈选择对于.NET桌面开发我们有两个主流选择Windows Forms (WinForms)和Windows Presentation Foundation (WPF)。WinForms更传统开发速度快控件拖拽简单直观适合快速构建功能性的工具。WPF更现代支持更丰富的UI效果如动画、复杂布局采用XAML标记语言分离界面和逻辑适合需要更精美界面或复杂数据绑定的应用。本文将以WPF为例进行讲解因为它的数据绑定和MVVM模式在处理这类“请求-响应-显示”的场景时非常清晰。但核心的API调用逻辑在WinForms中是完全通用的。首先确保你安装了Visual Studio 2022或更高版本并勾选了“.NET桌面开发”工作负载。1.2 创建WPF项目并引入必要包打开Visual Studio创建一个新的“WPF应用”项目命名为比如ZTurboImageGenerator。我们需要通过NuGet包管理器安装一个用于处理JSON的库因为和API通信主要使用JSON格式。在解决方案资源管理器中右键点击项目选择“管理NuGet程序包”。搜索并安装Newtonsoft.Json这是一个非常流行且易用的JSON库。2. 设计用户界面我们的界面不需要太复杂但需要包含几个核心区域提示词输入区一个多行文本框让用户输入详细的图片描述。参数配置区一些控件用于设置图片宽度、高度、生成数量等。控制区一个“生成”按钮和一个可能用于取消的按钮。结果显示区一个用于显示生成图片的Image控件以及一个可能显示状态或日志的文本框。下面是一个简单的MainWindow.xaml设计框架Window x:ClassZTurboImageGenerator.MainWindow xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml Title造相Z-Turbo 图像生成器 Height600 Width800 Grid Margin10 Grid.RowDefinitions RowDefinition HeightAuto/ RowDefinition Height*/ RowDefinition HeightAuto/ /Grid.RowDefinitions !-- 参数输入区 -- GroupBox Grid.Row0 Header生成参数 Margin0,0,0,10 StackPanel TextBlock Text提示词 (Prompt): Margin5/ TextBox x:NamePromptTextBox AcceptsReturnTrue TextWrappingWrap Height60 Margin5 VerticalScrollBarVisibilityAuto/ WrapPanel Margin5 TextBlock Text宽度: VerticalAlignmentCenter Margin5,0/ TextBox x:NameWidthTextBox Width60 Text512 Margin5,0/ TextBlock Text高度: VerticalAlignmentCenter Margin20,0,5,0/ TextBox x:NameHeightTextBox Width60 Text512 Margin5,0/ TextBlock Text数量: VerticalAlignmentCenter Margin20,0,5,0/ TextBox x:NameNumImagesTextBox Width40 Text1 Margin5,0/ /WrapPanel /StackPanel /GroupBox !-- 图片显示与日志区 -- Grid Grid.Row1 Margin0,0,0,10 Grid.ColumnDefinitions ColumnDefinition Width*/ ColumnDefinition Width3*/ /Grid.ColumnDefinitions !-- 日志框 -- GroupBox Grid.Column0 Header操作日志 Margin0,0,5,0 TextBox x:NameLogTextBox IsReadOnlyTrue VerticalScrollBarVisibilityAuto FontFamilyConsolas FontSize10/ /GroupBox !-- 图片显示框 -- GroupBox Grid.Column1 Header生成结果 Margin5,0,0,0 ScrollViewer VerticalScrollBarVisibilityAuto HorizontalScrollBarVisibilityAuto Image x:NameGeneratedImage StretchUniform/ /ScrollViewer /GroupBox /Grid !-- 控制按钮区 -- StackPanel Grid.Row2 OrientationHorizontal HorizontalAlignmentCenter Button x:NameGenerateButton Content开始生成 Width100 Height30 Margin5 ClickGenerateButton_Click/ Button x:NameCancelButton Content取消 Width80 Height30 Margin5 IsEnabledFalse/ /StackPanel /Grid /Window这个界面提供了基本的输入和显示功能。LogTextBox用于反馈状态GeneratedImage用于展示生成的图片。3. 核心逻辑与模型API通信这是应用最核心的部分。我们需要编写一个服务类专门负责与“造相Z-Turbo”的REST API进行对话。3.1 定义API请求与响应模型首先根据模型API的文档这里假设一个通用结构我们定义C#类来对应JSON数据。在项目中创建一个Models文件夹并添加两个类。ApiRequest.cs:using Newtonsoft.Json; namespace ZTurboImageGenerator.Models { public class ImageGenerationRequest { [JsonProperty(prompt)] public string Prompt { get; set; } string.Empty; [JsonProperty(negative_prompt)] public string NegativePrompt { get; set; } string.Empty; [JsonProperty(width)] public int Width { get; set; } 512; [JsonProperty(height)] public int Height { get; set; } 512; [JsonProperty(num_images)] public int NumImages { get; set; } 1; // 可以根据API文档添加更多参数如steps, guidance_scale等 [JsonProperty(steps)] public int Steps { get; set; } 20; [JsonProperty(seed)] public int? Seed { get; set; } null; } }ApiResponse.cs:using Newtonsoft.Json; namespace ZTurboImageGenerator.Models { public class ImageGenerationResponse { [JsonProperty(images)] public Liststring? ImageBase64List { get; set; } // API可能返回Base64编码的图片字符串 [JsonProperty(error)] public string? Error { get; set; } [JsonProperty(status)] public string? Status { get; set; } } }3.2 实现API调用服务创建一个Services文件夹添加ImageGenerationService.cs。这里我们将使用HttpClient进行网络请求并采用异步编程模式。using Newtonsoft.Json; using System; using System.Net.Http; using System.Text; using System.Threading; using System.Threading.Tasks; using ZTurboImageGenerator.Models; namespace ZTurboImageGenerator.Services { public class ImageGenerationService { private readonly HttpClient _httpClient; private readonly string _apiBaseUrl; // 例如: http://your-model-server-address:port private CancellationTokenSource? _cancellationTokenSource; public ImageGenerationService(string apiBaseUrl) { _apiBaseUrl apiBaseUrl.TrimEnd(/); _httpClient new HttpClient(); // 可以在这里设置默认请求头如Authorization、User-Agent等 // _httpClient.DefaultRequestHeaders.Add(Authorization, Bearer YOUR_API_KEY); _httpClient.Timeout TimeSpan.FromMinutes(5); // 图像生成可能较耗时 } public async TaskListbyte[]? GenerateImagesAsync(ImageGenerationRequest request, IProgressstring? progress null, CancellationToken cancellationToken default) { _cancellationTokenSource CancellationTokenSource.CreateLinkedTokenSource(cancellationToken); try { progress?.Report(正在准备请求...); var requestJson JsonConvert.SerializeObject(request); var content new StringContent(requestJson, Encoding.UTF8, application/json); string apiEndpoint ${_apiBaseUrl}/generate; // 根据实际API端点调整 progress?.Report($正在向 {apiEndpoint} 发送请求...); var response await _httpClient.PostAsync(apiEndpoint, content, _cancellationTokenSource.Token); progress?.Report($收到响应状态码: {response.StatusCode}); if (!response.IsSuccessStatusCode) { var errorBody await response.Content.ReadAsStringAsync(); progress?.Report($请求失败: {response.StatusCode} - {errorBody}); return null; } var responseBody await response.Content.ReadAsStringAsync(); var apiResponse JsonConvert.DeserializeObjectImageGenerationResponse(responseBody); if (apiResponse null) { progress?.Report(解析API响应失败。); return null; } if (!string.IsNullOrEmpty(apiResponse.Error)) { progress?.Report($API返回错误: {apiResponse.Error}); return null; } if (apiResponse.ImageBase64List null || apiResponse.ImageBase64List.Count 0) { progress?.Report(API响应中未包含图像数据。); return null; } progress?.Report($成功接收到 {apiResponse.ImageBase64List.Count} 张图像数据正在解码...); var imageBytesList new Listbyte[](); foreach (var base64String in apiResponse.ImageBase64List) { // 移除可能存在的Base64前缀如 data:image/png;base64, var cleanBase64 base64String.Contains(,) ? base64String.Split(,)[1] : base64String; var imageBytes Convert.FromBase64String(cleanBase64); imageBytesList.Add(imageBytes); } progress?.Report(图像解码完成); return imageBytesList; } catch (TaskCanceledException) { progress?.Report(生成任务已被用户取消。); return null; } catch (HttpRequestException ex) { progress?.Report($网络请求异常: {ex.Message}); return null; } catch (Exception ex) { progress?.Report($处理过程中发生未知错误: {ex.Message}); return null; } finally { _cancellationTokenSource?.Dispose(); _cancellationTokenSource null; } } public void CancelCurrentGeneration() { _cancellationTokenSource?.Cancel(); } } }这个服务类封装了所有与API交互的细节序列化请求、发送POST请求、处理响应、解码Base64图片数据以及异常处理和取消操作。4. 界面与后台逻辑绑定现在我们需要在MainWindow的后台代码MainWindow.xaml.cs中将界面控件与服务逻辑连接起来。4.1 初始化与事件处理首先在窗口类中声明服务实例并在构造函数中初始化实际API地址应从配置文件中读取。using System; using System.IO; using System.Windows; using System.Windows.Media.Imaging; using ZTurboImageGenerator.Models; using ZTurboImageGenerator.Services; namespace ZTurboImageGenerator { public partial class MainWindow : Window { private readonly ImageGenerationService _generationService; private bool _isGenerating false; public MainWindow() { InitializeComponent(); // TODO: 从app.config或用户设置中读取API地址 string apiUrl http://localhost:7860; // 示例地址请替换为实际地址 _generationService new ImageGenerationService(apiUrl); Log(应用程序已启动。请配置正确的API服务器地址。); } private void Log(string message) { Dispatcher.Invoke(() { LogTextBox.AppendText($[{DateTime.Now:HH:mm:ss}] {message}\n); LogTextBox.ScrollToEnd(); }); } private async void GenerateButton_Click(object sender, RoutedEventArgs e) { if (_isGenerating) { MessageBox.Show(当前已有任务正在运行请等待完成或取消。); return; } // 1. 从界面获取参数 var request new ImageGenerationRequest { Prompt PromptTextBox.Text.Trim(), Width int.TryParse(WidthTextBox.Text, out int w) ? w : 512, Height int.TryParse(HeightTextBox.Text, out int h) ? h : 512, NumImages int.TryParse(NumImagesTextBox.Text, out int n) ? n : 1, // 可以在这里添加更多从界面获取的参数 }; if (string.IsNullOrWhiteSpace(request.Prompt)) { MessageBox.Show(提示词不能为空); return; } // 2. 更新UI状态 _isGenerating true; GenerateButton.IsEnabled false; CancelButton.IsEnabled true; GeneratedImage.Source null; // 清空上一张图片 Log($开始生成图像: \{request.Prompt}\ (尺寸: {request.Width}x{request.Height})); // 3. 创建进度报告器 var progress new Progressstring(msg Log(msg)); try { // 4. 调用服务异步生成 var imageDataList await _generationService.GenerateImagesAsync(request, progress); // 5. 处理结果 if (imageDataList ! null imageDataList.Count 0) { // 显示第一张图片 using (var ms new MemoryStream(imageDataList[0])) { var bitmap new BitmapImage(); bitmap.BeginInit(); bitmap.CacheOption BitmapCacheOption.OnLoad; bitmap.StreamSource ms; bitmap.EndInit(); bitmap.Freeze(); // 跨线程使用需要Freeze GeneratedImage.Source bitmap; } Log($成功生成并显示了 {imageDataList.Count} 张图像。); // 可以扩展功能保存所有图片到本地 } else { Log(图像生成失败未收到有效数据。); } } finally { // 6. 恢复UI状态 _isGenerating false; GenerateButton.IsEnabled true; CancelButton.IsEnabled false; Log(当前任务结束。); } } private void CancelButton_Click(object sender, RoutedEventArgs e) { _generationService.CancelCurrentGeneration(); Log(已发送取消请求。); } } }这段代码完成了以下工作收集参数从文本框等控件中获取用户输入的提示词和参数。状态管理在生成期间禁用生成按钮启用取消按钮防止重复提交。异步调用使用async/await调用我们的GenerateImagesAsync方法并传入一个IProgressstring来实时更新日志框。这确保了UI线程不会被阻塞应用在生成过程中依然可以响应。结果处理将API返回的字节数组转换成WPF的BitmapImage并设置为Image控件的源从而在界面上显示出来。异常与取消妥善处理可能发生的异常和用户取消操作。5. 总结与扩展思路通过以上步骤我们成功构建了一个能够集成“造相Z-Turbo”模型的.NET桌面应用原型。这个应用虽然界面简单但涵盖了桌面应用集成AI模型的核心流程友好的参数输入、稳定的网络通信、异步后台处理以及直观的结果展示。在实际使用中你可能会发现一些可以增强的地方。比如增加一个配置窗口来设置API服务器地址和密钥实现一个图片列表来展示批量生成的所有结果而不仅仅是第一张添加图片保存到本地、历史记录查看、参数预设模板等功能。还可以引入更高级的MVVM框架如Prism、MVVM Toolkit来更好地分离界面和业务逻辑让代码更易于维护和测试。这种将云端或本地AI能力“拉近”到用户日常办公环境中的模式对于很多团队来说非常实用。它降低了使用门槛将AI变成了一个随手可用的工具。希望这个基于.NET的实例能为你打开一扇门你可以根据具体的业务需求定制出更强大、更专业的AI赋能桌面应用。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。
