feat: 项目初始化 + 3D方块世界原型 + AI助搭系统

初始化 monorepo: Go后端(7微服务) + Unity客户端(9模块) + 启动器

HTML5原型: Three.js 3D体素世界, Perlin噪声地形, 原版材质, 22种方块

Minecraft创造模式背包: 双栏布局, 拖拽移动物品, 方向性元件引脚

AI助搭策划文档 + 客户端/服务端骨架 + Docker Compose + CI

launcher/PCL-CE/PCL.Core/UI/ImageLoaderHelper.cs

@@ -0,0 +1,160 @@
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using System.Windows.Controls;
+using System.Windows.Media.Imaging;
+
+namespace PCL.Core.UI;
+
+/// <summary>
+/// 图像加载帮助类，提供通用的图像加载功能
+/// </summary>
+public static class ImageLoaderHelper {
+    /// <summary>
+    /// 异步设置服务器图标
+    /// </summary>
+    /// <param name="base64String">Base64 图像字符串</param>
+    /// <param name="imageElement">目标 Image 控件</param>
+    /// <param name="defaultImageUri">默认图像 URI，如果为 null 则使用内置默认图标</param>
+    /// <returns></returns>
+    public static async Task SetServerLogoAsync(string base64String, Image imageElement, string? defaultImageUri = null) {
+        await SetImageFromBase64Async(base64String, imageElement, 
+            defaultImageUri ?? "pack://application:,,,/Plain Craft Launcher 2;component/Images/Icons/DefaultServer.png");
+    }
+
+    /// <summary>
+    /// 通用的 Base64 图像加载方法
+    /// </summary>
+    /// <param name="base64String">Base64 图像字符串</param>
+    /// <param name="imageElement">目标 Image 控件</param>
+    /// <param name="fallbackImageUri">加载失败时的后备图像 URI</param>
+    /// <returns></returns>
+    public static async Task SetImageFromBase64Async(
+        string base64String, 
+        Image imageElement, 
+        string? fallbackImageUri = null) {
+        ArgumentNullException.ThrowIfNull(nameof(imageElement));
+        
+        if (string.IsNullOrWhiteSpace(base64String)) {
+            SetFallbackImage(imageElement, fallbackImageUri);
+            return;
+        }
+
+        try {
+            // 提取 Base64 数据部分
+            var base64Data = base64String.Contains(',') 
+                ? base64String.Split(',')[1] 
+                : base64String;
+
+            // 验证 Base64 字符串
+            if (string.IsNullOrWhiteSpace(base64Data)) {
+                SetFallbackImage(imageElement, fallbackImageUri);
+                return;
+            }
+
+            // 异步转换图像
+            var bitmapImage = await Task.Run(() => _CreateBitmapFromBase64(base64Data));
+            
+            // 在 UI 线程上设置图像
+            if (imageElement.Dispatcher.CheckAccess()) {
+                imageElement.Source = bitmapImage;
+            } else {
+                await imageElement.Dispatcher.InvokeAsync(() => imageElement.Source = bitmapImage);
+            }
+        } catch {
+            SetFallbackImage(imageElement, fallbackImageUri);
+        }
+    }
+
+    /// <summary>
+    /// 从 Base64 字符串创建 BitmapImage
+    /// </summary>
+    /// <param name="base64Data">Base64 数据</param>
+    /// <returns>BitmapImage 对象</returns>
+    private static BitmapImage _CreateBitmapFromBase64(string base64Data) {
+        var imageBytes = Convert.FromBase64String(base64Data);
+        
+        using var ms = new MemoryStream(imageBytes);
+        var bitmap = new BitmapImage();
+        bitmap.BeginInit();
+        bitmap.CacheOption = BitmapCacheOption.OnLoad;
+        bitmap.StreamSource = ms;
+        bitmap.EndInit();
+        bitmap.Freeze(); // 确保跨线程安全
+        
+        return bitmap;
+    }
+
+    /// <summary>
+    /// 设置后备图像
+    /// </summary>
+    /// <param name="imageElement">目标 Image 控件</param>
+    /// <param name="fallbackImageUri">后备图像 URI</param>
+    public static void SetFallbackImage(Image imageElement, string? fallbackImageUri) {
+        try {
+            if (!string.IsNullOrWhiteSpace(fallbackImageUri)) {
+                var defaultBitmap = new BitmapImage(new Uri(fallbackImageUri));
+                if (imageElement.Dispatcher.CheckAccess()) {
+                    imageElement.Source = defaultBitmap;
+                } else {
+                    imageElement.Dispatcher.Invoke(() => imageElement.Source = defaultBitmap);
+                }
+            } else {
+                // 如果没有提供后备图像，则清空 Source
+                if (imageElement.Dispatcher.CheckAccess()) {
+                    imageElement.Source = null;
+                }
+                else {
+                    imageElement.Dispatcher.Invoke(() => imageElement.Source = null);
+                }
+            }
+        } catch {
+            // 处理后备图像加载失败的情况
+            if (imageElement.Dispatcher.CheckAccess()) {
+                imageElement.Source = null;
+            } else {
+                imageElement.Dispatcher.Invoke(() => imageElement.Source = null);
+            }
+        }
+    }
+
+    /// <summary>
+    /// 从文件路径异步加载图像
+    /// </summary>
+    /// <param name="imagePath">图像文件路径</param>
+    /// <param name="imageElement">目标 Image 控件</param>
+    /// <param name="fallbackImageUri">后备图像 URI</param>
+    /// <returns></returns>
+    public static async Task SetImageFromFileAsync(
+        string imagePath,
+        Image imageElement,
+        string fallbackImageUri) {
+        ArgumentNullException.ThrowIfNull(nameof(imageElement));
+
+        if (string.IsNullOrWhiteSpace(imagePath) || !File.Exists(imagePath)) {
+            SetFallbackImage(imageElement, fallbackImageUri);
+            return;
+        }
+
+        try {
+            var bitmapImage = await Task.Run(() =>
+            {
+                var bitmap = new BitmapImage();
+                bitmap.BeginInit();
+                bitmap.CacheOption = BitmapCacheOption.OnLoad;
+                bitmap.UriSource = new Uri(imagePath);
+                bitmap.EndInit();
+                bitmap.Freeze();
+                return bitmap;
+            });
+
+            if (imageElement.Dispatcher.CheckAccess()) {
+                imageElement.Source = bitmapImage;
+            } else {
+                await imageElement.Dispatcher.InvokeAsync(() => imageElement.Source = bitmapImage);
+            }
+        } catch {
+            SetFallbackImage(imageElement, fallbackImageUri);
+        }
+    }
+}