Merged PR 20: XP.Common及Feature/XP.Hardware合并至Develop/XP

将Feature/XP.Common和Feature/XP.Hardware分支整合为Develop/XP.forHardwareAndCommon，申请合并至Develop/XP，除了合并外，还完善Develop/XP对通用类库和硬件类库的注册和界面及功能整合。

XP.Common/Configs/SerilogConfig.cs

@@ -0,0 +1,43 @@
+using System;
+using System.IO;
+
+namespace XP.Common.Configs
+{
+    /// <summary>
+    /// Serilog日志配置实体（从App.config读取）
+    /// </summary>
+    public class SerilogConfig
+    {
+        /// <summary>
+        /// 日志输出根路径（默认：AppData/Files/Logs）
+        /// </summary>
+        public string LogPath { get; set; } = Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
+            "Files", "Logs");
+
+        /// <summary>
+        /// 最低日志级别（Debug/Info/Warn/Error/Fatal）
+        /// </summary>
+        public string MinimumLevel { get; set; } = "Info";
+
+        /// <summary>
+        /// 是否输出到控制台（调试环境=true，生产环境=false）
+        /// </summary>
+        public bool EnableConsole { get; set; } = true;
+
+        /// <summary>
+        /// 日志文件分割规则（Day/Month/Hour/Size）
+        /// </summary>
+        public string RollingInterval { get; set; } = "Day";
+
+        /// <summary>
+        /// 单个日志文件最大大小（MB，仅Size分割时生效）
+        /// </summary>
+        public long FileSizeLimitMB { get; set; } = 100;
+
+        /// <summary>
+        /// 保留日志文件数量（默认30天）
+        /// </summary>
+        public int RetainedFileCountLimit { get; set; } = 30;
+    }
+}

XP.Common/Configs/SqliteConfig.cs

@@ -0,0 +1,56 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Configs
+{
+    /// <summary>
+    /// SQLite 配置实体
+    /// </summary>
+    public class SqliteConfig
+    {
+        /// <summary>
+        /// 数据库文件路径
+        /// </summary>
+        public string DbFilePath { get; set; } = Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
+            "Files", "Data", "XP.db");
+
+        /// <summary>
+        /// 连接超时时间（秒，默认30）
+        /// </summary>
+        public int ConnectionTimeout { get; set; } = 30;
+
+        /// <summary>
+        /// 数据库不存在时是否自动创建（默认true）
+        /// </summary>
+        public bool CreateIfNotExists { get; set; } = true;
+
+        /// <summary>
+        /// 是否启用 WAL 模式（提升并发性能，默认true）
+        /// </summary>
+        public bool EnableWalMode { get; set; } = true;
+
+        /// <summary>
+        /// 是否开启日志记录（记录所有SQL操作，默认false）
+        /// </summary>
+        public bool EnableSqlLogging { get; set; } = false;
+
+        /// <summary>
+        /// 获取SQLite连接字符串
+        /// </summary>
+        public string GetConnectionString()
+        {
+            var builder = new Microsoft.Data.Sqlite.SqliteConnectionStringBuilder
+            {
+                DataSource = DbFilePath,
+                Cache = Microsoft.Data.Sqlite.SqliteCacheMode.Default,
+                DefaultTimeout = ConnectionTimeout
+            };
+            return builder.ToString();
+        }
+    }
+}

XP.Common/Converters/ImageConverter.cs

@@ -0,0 +1,68 @@
+using System;
+using System.Runtime.InteropServices;
+using System.Windows.Media;
+using System.Windows.Media.Imaging;
+using Emgu.CV;
+using Emgu.CV.CvEnum;
+
+namespace XP.Common.Converters
+{
+    /// <summary>
+    /// 图像数据转换工具类，基于 Emgu CV 实现
+    /// </summary>
+    public static class ImageConverter
+    {
+        /// <summary>
+        /// 将 16 位无符号灰度数据转换为 RGB BitmapSource
+        /// 使用 Emgu CV 的 Normalize 进行线性拉伸，CvtColor 转 BGR
+        /// </summary>
+        /// <param name="data">16 位灰度原始数据</param>
+        /// <param name="width">图像宽度</param>
+        /// <param name="height">图像高度</param>
+        /// <returns>BGR24 格式的 BitmapSource</returns>
+        public static BitmapSource ConvertGray16ToBitmapSource(ushort[] data, int width, int height)
+        {
+            if (data == null) throw new ArgumentNullException(nameof(data));
+            if (width <= 0 || height <= 0) throw new ArgumentException("图像尺寸无效");
+
+            // 从 ushort[] 按字节拷贝构建 16 位灰度 Mat
+            using var mat16 = new Mat(height, width, DepthType.Cv16U, 1);
+            int byteCount = data.Length * sizeof(ushort);
+            unsafe
+            {
+                fixed (ushort* pData = data)
+                {
+                    Buffer.MemoryCopy(pData, mat16.DataPointer.ToPointer(), byteCount, byteCount);
+                }
+            }
+
+            // 归一化到 0~255 并转为 8 位
+            using var mat8 = new Mat();
+            CvInvoke.Normalize(mat16, mat8, 0, 255, NormType.MinMax, DepthType.Cv8U);
+
+            // 灰度转 BGR（立式 CT 显示需要 RGB 格式）
+            using var matBgr = new Mat();
+            CvInvoke.CvtColor(mat8, matBgr, ColorConversion.Gray2Bgr);
+
+            // Mat 转 BitmapSource
+            return MatToBitmapSource(matBgr);
+        }
+
+        /// <summary>
+        /// 将 Emgu CV Mat 转换为 WPF BitmapSource
+        /// </summary>
+        private static BitmapSource MatToBitmapSource(Mat mat)
+        {
+            int width = mat.Width;
+            int height = mat.Height;
+            int channels = mat.NumberOfChannels;
+            int stride = mat.Step;
+
+            byte[] pixels = new byte[height * stride];
+            Marshal.Copy(mat.DataPointer, pixels, 0, pixels.Length);
+
+            var format = channels == 3 ? PixelFormats.Bgr24 : PixelFormats.Gray8;
+            return BitmapSource.Create(width, height, 96, 96, format, null, pixels, stride);
+        }
+    }
+}

XP.Common/Database/Helpers/PaginationHelper.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using XP.Common.Database.Models;
+
+namespace XP.Common.Database.Helpers
+{
+    /// <summary>
+    /// 分页计算辅助工具
+    /// </summary>
+    public static class PaginationHelper
+    {
+        /// <summary>
+        /// 计算分页偏移量（SQLite OFFSET）
+        /// </summary>
+        public static int CalculateOffset(PaginationRequest pagination)
+        {
+            if (pagination.PageIndex < 1) pagination.PageIndex = 1;
+            if (pagination.PageSize < 1) pagination.PageSize = 20;
+            return (pagination.PageIndex - 1) * pagination.PageSize;
+        }
+
+        /// <summary>
+        /// 验证并修正分页参数
+        /// </summary>
+        public static PaginationRequest ValidateAndFix(PaginationRequest pagination)
+        {
+            var fixedPagination = new PaginationRequest
+            {
+                PageIndex = pagination.PageIndex < 1 ? 1 : pagination.PageIndex,
+                PageSize = pagination.PageSize < 1 ? 20 : (pagination.PageSize > 1000 ? 1000 : pagination.PageSize),
+                OrderBy = pagination.OrderBy ?? string.Empty
+            };
+            return fixedPagination;
+        }
+    }
+}

XP.Common/Database/Helpers/SqlBuilderHelper.cs

@@ -0,0 +1,92 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Database.Helpers
+{
+    /// <summary>
+    /// 通用CRUD SQL构建器（适配SQLite）
+    /// </summary>
+    public static class SqlBuilderHelper
+    {
+        /// <summary>
+        /// 构建插入SQL
+        /// </summary>
+        /// <param name="tableName">表名</param>
+        /// <param name="columns">列名集合</param>
+        /// <returns>插入SQL（参数名：@列名）</returns>
+        public static string BuildInsertSql(string tableName, IEnumerable<string> columns)
+        {
+            if (string.IsNullOrEmpty(tableName)) throw new ArgumentNullException(nameof(tableName));
+            var columnList = columns?.ToList() ?? throw new ArgumentNullException(nameof(columns));
+            if (columnList.Count == 0) throw new ArgumentException("列名集合不能为空");
+
+            var columnsStr = string.Join(", ", columnList);
+            var paramsStr = string.Join(", ", columnList.Select(c => $"@{c}"));
+            return $"INSERT INTO {tableName} ({columnsStr}) VALUES ({paramsStr})";
+        }
+
+        /// <summary>
+        /// 构建更新SQL
+        /// </summary>
+        /// <param name="tableName">表名</param>
+        /// <param name="updateColumns">更新列名</param>
+        /// <param name="whereColumns">条件列名（如Id）</param>
+        /// <returns>更新SQL</returns>
+        public static string BuildUpdateSql(string tableName, IEnumerable<string> updateColumns, IEnumerable<string> whereColumns)
+        {
+            if (string.IsNullOrEmpty(tableName)) throw new ArgumentNullException(nameof(tableName));
+            var updateList = updateColumns?.ToList() ?? throw new ArgumentNullException(nameof(updateColumns));
+            var whereList = whereColumns?.ToList() ?? throw new ArgumentNullException(nameof(whereColumns));
+            if (updateList.Count == 0) throw new ArgumentException("更新列名集合不能为空");
+            if (whereList.Count == 0) throw new ArgumentException("条件列名集合不能为空");
+
+            var updateStr = string.Join(", ", updateList.Select(c => $"{c}=@{c}"));
+            var whereStr = string.Join(" AND ", whereList.Select(c => $"{c}=@{c}"));
+            return $"UPDATE {tableName} SET {updateStr} WHERE {whereStr}";
+        }
+
+        /// <summary>
+        /// 构建删除SQL
+        /// </summary>
+        public static string BuildDeleteSql(string tableName, IEnumerable<string> whereColumns)
+        {
+            if (string.IsNullOrEmpty(tableName)) throw new ArgumentNullException(nameof(tableName));
+            var whereList = whereColumns?.ToList() ?? throw new ArgumentNullException(nameof(whereColumns));
+            if (whereList.Count == 0) throw new ArgumentException("条件列名集合不能为空");
+
+            var whereStr = string.Join(" AND ", whereList.Select(c => $"{c}=@{c}"));
+            return $"DELETE FROM {tableName} WHERE {whereStr}";
+        }
+
+        /// <summary>
+        /// 构建查询SQL
+        /// </summary>
+        public static string BuildSelectSql(string tableName, IEnumerable<string> columns, IEnumerable<string>? whereColumns = null, string orderBy = "")
+        {
+            if (string.IsNullOrEmpty(tableName)) throw new ArgumentNullException(nameof(tableName));
+            var columnList = columns?.ToList() ?? throw new ArgumentNullException(nameof(columns));
+            if (columnList.Count == 0) columnList.Add("*");
+
+            var columnsStr = string.Join(", ", columnList);
+            var sql = new StringBuilder($"SELECT {columnsStr} FROM {tableName}");
+
+            // 添加WHERE条件
+            if (whereColumns != null && whereColumns.Any())
+            {
+                var whereStr = string.Join(" AND ", whereColumns.Select(c => $"{c}=@{c}"));
+                sql.Append($" WHERE {whereStr}");
+            }
+
+            // 添加排序
+            if (!string.IsNullOrEmpty(orderBy))
+            {
+                sql.Append($" ORDER BY {orderBy}");
+            }
+
+            return sql.ToString();
+        }
+    }
+}

XP.Common/Database/Helpers/SqliteParameterHelper.cs

@@ -0,0 +1,48 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Database.Helpers
+{
+    /// <summary>
+    /// SQLite参数化查询辅助工具
+    /// </summary>
+    public static class SqliteParameterHelper
+    {
+        /// <summary>
+        /// 创建参数字典
+        /// </summary>
+        /// <param name="keyValues">参数名-值对（如 ("Id", 1), ("Name", "Test")）</param>
+        /// <returns>参数字典</returns>
+        public static Dictionary<string, object> CreateParameters(params (string Key, object Value)[] keyValues)
+        {
+            var parameters = new Dictionary<string, object>();
+            foreach (var (key, value) in keyValues)
+            {
+                parameters.Add(key, value);
+            }
+            return parameters;
+        }
+
+        /// <summary>
+        /// 合并参数字典
+        /// </summary>
+        public static Dictionary<string, object> MergeParameters(params Dictionary<string, object>[] paramLists)
+        {
+            var merged = new Dictionary<string, object>();
+            foreach (var paramList in paramLists)
+            {
+                foreach (var (key, value) in paramList)
+                {
+                    if (!merged.ContainsKey(key))
+                    {
+                        merged.Add(key, value);
+                    }
+                }
+            }
+            return merged;
+        }
+    }
+}

XP.Common/Database/Implementations/DbExecuteResult.cs

@@ -0,0 +1,47 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using XP.Common.Database.Interfaces;
+
+namespace XP.Common.Database.Implementations
+{
+    /// <summary>
+    /// 数据库操作执行结果实体
+    /// </summary>
+    public class DbExecuteResult : IDbExecuteResult
+    {
+        public bool IsSuccess { get; set; }
+        public int RowsAffected { get; set; }
+        public string Message { get; set; } = string.Empty;
+        public Exception? Exception { get; set; }
+
+        /// <summary>
+        /// 快速创建成功结果
+        /// </summary>
+        public static DbExecuteResult Success(string message = "执行成功", int rowsAffected = 0)
+        {
+            return new DbExecuteResult
+            {
+                IsSuccess = true,
+                Message = message,
+                RowsAffected = rowsAffected
+            };
+        }
+
+        /// <summary>
+        /// 快速创建失败结果
+        /// </summary>
+        public static DbExecuteResult Fail(string message, Exception? ex = null, int rowsAffected = 0)
+        {
+            return new DbExecuteResult
+            {
+                IsSuccess = false,
+                Message = message,
+                Exception = ex,
+                RowsAffected = rowsAffected
+            };
+        }
+    }
+}

XP.Common/Database/Implementations/SqliteContext.cs

@@ -0,0 +1,527 @@
+using Microsoft.Data.Sqlite;
+using System;
+using System.Collections.Generic;
+using System.Data;
+using System.IO;
+using System.Linq;
+using System.Reflection;
+using System.Text;
+using System.Threading.Tasks;
+using XP.Common.Configs;
+using XP.Common.Database.Interfaces;
+using XP.Common.Database.Models;
+using XP.Common.Helpers;
+using XP.Common.Logging.Interfaces;
+
+using CustomDbTransaction = XP.Common.Database.Interfaces.IDbTransaction;
+
+namespace XP.Common.Database.Implementations
+{
+    /// <summary>
+    /// SQLite 核心操作实现（适配IDbContext）
+    /// </summary>
+    public class SqliteContext : IDbContext
+    {
+        private readonly SqliteConfig _config;
+        private readonly ILoggerService _logger;
+        private SqliteConnection? _connection;
+        private bool _isDisposed = false;
+
+        /// <summary>
+        /// 构造函数（DI注入配置+日志）
+        /// </summary>
+        public SqliteContext(SqliteConfig config, ILoggerService logger)
+        {
+            _config = config ?? throw new ArgumentNullException(nameof(config));
+            _logger = logger.ForModule("Sqlite.Context");
+
+            // 自动创建数据库目录
+            if (_config.CreateIfNotExists)
+            {
+                var dbDir = Path.GetDirectoryName(_config.DbFilePath);
+                if (!string.IsNullOrEmpty(dbDir) && !Directory.Exists(dbDir))
+                {
+                    Directory.CreateDirectory(dbDir);
+                    _logger.Info("自动创建数据库目录：{DirPath}", dbDir);
+                }
+            }
+        }
+
+        #region 连接管理
+        public IDbExecuteResult OpenConnection()
+        {
+            try
+            {
+                if (_connection != null && _connection.State == ConnectionState.Open)
+                {
+                    return DbExecuteResult.Success("连接已打开");
+                }
+
+                _connection = new SqliteConnection(_config.GetConnectionString());
+                _connection.Open();
+                _logger.Debug("SQLite连接已打开：{DbPath}", _config.DbFilePath);
+
+                // 启用WAL模式提升性能
+                if (_config.EnableWalMode)
+                {
+                    using var cmd = new SqliteCommand("PRAGMA journal_mode=WAL;", _connection);
+                    cmd.ExecuteNonQuery();
+                    _logger.Debug("SQLite已启用WAL模式");
+                }
+
+                return DbExecuteResult.Success("连接打开成功");
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQLite连接打开失败：{DbPath}", _config.DbFilePath);
+                return DbExecuteResult.Fail("连接打开失败", ex);
+            }
+        }
+
+        public async Task<IDbExecuteResult> OpenConnectionAsync()
+        {
+            try
+            {
+                if (_connection != null && _connection.State == ConnectionState.Open)
+                {
+                    return DbExecuteResult.Success("连接已打开");
+                }
+
+                _connection = new SqliteConnection(_config.GetConnectionString());
+                await _connection.OpenAsync();
+                _logger.Debug("SQLite连接已异步打开：{DbPath}", _config.DbFilePath);
+
+                if (_config.EnableWalMode)
+                {
+                    using var cmd = new SqliteCommand("PRAGMA journal_mode=WAL;", _connection);
+                    await cmd.ExecuteNonQueryAsync();
+                }
+
+                return DbExecuteResult.Success("连接异步打开成功");
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQLite连接异步打开失败：{DbPath}", _config.DbFilePath);
+                return DbExecuteResult.Fail("连接异步打开失败", ex);
+            }
+        }
+
+        /// <summary>
+        /// 获取有效连接（自动打开）
+        /// </summary>
+        private SqliteConnection GetValidConnection()
+        {
+            if (_connection == null || _connection.State != ConnectionState.Open)
+            {
+                var result = OpenConnection();
+                if (!result.IsSuccess)
+                {
+                    throw new InvalidOperationException($"获取SQLite连接失败：{result.Message}");
+                }
+            }
+            return _connection!;
+        }
+        #endregion
+
+        #region 事务管理
+        public (IDbExecuteResult Result, CustomDbTransaction? Transaction) BeginTransaction()
+        {
+            try
+            {
+                var conn = GetValidConnection();
+                // 系统的SqliteTransaction
+                var innerSystemTrans = conn.BeginTransaction();
+                // 封装为自定义的SqliteTransaction
+                var customTrans = new SqliteTransaction(innerSystemTrans, _logger);
+                _logger.Debug("SQLite事务已开始");
+                // 返回：自定义IDbTransaction（解决返回类型不匹配）
+                return (DbExecuteResult.Success("事务开始成功"), customTrans);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQLite事务开始失败");
+                return (DbExecuteResult.Fail("事务开始失败", ex), null);
+            }
+        }
+        #endregion
+
+        #region 通用SQL执行
+        public IDbExecuteResult ExecuteNonQuery(string sql, Dictionary<string, object>? parameters = null)
+        {
+            try
+            {
+                LogSql(sql, parameters);
+                using var cmd = CreateCommand(sql, parameters);
+                var rowsAffected = cmd.ExecuteNonQuery();
+                _logger.Debug("SQL执行成功，影响行数：{Rows}", rowsAffected);
+                return DbExecuteResult.Success("执行成功", rowsAffected);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL执行失败：{Sql}", sql);
+                return DbExecuteResult.Fail("执行失败", ex);
+            }
+        }
+
+        public async Task<IDbExecuteResult> ExecuteNonQueryAsync(string sql, Dictionary<string, object>? parameters = null)
+        {
+            try
+            {
+                LogSql(sql, parameters);
+                using var cmd = CreateCommand(sql, parameters);
+                var rowsAffected = await cmd.ExecuteNonQueryAsync();
+                _logger.Debug("SQL异步执行成功，影响行数：{Rows}", rowsAffected);
+                return DbExecuteResult.Success("异步执行成功", (int)rowsAffected);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL异步执行失败：{Sql}", sql);
+                return DbExecuteResult.Fail("异步执行失败", ex);
+            }
+        }
+
+        public (IDbExecuteResult Result, T? Value) ExecuteScalar<T>(string sql, Dictionary<string, object>? parameters = null)
+        {
+            try
+            {
+                LogSql(sql, parameters);
+                using var cmd = CreateCommand(sql, parameters);
+                var resultObj = cmd.ExecuteScalar();
+                T? value = default;
+                if (resultObj != null && resultObj != DBNull.Value)
+                {
+                    if (resultObj is T directValue)
+                    {
+                        value = directValue;
+                    }
+                    else
+                    {
+                        // 类型不匹配时安全转换，处理值类型/引用类型
+                        value = (T)Convert.ChangeType(resultObj, Nullable.GetUnderlyingType(typeof(T)) ?? typeof(T));
+                    }
+                }
+                var logValue = value ?? (object)"null";
+                _logger.Debug("SQL标量查询成功，返回值：{Value}", logValue);
+                return (DbExecuteResult.Success("标量查询成功"), value);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL标量查询失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("标量查询失败", ex), default);
+            }
+        }
+
+        public async Task<(IDbExecuteResult Result, T? Value)> ExecuteScalarAsync<T>(string sql, Dictionary<string, object>? parameters = null)
+        {
+            try
+            {
+                LogSql(sql, parameters);
+                using var cmd = CreateCommand(sql, parameters);
+                var resultObj = await cmd.ExecuteScalarAsync();
+                T? value = default;
+                if (resultObj != null && resultObj != DBNull.Value)
+                {
+                    if (resultObj is T directValue)
+                    {
+                        value = directValue;
+                    }
+                    else
+                    {
+                        // 类型不匹配时安全转换，处理值类型/引用类型
+                        value = (T)Convert.ChangeType(resultObj, Nullable.GetUnderlyingType(typeof(T)) ?? typeof(T));
+                    }
+                }
+                var logValue = value ?? (object)"null";
+                _logger.Debug("SQL异步标量查询成功，返回值：{Value}", logValue);
+                return (DbExecuteResult.Success("异步标量查询成功"), value);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL异步标量查询失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("异步标量查询失败", ex), default);
+            }
+        }
+        #endregion
+
+        #region 查询结果映射
+        public (IDbExecuteResult Result, DataTable? Data) ExecuteDataTable(string sql, Dictionary<string, object>? parameters = null)
+        {
+            try
+            {
+                LogSql(sql, parameters);
+                using var cmd = CreateCommand(sql, parameters);
+                using var reader = cmd.ExecuteReader();
+
+                var dt = new DataTable();
+                // 添加列
+                for (int i = 0; i < reader.FieldCount; i++)
+                {
+                    dt.Columns.Add(reader.GetName(i), reader.GetFieldType(i));
+                }
+                // 添加行
+                while (reader.Read())
+                {
+                    var row = dt.NewRow();
+                    for (int i = 0; i < reader.FieldCount; i++)
+                    {
+                        row[i] = reader.IsDBNull(i) ? DBNull.Value : reader.GetValue(i);
+                    }
+                    dt.Rows.Add(row);
+                }
+
+                _logger.Debug("SQL查询成功，返回DataTable行数：{Rows}", dt.Rows.Count);
+                return (DbExecuteResult.Success("查询成功"), dt);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL查询DataTable失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("查询失败", ex), null);
+            }
+        }
+
+        public async Task<(IDbExecuteResult Result, DataTable? Data)> ExecuteDataTableAsync(string sql, Dictionary<string, object>? parameters = null)
+        {
+            try
+            {
+                LogSql(sql, parameters);
+                using var cmd = CreateCommand(sql, parameters);
+                using var reader = await cmd.ExecuteReaderAsync();
+
+                var dt = new DataTable();
+                // 添加列
+                for (int i = 0; i < reader.FieldCount; i++)
+                {
+                    dt.Columns.Add(reader.GetName(i), reader.GetFieldType(i));
+                }
+                // 添加行（异步读取）
+                while (await reader.ReadAsync())
+                {
+                    var row = dt.NewRow();
+                    for (int i = 0; i < reader.FieldCount; i++)
+                    {
+                        row[i] = await reader.IsDBNullAsync(i) ? DBNull.Value : reader.GetValue(i);
+                    }
+                    dt.Rows.Add(row);
+                }
+                _logger.Debug("SQL异步查询成功，返回DataTable行数：{Rows}", dt.Rows.Count);
+                return (DbExecuteResult.Success("异步查询成功"), dt);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL异步查询DataTable失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("异步查询失败", ex), null);
+            }
+        }
+
+        public (IDbExecuteResult Result, List<T> Data) QueryList<T>(string sql, Dictionary<string, object>? parameters = null) where T : new()
+        {
+            try
+            {
+                var (result, dt) = ExecuteDataTable(sql, parameters);
+                if (!result.IsSuccess || dt == null)
+                {
+                    return (result, new List<T>());
+                }
+
+                var list = MapDataTableToEntityList<T>(dt);
+                return (DbExecuteResult.Success("实体列表查询成功"), list);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL查询实体列表失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("实体列表查询失败", ex), new List<T>());
+            }
+        }
+
+        public async Task<(IDbExecuteResult Result, List<T> Data)> QueryListAsync<T>(string sql, Dictionary<string, object>? parameters = null) where T : new()
+        {
+            try
+            {
+                var (result, dt) = await ExecuteDataTableAsync(sql, parameters);
+                if (!result.IsSuccess || dt == null)
+                {
+                    return (result, new List<T>());
+                }
+
+                var list = MapDataTableToEntityList<T>(dt);
+                return (DbExecuteResult.Success("异步实体列表查询成功"), list);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL异步查询实体列表失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("异步实体列表查询失败", ex), new List<T>());
+            }
+        }
+        #endregion
+
+        #region 分页查询
+        public (IDbExecuteResult Result, PaginationResponse<T> Data) QueryPaged<T>(string sql, PaginationRequest pagination, Dictionary<string, object>? parameters = null) where T : new()
+        {
+            try
+            {
+                // 1. 查询总条数
+                var countSql = $"SELECT COUNT(*) FROM ({sql}) AS TotalCountQuery";
+                var (countResult, totalCount) = ExecuteScalar<int>(countSql, parameters);
+                if (!countResult.IsSuccess)
+                {
+                    return (countResult, new PaginationResponse<T>());
+                }
+
+                // 2. 构建分页SQL（SQLite分页：LIMIT/OFFSET）
+                var offset = (pagination.PageIndex - 1) * pagination.PageSize;
+                var pagedSql = $"{sql} {(!string.IsNullOrEmpty(pagination.OrderBy) ? $"ORDER BY {pagination.OrderBy}" : "")} LIMIT {pagination.PageSize} OFFSET {offset}";
+
+                // 3. 查询当前页数据
+                var (dataResult, list) = QueryList<T>(pagedSql, parameters);
+                if (!dataResult.IsSuccess)
+                {
+                    return (dataResult, new PaginationResponse<T>());
+                }
+
+                // 4. 封装分页结果
+                var pagedResponse = new PaginationResponse<T>
+                {
+                    PageIndex = pagination.PageIndex,
+                    PageSize = pagination.PageSize,
+                    TotalCount = totalCount,
+                    Data = list
+                };
+
+                _logger.Debug("SQL分页查询成功：页码{Page}，条数{Size}，总条数{Total}",
+                    pagination.PageIndex, pagination.PageSize, totalCount);
+                return (DbExecuteResult.Success("分页查询成功"), pagedResponse);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL分页查询失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("分页查询失败", ex), new PaginationResponse<T>());
+            }
+        }
+
+        public async Task<(IDbExecuteResult Result, PaginationResponse<T> Data)> QueryPagedAsync<T>(string sql, PaginationRequest pagination, Dictionary<string, object>? parameters = null) where T : new()
+        {
+            try
+            {
+                // 1. 查询总条数
+                var countSql = $"SELECT COUNT(*) FROM ({sql}) AS TotalCountQuery";
+                var (countResult, totalCount) = await ExecuteScalarAsync<int>(countSql, parameters);
+                if (!countResult.IsSuccess)
+                {
+                    return (countResult, new PaginationResponse<T>());
+                }
+
+                // 2. 构建分页SQL
+                var offset = (pagination.PageIndex - 1) * pagination.PageSize;
+                var pagedSql = $"{sql} {(!string.IsNullOrEmpty(pagination.OrderBy) ? $"ORDER BY {pagination.OrderBy}" : "")} LIMIT {pagination.PageSize} OFFSET {offset}";
+
+                // 3. 查询当前页数据
+                var (dataResult, list) = await QueryListAsync<T>(pagedSql, parameters);
+                if (!dataResult.IsSuccess)
+                {
+                    return (dataResult, new PaginationResponse<T>());
+                }
+
+                // 4. 封装分页结果
+                var pagedResponse = new PaginationResponse<T>
+                {
+                    PageIndex = pagination.PageIndex,
+                    PageSize = pagination.PageSize,
+                    TotalCount = totalCount,
+                    Data = list
+                };
+
+                _logger.Debug("SQL异步分页查询成功：页码{Page}，条数{Size}，总条数{Total}",
+                    pagination.PageIndex, pagination.PageSize, totalCount);
+                return (DbExecuteResult.Success("异步分页查询成功"), pagedResponse);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQL异步分页查询失败：{Sql}", sql);
+                return (DbExecuteResult.Fail("异步分页查询失败", ex), new PaginationResponse<T>());
+            }
+        }
+        #endregion
+
+        #region 私有辅助方法
+        /// <summary>
+        /// 创建SQLite命令（带参数）
+        /// </summary>
+        private SqliteCommand CreateCommand(string sql, Dictionary<string, object>? parameters = null)
+        {
+            var cmd = new SqliteCommand(sql, GetValidConnection());
+            cmd.CommandTimeout = _config.ConnectionTimeout;
+
+            // 添加参数（防SQL注入）
+            if (parameters != null && parameters.Count > 0)
+            {
+                foreach (var (key, value) in parameters)
+                {
+                    var paramValue = value ?? DBNull.Value;
+                    cmd.Parameters.AddWithValue($"@{key}", paramValue);
+                }
+            }
+
+            return cmd;
+        }
+
+        /// <summary>
+        /// 记录SQL日志（调试模式）
+        /// </summary>
+        private void LogSql(string sql, Dictionary<string, object>? parameters = null)
+        {
+            if (!_config.EnableSqlLogging) return;
+
+            var paramStr = parameters == null
+                ? "无参数"
+                : string.Join(", ", parameters.Select(kv => $"{kv.Key}={kv.Value}"));
+            _logger.Debug("执行SQL：{Sql} | 参数：{Params}", sql, paramStr);
+        }
+
+        /// <summary>
+        /// DataTable映射为实体列表
+        /// </summary>
+        private List<T> MapDataTableToEntityList<T>(DataTable dt) where T : new()
+        {
+            var list = new List<T>();
+            var props = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);
+
+            foreach (DataRow row in dt.Rows)
+            {
+                var entity = new T();
+                foreach (var prop in props)
+                {
+                    if (dt.Columns.Contains(prop.Name) && row[prop.Name] != DBNull.Value)
+                    {
+                        var value = Convert.ChangeType(row[prop.Name], prop.PropertyType);
+                        prop.SetValue(entity, value);
+                    }
+                }
+                list.Add(entity);
+            }
+
+            return list;
+        }
+        #endregion
+
+        #region 资源释放
+        public void Dispose()
+        {
+            if (_isDisposed) return;
+
+            // 关闭连接
+            if (_connection != null)
+            {
+                if (_connection.State == ConnectionState.Open)
+                {
+                    _connection.Close();
+                    _logger.Debug("SQLite连接已关闭（Dispose）");
+                }
+                _connection.Dispose();
+            }
+
+            _isDisposed = true;
+            _logger.Debug("SQLiteContext资源已释放");
+        }
+        #endregion
+    }
+}

XP.Common/Database/Implementations/SqliteTransaction.cs

@@ -0,0 +1,65 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.Data.Sqlite;
+using XP.Common.Database.Interfaces;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.Database.Implementations
+{
+    /// <summary>
+    /// SQLite 事务实现
+    /// </summary>
+    public class SqliteTransaction : IDbTransaction
+    {
+        private readonly Microsoft.Data.Sqlite.SqliteTransaction _innerTransaction;
+        private readonly ILoggerService _logger;
+        private bool _isDisposed = false;
+
+        public SqliteTransaction(Microsoft.Data.Sqlite.SqliteTransaction innerTrans, ILoggerService logger)
+        {
+            _innerTransaction = innerTrans ?? throw new ArgumentNullException(nameof(innerTrans));
+            _logger = logger.ForModule("Sqlite.Transaction");
+        }
+
+        public IDbExecuteResult Commit()
+        {
+            try
+            {
+                _innerTransaction.Commit();
+                _logger.Debug("SQLite事务提交成功");
+                return DbExecuteResult.Success("事务提交成功");
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQLite事务提交失败");
+                return DbExecuteResult.Fail("事务提交失败", ex);
+            }
+        }
+
+        public IDbExecuteResult Rollback()
+        {
+            try
+            {
+                _innerTransaction.Rollback();
+                _logger.Debug("SQLite事务回滚成功");
+                return DbExecuteResult.Success("事务回滚成功");
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "SQLite事务回滚失败");
+                return DbExecuteResult.Fail("事务回滚失败", ex);
+            }
+        }
+
+        public void Dispose()
+        {
+            if (_isDisposed) return;
+            _innerTransaction.Dispose();
+            _isDisposed = true;
+            _logger.Debug("SQLite事务资源已释放");
+        }
+    }
+}

XP.Common/Database/Interfaces/IDbContext.cs

@@ -0,0 +1,88 @@
+using System;
+using System.Collections.Generic;
+using System.Data;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using XP.Common.Database.Models;
+
+namespace XP.Common.Database.Interfaces
+{
+    /// <summary>
+    /// 通用数据库操作接口（适配任意数据库，SQLite为具体实现）
+    /// </summary>
+    public interface IDbContext : IDisposable
+    {
+        /// <summary>
+        /// 打开数据库连接
+        /// </summary>
+        IDbExecuteResult OpenConnection();
+
+        /// <summary>
+        /// 异步打开数据库连接
+        /// </summary>
+        Task<IDbExecuteResult> OpenConnectionAsync();
+
+        /// <summary>
+        /// 开始事务
+        /// </summary>
+        (IDbExecuteResult Result, IDbTransaction? Transaction) BeginTransaction();
+
+        /// <summary>
+        /// 执行增删改SQL（无返回值）
+        /// </summary>
+        /// <param name="sql">SQL语句（参数化）</param>
+        /// <param name="parameters">参数集合（key=参数名，value=参数值）</param>
+        IDbExecuteResult ExecuteNonQuery(string sql, Dictionary<string, object>? parameters = null);
+
+        /// <summary>
+        /// 异步执行增删改SQL
+        /// </summary>
+        Task<IDbExecuteResult> ExecuteNonQueryAsync(string sql, Dictionary<string, object>? parameters = null);
+
+        /// <summary>
+        /// 执行查询并返回单个值（如Count/Sum）
+        /// </summary>
+        /// <typeparam name="T">返回值类型</typeparam>
+        /// <param name="sql">SQL语句</param>
+        /// <param name="parameters">参数集合</param>
+        (IDbExecuteResult Result, T? Value) ExecuteScalar<T>(string sql, Dictionary<string, object>? parameters = null);
+
+        /// <summary>
+        /// 异步执行查询并返回单个值
+        /// </summary>
+        Task<(IDbExecuteResult Result, T? Value)> ExecuteScalarAsync<T>(string sql, Dictionary<string, object>? parameters = null);
+
+        /// <summary>
+        /// 执行查询并返回DataTable
+        /// </summary>
+        (IDbExecuteResult Result, DataTable? Data) ExecuteDataTable(string sql, Dictionary<string, object>? parameters = null);
+
+        /// <summary>
+        /// 异步执行查询并返回DataTable
+        /// </summary>
+        Task<(IDbExecuteResult Result, DataTable? Data)> ExecuteDataTableAsync(string sql, Dictionary<string, object>? parameters = null);
+
+        /// <summary>
+        /// 执行查询并映射为实体列表
+        /// </summary>
+        /// <typeparam name="T">实体类型（需有无参构造函数）</typeparam>
+        (IDbExecuteResult Result, List<T> Data) QueryList<T>(string sql, Dictionary<string, object>? parameters = null) where T : new();
+
+        /// <summary>
+        /// 异步执行查询并映射为实体列表
+        /// </summary>
+        Task<(IDbExecuteResult Result, List<T> Data)> QueryListAsync<T>(string sql, Dictionary<string, object>? parameters = null) where T : new();
+
+        /// <summary>
+        /// 执行分页查询并返回分页结果
+        /// </summary>
+        /// <typeparam name="T">实体类型</typeparam>
+        (IDbExecuteResult Result, PaginationResponse<T> Data) QueryPaged<T>(string sql, PaginationRequest pagination, Dictionary<string, object>? parameters = null) where T : new();
+
+        /// <summary>
+        /// 异步执行分页查询并返回分页结果
+        /// </summary>
+        Task<(IDbExecuteResult Result, PaginationResponse<T> Data)> QueryPagedAsync<T>(string sql, PaginationRequest pagination, Dictionary<string, object>? parameters = null) where T : new();
+    }
+}

XP.Common/Database/Interfaces/IDbExecuteResult.cs

@@ -0,0 +1,34 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Database.Interfaces
+{
+    /// <summary>
+    /// 数据库操作通用执行结果
+    /// </summary>
+    public interface IDbExecuteResult
+    {
+        /// <summary>
+        /// 是否执行成功
+        /// </summary>
+        bool IsSuccess { get; set; }
+
+        /// <summary>
+        /// 影响行数（增删改）
+        /// </summary>
+        int RowsAffected { get; set; }
+
+        /// <summary>
+        /// 消息（成功/失败提示）
+        /// </summary>
+        string Message { get; set; }
+
+        /// <summary>
+        /// 异常信息（失败时非空）
+        /// </summary>
+        Exception? Exception { get; set; }
+    }
+}

XP.Common/Database/Interfaces/IDbTransaction.cs

@@ -0,0 +1,24 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Database.Interfaces
+{
+    /// <summary>
+    /// 数据库事务接口
+    /// </summary>
+    public interface IDbTransaction : IDisposable
+    {
+        /// <summary>
+        /// 提交事务
+        /// </summary>
+        IDbExecuteResult Commit();
+
+        /// <summary>
+        /// 回滚事务
+        /// </summary>
+        IDbExecuteResult Rollback();
+    }
+}

XP.Common/Database/Models/PaginationRequest.cs

@@ -0,0 +1,29 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Database.Models
+{
+    /// <summary>
+    /// 通用分页请求模型
+    /// </summary>
+    public class PaginationRequest
+    {
+        /// <summary>
+        /// 页码（从1开始）
+        /// </summary>
+        public int PageIndex { get; set; } = 1;
+
+        /// <summary>
+        /// 每页条数
+        /// </summary>
+        public int PageSize { get; set; } = 20;
+
+        /// <summary>
+        /// 排序字段（如：CreateTime DESC）
+        /// </summary>
+        public string OrderBy { get; set; } = string.Empty;
+    }
+}

XP.Common/Database/Models/PaginationResponse.cs

@@ -0,0 +1,45 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace XP.Common.Database.Models
+{
+    /// <summary>
+    /// 通用分页响应模型
+    /// </summary>
+    /// <typeparam name="T">数据类型</typeparam>
+    public class PaginationResponse<T>
+    {
+        /// <summary>
+        /// 页码
+        /// </summary>
+        public int PageIndex { get; set; }
+
+        /// <summary>
+        /// 每页条数
+        /// </summary>
+        public int PageSize { get; set; }
+
+        /// <summary>
+        /// 总条数
+        /// </summary>
+        public int TotalCount { get; set; }
+
+        /// <summary>
+        /// 总页数
+        /// </summary>
+        public int TotalPages => (int)Math.Ceiling((double)TotalCount / PageSize);
+
+        /// <summary>
+        /// 当前页数据
+        /// </summary>
+        public List<T> Data { get; set; } = new List<T>();
+
+        /// <summary>
+        /// 是否有下一页
+        /// </summary>
+        public bool HasNextPage => PageIndex < TotalPages;
+    }
+}

XP.Common/Documents/Dump.README.md

@@ -0,0 +1,183 @@
+# Dump 文件管理服务使用指南 | Dump File Management Service Usage Guide
+
+## 概述 | Overview
+
+XplorePlane 提供 Dump 文件管理功能，用于在应用程序崩溃或需要诊断时生成进程转储文件。支持三种触发方式：崩溃自动触发、定时触发和手动触发，并提供文件大小限制、自动清理和可配置存储路径等管理能力。
+
+Dump 功能通过 Windows `MiniDumpWriteDump` API 实现，作为 `XP.Common` 的子模块集成到 `CommonModule` 中。
+
+## 基本用法 | Basic Usage
+
+### 通过依赖注入获取服务 | Get Service via DI
+
+```csharp
+public class DiagnosticsService
+{
+    private readonly IDumpService _dumpService;
+    private readonly ILoggerService _logger;
+
+    public DiagnosticsService(IDumpService dumpService, ILoggerService logger)
+    {
+        _dumpService = dumpService ?? throw new ArgumentNullException(nameof(dumpService));
+        _logger = logger?.ForModule<DiagnosticsService>() ?? throw new ArgumentNullException(nameof(logger));
+    }
+
+    /// <summary>
+    /// 手动生成 Mini Dump | Manually generate Mini Dump
+    /// </summary>
+    public void CaptureMiniDump()
+    {
+        var filePath = _dumpService.CreateMiniDump();
+        if (filePath != null)
+        {
+            _logger.Info("Mini Dump 已生成：{FilePath} | Mini Dump generated: {FilePath}", filePath);
+        }
+    }
+
+    /// <summary>
+    /// 手动生成 Full Dump（包含完整内存）| Manually generate Full Dump (full memory)
+    /// </summary>
+    public void CaptureFullDump()
+    {
+        var filePath = _dumpService.CreateFullDump();
+        if (filePath != null)
+        {
+            _logger.Info("Full Dump 已生成：{FilePath} | Full Dump generated: {FilePath}", filePath);
+        }
+    }
+}
+```
+
+## 触发方式 | Trigger Modes
+
+### 1. 崩溃自动触发 | Crash Auto Trigger
+
+服务启动后自动订阅 `AppDomain.CurrentDomain.UnhandledException` 和 `TaskScheduler.UnobservedTaskException`，无需额外配置。崩溃时自动生成 Mini Dump。
+
+### 2. 定时触发 | Scheduled Trigger
+
+在 `App.config` 中启用定时触发后，服务按配置的时间间隔周期性生成 Mini Dump：
+
+```xml
+<add key="Dump:EnableScheduledDump" value="true" />
+<add key="Dump:ScheduledIntervalMinutes" value="60" />
+```
+
+### 3. 手动触发 | Manual Trigger
+
+通过 `IDumpService` 接口的方法手动触发：
+
+```csharp
+// 生成 Mini Dump（线程信息 + 数据段 + 句柄信息）
+// Generate Mini Dump (thread info + data segments + handle data)
+string? miniPath = _dumpService.CreateMiniDump();
+
+// 生成 Full Dump（完整内存，仅手动触发允许）
+// Generate Full Dump (full memory, manual trigger only)
+string? fullPath = _dumpService.CreateFullDump();
+```
+
+## Dump 类型说明 | Dump Type Description
+
+| 类型 | 包含内容 | 文件大小 | 触发限制 |
+|------|----------|----------|----------|
+| Mini Dump | 线程信息、数据段、句柄信息 | 较小（受大小限制约束） | 所有触发方式 |
+| Full Dump | 进程完整内存 | 较大（无大小限制） | 仅手动触发 |
+
+> 非手动触发（崩溃、定时）请求 Full Dump 时，系统会自动降级为 Mini Dump。
+
+## 文件命名规则 | File Naming Convention
+
+格式：`XplorePlane_{yyyyMMdd_HHmm}_{TriggerType}.dmp`
+
+示例：
+- `XplorePlane_20260317_1530_Crash.dmp` — 崩溃触发
+- `XplorePlane_20260317_1600_Scheduled.dmp` — 定时触发
+- `XplorePlane_20260317_1645_Manual.dmp` — 手动触发
+
+## 自动清理 | Auto Cleanup
+
+- 服务启动时立即执行一次清理
+- 运行期间每 24 小时执行一次清理
+- 超过保留天数（默认 7 天）的 `.dmp` 文件会被自动删除
+- 单个文件删除失败不影响其余文件的清理
+
+## 配置 | Configuration
+
+在 `App.config` 的 `<appSettings>` 中配置：
+
+```xml
+<appSettings>
+  <!-- Dump 文件存储路径 | Dump file storage path -->
+  <add key="Dump:StoragePath" value="D:\XplorePlane\Dump" />
+  <!-- 是否启用定时触发 | Enable scheduled trigger -->
+  <add key="Dump:EnableScheduledDump" value="false" />
+  <!-- 定时触发间隔（分钟）| Scheduled trigger interval (minutes) -->
+  <add key="Dump:ScheduledIntervalMinutes" value="60" />
+  <!-- Mini Dump 文件大小上限（MB）| Mini Dump file size limit (MB) -->
+  <add key="Dump:MiniDumpSizeLimitMB" value="100" />
+  <!-- 文件保留天数 | File retention days -->
+  <add key="Dump:RetentionDays" value="7" />
+</appSettings>
+```
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `Dump:StoragePath` | `D:\XplorePlane\Dump` | Dump 文件存储路径 |
+| `Dump:EnableScheduledDump` | `false` | 是否启用定时触发 |
+| `Dump:ScheduledIntervalMinutes` | `60` | 定时触发间隔（分钟） |
+| `Dump:MiniDumpSizeLimitMB` | `100` | Mini Dump 文件大小上限（MB），超过则删除 |
+| `Dump:RetentionDays` | `7` | 文件保留天数，超过则自动清理 |
+
+## 错误处理 | Error Handling
+
+Dump 功能遵循"记录并继续"原则，自身错误不影响主应用程序运行：
+
+- Dump 文件写入失败 → 记录错误日志，返回 `null`，不抛出异常
+- Mini Dump 超过大小限制 → 删除文件，记录警告
+- 存储目录创建失败 → 回退到默认路径 `D:\XplorePlane\Dump`
+- 清理过程中文件删除失败 → 记录错误，继续清理其余文件
+
+## IDumpService 接口 | IDumpService Interface
+
+```csharp
+public interface IDumpService : IDisposable
+{
+    /// <summary>
+    /// 手动触发 Mini Dump 生成 | Manually trigger Mini Dump generation
+    /// </summary>
+    string? CreateMiniDump();
+
+    /// <summary>
+    /// 手动触发 Full Dump 生成 | Manually trigger Full Dump generation
+    /// </summary>
+    string? CreateFullDump();
+
+    /// <summary>
+    /// 启动服务 | Start service
+    /// </summary>
+    void Start();
+
+    /// <summary>
+    /// 停止服务 | Stop service
+    /// </summary>
+    void Stop();
+}
+```
+
+## 文件结构 | File Structure
+
+```
+XP.Common/Dump/
+├── Interfaces/
+│   └── IDumpService.cs          # 服务接口 | Service interface
+├── Implementations/
+│   ├── DumpService.cs           # 服务实现 | Service implementation
+│   └── DumpCleaner.cs           # 自动清理组件 | Auto cleanup component
+├── Configs/
+│   ├── DumpConfig.cs            # 配置实体 | Config entity
+│   └── DumpTriggerType.cs       # 触发类型枚举 | Trigger type enum
+└── Native/
+    ├── NativeMethods.cs         # P/Invoke 声明 | P/Invoke declarations
+    └── MiniDumpType.cs          # Dump 类型标志枚举 | Dump type flags enum
+```

XP.Common/Documents/GeneralForm.README.md

@@ -0,0 +1,247 @@
+# 通用窗体使用指南 | General Form Usage Guide
+
+## 概述 | Overview
+
+`XP.Common.GeneralForm` 提供 XplorePlane 项目中可复用的通用 WPF 窗体组件。当前包含以下窗体：
+
+| 窗体 | 说明 |
+|---|---|
+| `ProgressWindow` | 模态进度条窗口，支持线程安全的进度更新和关闭操作 |
+| `InputDialog` | 通用输入对话框，支持单行文本输入、可选验证和多语言按钮 |
+
+## 目录结构 | Directory Structure
+
+```
+XP.Common/GeneralForm/
+├── ViewModels/
+│   ├── InputDialogViewModel.cs       # 输入对话框 ViewModel
+│   └── ProgressWindowViewModel.cs    # 进度窗口 ViewModel
+└── Views/
+    ├── InputDialog.xaml              # 输入对话框 XAML 视图
+    ├── InputDialog.xaml.cs           # 输入对话框 Code-Behind
+    ├── ProgressWindow.xaml           # 进度窗口 XAML 视图
+    └── ProgressWindow.xaml.cs        # 进度窗口 Code-Behind
+```
+
+---
+
+## ProgressWindow 进度条窗口
+
+### 功能特性 | Features
+
+- 模态进度条窗口，居中显示，不可调整大小
+- 线程安全：`UpdateProgress()` 和 `Close()` 可从任意线程调用，内部自动通过 `Dispatcher` 调度
+- 可配置是否允许用户手动关闭窗口（`isCancelable` 参数）
+- 不可取消时，通过 Win32 API 禁用窗口关闭按钮（灰色不可点击）
+- 进度值自动 Clamp 到 `[0, 100]` 范围，超出范围时记录 Warn 日志
+- 自动继承主窗口图标
+- 使用 Telerik `RadProgressBar` 控件（Crystal 主题）
+
+### 构造函数参数 | Constructor Parameters
+
+```csharp
+public ProgressWindow(
+    string title = "操作进行中",       // 窗口标题
+    string message = "请稍候...",      // 提示信息
+    bool isCancelable = true,          // 是否允许用户关闭窗口
+    ILoggerService? logger = null      // 日志服务（可选）
+)
+```
+
+| 参数 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `title` | `string` | `"操作进行中"` | 窗口标题栏文本 |
+| `message` | `string` | `"请稍候..."` | 进度条上方的提示信息 |
+| `isCancelable` | `bool` | `true` | `true`：用户可手动关闭；`false`：禁用关闭按钮 |
+| `logger` | `ILoggerService?` | `null` | 传入日志服务后自动记录窗口生命周期日志 |
+
+### 公开方法 | Public Methods
+
+#### UpdateProgress - 更新进度
+
+```csharp
+// 线程安全，可从任意线程调用
+void UpdateProgress(string message, double progress)
+```
+
+- `message`：更新提示信息文本
+- `progress`：进度值（0-100），超出范围自动修正
+
+#### Close - 关闭窗口
+
+```csharp
+// 线程安全，可从任意线程调用（隐藏基类 Window.Close()）
+new void Close()
+```
+
+### 基本用法 | Basic Usage
+
+```csharp
+using XP.Common.GeneralForm.Views;
+using XP.Common.Logging.Interfaces;
+
+public class SomeService
+{
+    private readonly ILoggerService _logger;
+
+    public SomeService(ILoggerService logger)
+    {
+        _logger = logger?.ForModule<SomeService>() 
+            ?? throw new ArgumentNullException(nameof(logger));
+    }
+
+    public async Task ExecuteLongOperation()
+    {
+        // 创建进度窗口（不可取消）
+        var progressWindow = new ProgressWindow(
+            title: "数据处理中",
+            message: "正在初始化...",
+            isCancelable: false,
+            logger: _logger);
+
+        // 显示模态窗口（需在 UI 线程调用）
+        // 注意：ShowDialog() 会阻塞，通常配合 Task 使用
+        _ = Task.Run(async () =>
+        {
+            try
+            {
+                progressWindow.UpdateProgress("正在加载数据...", 20);
+                await Task.Delay(1000); // 模拟耗时操作
+
+                progressWindow.UpdateProgress("正在处理数据...", 60);
+                await Task.Delay(1000);
+
+                progressWindow.UpdateProgress("即将完成...", 90);
+                await Task.Delay(500);
+
+                progressWindow.UpdateProgress("完成", 100);
+            }
+            finally
+            {
+                // 关闭窗口（线程安全）
+                progressWindow.Close();
+            }
+        });
+
+        progressWindow.ShowDialog();
+    }
+}
+```
+
+### 允许用户取消的用法 | Cancelable Usage
+
+```csharp
+// 创建可取消的进度窗口
+var progressWindow = new ProgressWindow(
+    title: "文件导出",
+    message: "正在导出文件...",
+    isCancelable: true,   // 用户可以点击关闭按钮取消
+    logger: _logger);
+
+progressWindow.ShowDialog();
+```
+
+### ViewModel 绑定属性 | ViewModel Binding Properties
+
+`ProgressWindowViewModel` 继承自 `BindableBase`，提供以下可绑定属性：
+
+| 属性 | 类型 | 说明 |
+|---|---|---|
+| `Title` | `string` | 窗口标题（只读） |
+| `Message` | `string` | 提示信息文本（可通知） |
+| `Progress` | `double` | 进度值 0-100（可通知） |
+| `ProgressText` | `string` | 百分比显示文本，如 `"75%"`（只读，自动计算） |
+| `IsCancelable` | `bool` | 是否允许用户关闭（只读） |
+
+### 注意事项 | Notes
+
+1. `ShowDialog()` 必须在 UI 线程调用，它会阻塞当前线程直到窗口关闭
+2. `UpdateProgress()` 和 `Close()` 内部已处理跨线程调度，可安全地从后台线程调用
+3. 当 `isCancelable = false` 时，窗口关闭按钮会被 Win32 API 禁用（灰色），用户无法通过 Alt+F4 或点击关闭
+4. 进度值超出 `[0, 100]` 范围时会自动修正并记录 Warn 级别日志
+5. `Close()` 使用 `new` 关键字隐藏基类方法（因 `Window.Close()` 非虚方法），确保通过 `ProgressWindow` 类型引用调用
+
+---
+
+## InputDialog 输入对话框
+
+### 功能特性 | Features
+
+- 模态输入对话框，居中于父窗口显示，不可调整大小
+- 自动继承主窗口图标
+- 按钮文本支持多语言（使用 `Button_OK` / `Button_Cancel` 资源键）
+- 可选的输入验证委托（`Func<string, string?>`），验证失败时在输入框下方显示红色错误提示
+- 输入内容变化时自动清除验证错误
+- 使用 Telerik `RadWatermarkTextBox` 和 `RadButton` 控件（Crystal 主题）
+- 提供静态 `Show()` 便捷方法，一行代码即可调用
+
+### 静态方法 | Static Method
+
+```csharp
+public static string? Show(
+    string prompt,                        // 提示文本
+    string title,                         // 窗口标题
+    string defaultValue = "",             // 默认值
+    Func<string, string?>? validate = null, // 验证委托（可选）
+    Window? owner = null                  // 父窗口（可选）
+)
+```
+
+| 参数 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `prompt` | `string` | 必填 | 输入框上方的提示文本 |
+| `title` | `string` | 必填 | 窗口标题栏文本 |
+| `defaultValue` | `string` | `""` | 输入框的初始值 |
+| `validate` | `Func<string, string?>?` | `null` | 验证委托：返回 `null` 表示通过，返回错误信息则阻止确认 |
+| `owner` | `Window?` | `null` | 父窗口，设置后对话框居中于父窗口 |
+
+返回值：用户输入的字符串，取消时返回 `null`。
+
+### 基本用法 | Basic Usage
+
+```csharp
+using XP.Common.GeneralForm.Views;
+
+// 最简用法，无验证
+var name = InputDialog.Show("请输入名称：", "新建项目");
+if (name == null) return; // 用户取消
+
+// 带默认值
+var port = InputDialog.Show("请输入端口号：", "配置", "8080");
+```
+
+### 带验证的用法 | Usage with Validation
+
+```csharp
+// 验证委托：返回 null 表示通过，返回错误信息则显示在输入框下方
+var groupId = InputDialog.Show(
+    "请输入 Group ID：",
+    "新增 Group",
+    validate: input =>
+    {
+        if (string.IsNullOrWhiteSpace(input))
+            return "ID 不能为空";
+        if (existingIds.Contains(input))
+            return "ID 已存在，请使用不同的 ID";
+        return null; // 验证通过
+    });
+
+// 验证非负整数
+var dbNumber = InputDialog.Show(
+    "请输入 DB 块号（非负整数）：",
+    "新增 Group",
+    "0",
+    validate: input =>
+    {
+        if (!int.TryParse(input, out int val) || val < 0)
+            return "必须为非负整数";
+        return null;
+    });
+```
+
+### 注意事项 | Notes
+
+1. `Show()` 必须在 UI 线程调用（内部使用 `ShowDialog()`）
+2. 验证委托在用户点击确定按钮时执行，验证失败不会关闭对话框
+3. 用户修改输入内容时会自动清除上一次的验证错误提示
+4. 按钮文本从 XP.Common 资源文件读取（`Button_OK` / `Button_Cancel`），自动跟随应用语言

XP.Common/Documents/Localization.README.md

@@ -0,0 +1,265 @@
+# 多语言支持快速开始 | Localization Quick Start
+
+## 概述 | Overview
+
+XplorePlane 多语言支持系统基于 .NET 原生 Resx 资源文件实现，与 Prism MVVM 架构无缝集成。系统支持简体中文（zh-CN）、繁体中文（zh-TW）和美式英语（en-US）三种语言。
+
+### 核心特性 | Key Features
+
+- ✅ 基于 .NET Resx 资源文件，编译时类型安全
+- ✅ 简洁的 XAML 标记扩展语法
+- ✅ 完整的 ViewModel 集成支持
+- ✅ 语言设置持久化到 App.config
+- ✅ 跨模块事件通知机制
+- ✅ 健壮的错误处理和回退机制
+- ✅ 多资源源 Fallback Chain 机制，支持模块级资源注册
+
+---
+
+## 快速开始 | Quick Start
+
+### 1. 在 XAML 中使用本地化资源 | Using Localization in XAML
+
+#### 基础用法 | Basic Usage
+
+```xml
+<Window x:Class="XplorePlane.App.Views.MainWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:loc="clr-namespace:XplorePlane.Common.Localization.Extensions;assembly=XP.Common"
+        Title="{loc:Localization Key=App_Title}">
+
+    <Grid>
+        <!-- 按钮文本本地化 | Localized button text -->
+        <Button Content="{loc:Localization Key=Button_OK}" />
+
+        <!-- 标签文本本地化 | Localized label text -->
+        <Label Content="{loc:Localization Key=Settings_Language}" />
+
+        <!-- 菜单项本地化 | Localized menu item -->
+        <MenuItem Header="{loc:Localization Key=Menu_File}" />
+    </Grid>
+</Window>
+```
+
+#### 命名空间声明 | Namespace Declaration
+
+在 XAML 文件顶部添加命名空间引用：
+
+```xml
+xmlns:loc="clr-namespace:XplorePlane.Common.Localization.Extensions;assembly=XP.Common"
+```
+
+#### 语法说明 | Syntax Explanation
+
+- `{loc:Localization Key=ResourceKey}` - 完整语法
+- `{loc:Localization App_Title}` - 简化语法（Key 可省略）
+- 资源键不存在时，显示键名本身（便于调试）
+
+---
+
+### 2. 在 C# 代码中使用静态帮助类 | Using Static Helper in C# Code
+
+适用于不方便依赖注入的场景（静态方法、工具类等）。
+
+```csharp
+using XP.Common.Localization;
+
+// 基本用法 | Basic usage
+var title = LocalizationHelper.Get("App_Title");
+
+// 带格式化参数 | With format arguments
+var errorMsg = LocalizationHelper.Get("Settings_Language_SwitchFailed", ex.Message);
+```
+
+- 在 ViewModel / Service 中优先使用 `ILocalizationService`（可测试、可 Mock）
+- 在静态方法、工具类、或不方便注入的地方使用 `LocalizationHelper`
+- 两者读取同一套 Resx 资源文件，结果一致
+
+> **V1.4.1.1 变更：** `LocalizationHelper` 新增 `Initialize(ILocalizationService)` 方法。初始化后，`Get()` 会优先通过 `ILocalizationService` 获取字符串（支持 Fallback Chain）；未初始化时仍兼容回退到原始 `ResourceManager`。建议在 `CommonModule` 或 App 启动时调用初始化。
+
+```csharp
+// 在 CommonModule 或 App 启动时调用 | Call at CommonModule or App startup
+LocalizationHelper.Initialize(localizationService);
+```
+
+---
+
+### 3. 在 ViewModel 中使用本地化服务 | Using Localization Service in ViewModel
+
+#### 依赖注入 | Dependency Injection
+
+```csharp
+using XplorePlane.Common.Localization.Interfaces;
+using XplorePlane.Common.Localization.Enums;
+using Prism.Mvvm;
+
+namespace XplorePlane.App.ViewModels
+{
+    public class MyViewModel : BindableBase
+    {
+        private readonly ILocalizationService _localizationService;
+        private readonly ILoggerService _logger;
+
+        public MyViewModel(
+            ILocalizationService localizationService,
+            ILoggerService logger)
+        {
+            _localizationService = localizationService;
+            _logger = logger;
+        }
+
+        // 获取本地化字符串 | Get localized string
+        public string GetWelcomeMessage()
+        {
+            return _localizationService.GetString("Welcome_Message");
+        }
+
+        // 获取当前语言 | Get current language
+        public SupportedLanguage CurrentLanguage => _localizationService.CurrentLanguage;
+    }
+}
+```
+
+#### 动态文本绑定 | Dynamic Text Binding
+
+```csharp
+public class StatusViewModel : BindableBase
+{
+    private readonly ILocalizationService _localizationService;
+    private string _statusMessage;
+
+    public string StatusMessage
+    {
+        get => _statusMessage;
+        set => SetProperty(ref _statusMessage, value);
+    }
+
+    public StatusViewModel(ILocalizationService localizationService)
+    {
+        _localizationService = localizationService;
+
+        // 订阅语言切换事件 | Subscribe to language changed event
+        _localizationService.LanguageChanged += OnLanguageChanged;
+
+        // 初始化状态消息 | Initialize status message
+        UpdateStatusMessage();
+    }
+
+    private void OnLanguageChanged(object sender, LanguageChangedEventArgs e)
+    {
+        // 语言切换时更新文本 | Update text when language changes
+        UpdateStatusMessage();
+    }
+
+    private void UpdateStatusMessage()
+    {
+        StatusMessage = _localizationService.GetString("Status_Ready");
+    }
+}
+```
+
+#### 数据验证消息本地化 | Localized Validation Messages
+
+```csharp
+public class FormViewModel : BindableBase, IDataErrorInfo
+{
+    private readonly ILocalizationService _localizationService;
+    private string _username;
+
+    public string Username
+    {
+        get => _username;
+        set => SetProperty(ref _username, value);
+    }
+
+    public string this[string columnName]
+    {
+        get
+        {
+            if (columnName == nameof(Username))
+            {
+                if (string.IsNullOrWhiteSpace(Username))
+                {
+                    return _localizationService.GetString("Validation_UsernameRequired");
+                }
+                if (Username.Length < 3)
+                {
+                    return _localizationService.GetString("Validation_UsernameTooShort");
+                }
+            }
+            return null;
+        }
+    }
+
+    public string Error => null;
+}
+```
+
+---
+
+### 4. 多资源源 Fallback Chain | Multi-Source Fallback Chain
+
+V1.1 版本引入了多资源源 Fallback Chain 机制，允许各模块注册自己的 Resx 资源文件。查找资源键时，从最后注册的资源源开始向前遍历，第一个返回非 null 值的即为结果。
+
+#### 架构说明 | Architecture
+
+```
+Fallback Chain（查找顺序从右到左）:
+[XP.Common (默认)] → [XP.Scan (模块注册)] → [XP.Hardware (模块注册)]
+                                                ↑ 最高优先级
+```
+
+- `XP.Common` 为默认资源源，始终位于 Chain[0]，不可注销
+- 后注册的模块优先级更高
+- 单个资源源查找异常时自动跳过，继续遍历下一个
+- 全部未找到时返回 key 本身并记录警告日志
+
+#### 注册模块资源源 | Register Module Resource Source
+
+在 Prism 模块的 `OnInitialized` 中注册：
+
+```csharp
+using System.Resources;
+using XP.Common.Localization.Interfaces;
+
+public class ScanModule : IModule
+{
+    private readonly ILocalizationService _localizationService;
+
+    public ScanModule(ILocalizationService localizationService)
+    {
+        _localizationService = localizationService;
+    }
+
+    public void OnInitialized(IContainerProvider containerProvider)
+    {
+        // 注册模块资源源到 Fallback Chain
+        var resourceManager = new ResourceManager(
+            "XP.Scan.Resources.Resources",
+            typeof(ScanModule).Assembly);
+        _localizationService.RegisterResourceSource("XP.Scan", resourceManager);
+    }
+
+    public void RegisterTypes(IContainerRegistry containerRegistry) { }
+}
+```
+
+#### 注销模块资源源 | Unregister Module Resource Source
+
+```csharp
+// 注销指定资源源（不可注销默认的 "XP.Common"）
+_localizationService.UnregisterResourceSource("XP.Scan");
+```
+
+#### 注意事项 | Notes
+
+- 资源源名称不可重复，重复注册会抛出 `InvalidOperationException`
+- 注销 `"XP.Common"` 会抛出 `InvalidOperationException`
+- 注销不存在的名称会静默忽略并记录警告日志
+- 线程安全：内部使用 `ReaderWriterLockSlim` 保护读写操作
+
+---
+
+**版本 | Version:** 1.1  
+**最后更新 | Last Updated:** 2026-04-01

XP.Common/Documents/Logging.EXAMPLES.md

@@ -0,0 +1,233 @@
+# 日志服务使用示例 | Logger Service Usage Examples
+
+## 示例 1：服务类中使用 | Example 1: Usage in Service Class
+
+### 旧方式（手动传递字符串）| Old Way (Manual String)
+
+```csharp
+public class PlcService
+{
+    private readonly ILoggerService _logger;
+
+    public PlcService(ILoggerService logger)
+    {
+        // 需要手动输入类名，容易出错
+        // Need to manually type class name, error-prone
+        _logger = logger?.ForModule("PlcService") ?? throw new ArgumentNullException(nameof(logger));
+    }
+}
+
+// 日志输出 | Log output:
+// [PlcService] 正在初始化 PLC 连接...
+```
+
+### 新方式（自动类型推断）| New Way (Auto Type Inference)
+
+```csharp
+public class PlcService
+{
+    private readonly ILoggerService _logger;
+
+    public PlcService(ILoggerService logger)
+    {
+        // 自动获取完整类型名，重构安全
+        // Automatically get full type name, refactoring-safe
+        _logger = logger?.ForModule<PlcService>() ?? throw new ArgumentNullException(nameof(logger));
+    }
+}
+
+// 日志输出 | Log output:
+// [XP.Hardware.Plc.Services.PlcService] 正在初始化 PLC 连接...
+```
+
+## 示例 2：ViewModel 中使用 | Example 2: Usage in ViewModel
+
+```csharp
+using Prism.Mvvm;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Hardware.RaySource.ViewModels
+{
+    public class RaySourceOperateViewModel : BindableBase
+    {
+        private readonly ILoggerService _logger;
+
+        public RaySourceOperateViewModel(ILoggerService logger)
+        {
+            // 自动使用：XP.Hardware.RaySource.ViewModels.RaySourceOperateViewModel
+            // Automatically uses: XP.Hardware.RaySource.ViewModels.RaySourceOperateViewModel
+            _logger = logger?.ForModule<RaySourceOperateViewModel>() ?? throw new ArgumentNullException(nameof(logger));
+            
+            _logger.Info("射线源操作视图模型已初始化 | Ray source operate view model initialized");
+        }
+
+        public void StartXRay()
+        {
+            _logger.Info("用户请求启动射线 | User requested to start X-ray");
+            // ... 业务逻辑 | business logic
+        }
+    }
+}
+```
+
+## 示例 3：工厂类中使用 | Example 3: Usage in Factory Class
+
+```csharp
+using XP.Common.Logging.Interfaces;
+using XP.Hardware.RaySource.Abstractions;
+
+namespace XP.Hardware.RaySource.Factories
+{
+    public class RaySourceFactory : IRaySourceFactory
+    {
+        private readonly ILoggerService _logger;
+
+        public RaySourceFactory(ILoggerService logger)
+        {
+            // 自动使用：XP.Hardware.RaySource.Factories.RaySourceFactory
+            // Automatically uses: XP.Hardware.RaySource.Factories.RaySourceFactory
+            _logger = logger?.ForModule<RaySourceFactory>() ?? throw new ArgumentNullException(nameof(logger));
+        }
+
+        public IXRaySource CreateRaySource(string deviceType)
+        {
+            _logger.Info("创建射线源实例：类型={DeviceType} | Creating ray source instance: type={DeviceType}", deviceType);
+            
+            switch (deviceType)
+            {
+                case "Comet225":
+                    return new Comet225RaySource(_logger);
+                default:
+                    _logger.Error(null, "不支持的设备类型：{DeviceType} | Unsupported device type: {DeviceType}", deviceType);
+                    throw new NotSupportedException($"不支持的设备类型：{deviceType}");
+            }
+        }
+    }
+}
+```
+
+## 示例 4：静态方法中使用 | Example 4: Usage in Static Methods
+
+```csharp
+public class ConfigLoader
+{
+    public static PlcConfig LoadConfig(ILoggerService logger)
+    {
+        // 静态方法中也可以使用泛型
+        // Can also use generics in static methods
+        var log = logger.ForModule<ConfigLoader>();
+        
+        log.Info("正在加载 PLC 配置 | Loading PLC configuration");
+        
+        try
+        {
+            // ... 加载逻辑 | loading logic
+            log.Info("PLC 配置加载成功 | PLC configuration loaded successfully");
+            return config;
+        }
+        catch (Exception ex)
+        {
+            log.Error(ex, "PLC 配置加载失败 | PLC configuration loading failed");
+            throw;
+        }
+    }
+}
+```
+
+## 示例 5：嵌套类中使用 | Example 5: Usage in Nested Classes
+
+```csharp
+public class RaySourceService
+{
+    private readonly ILoggerService _logger;
+
+    public RaySourceService(ILoggerService logger)
+    {
+        _logger = logger?.ForModule<RaySourceService>() ?? throw new ArgumentNullException(nameof(logger));
+    }
+
+    // 嵌套类 | Nested class
+    public class ConnectionManager
+    {
+        private readonly ILoggerService _logger;
+
+        public ConnectionManager(ILoggerService logger)
+        {
+            // 自动使用：XP.Hardware.RaySource.Services.RaySourceService+ConnectionManager
+            // Automatically uses: XP.Hardware.RaySource.Services.RaySourceService+ConnectionManager
+            _logger = logger?.ForModule<ConnectionManager>() ?? throw new ArgumentNullException(nameof(logger));
+        }
+    }
+}
+```
+
+## 示例 6：混合使用 | Example 6: Mixed Usage
+
+有时你可能想要自定义模块名以保持简洁：
+
+```csharp
+public class VeryLongNamespaceAndClassName
+{
+    private readonly ILoggerService _logger;
+
+    public VeryLongNamespaceAndClassName(ILoggerService logger)
+    {
+        // 选项 1：使用完整类型名（详细但冗长）
+        // Option 1: Use full type name (detailed but verbose)
+        // _logger = logger?.ForModule<VeryLongNamespaceAndClassName>();
+        // 输出 | Output: [XP.Some.Very.Long.Namespace.VeryLongNamespaceAndClassName]
+
+        // 选项 2：使用简短自定义名（简洁但需手动维护）
+        // Option 2: Use short custom name (concise but needs manual maintenance)
+        _logger = logger?.ForModule("VeryLong") ?? throw new ArgumentNullException(nameof(logger));
+        // 输出 | Output: [VeryLong]
+    }
+}
+```
+
+## 优势对比 | Advantages Comparison
+
+### ForModule<T>() 的优势 | Advantages of ForModule<T>()
+
+✅ **重构安全**：重命名类时自动更新  
+✅ **Refactoring-safe**: Automatically updates when renaming class
+
+✅ **无拼写错误**：编译器检查类型  
+✅ **No typos**: Compiler checks type
+
+✅ **完整信息**：包含命名空间，便于定位  
+✅ **Complete info**: Includes namespace, easy to locate
+
+✅ **智能提示**：IDE 自动补全  
+✅ **IntelliSense**: IDE auto-completion
+
+### ForModule(string) 的优势 | Advantages of ForModule(string)
+
+✅ **简洁输出**：日志文件更易读  
+✅ **Concise output**: Log files more readable
+
+✅ **自定义名称**：可以使用业务术语  
+✅ **Custom names**: Can use business terms
+
+✅ **灵活性**：可以为不同场景使用不同名称  
+✅ **Flexibility**: Can use different names for different scenarios
+
+## 推荐使用场景 | Recommended Usage Scenarios
+
+| 场景 | 推荐方式 | 原因 |
+|------|---------|------|
+| 服务类 | `ForModule<T>()` | 需要完整追踪 |
+| ViewModel | `ForModule<T>()` | 需要完整追踪 |
+| 工厂类 | `ForModule<T>()` | 需要完整追踪 |
+| 简单工具类 | `ForModule("ToolName")` | 保持简洁 |
+| 临时调试 | `ForModule("Debug")` | 快速定位 |
+| 第三方集成 | `ForModule("ThirdParty.XXX")` | 明确标识 |
+
+| Scenario | Recommended | Reason |
+|----------|------------|--------|
+| Service classes | `ForModule<T>()` | Need full tracing |
+| ViewModels | `ForModule<T>()` | Need full tracing |
+| Factory classes | `ForModule<T>()` | Need full tracing |
+| Simple utility classes | `ForModule("ToolName")` | Keep concise |
+| Temporary debugging | `ForModule("Debug")` | Quick location |
+| Third-party integration | `ForModule("ThirdParty.XXX")` | Clear identification |

XP.Common/Documents/Logging.README.md

@@ -0,0 +1,177 @@
+# 日志服务使用指南 | Logger Service Usage Guide
+
+## 概述 | Overview
+
+XplorePlane 使用 Serilog 作为底层日志框架，通过 `ILoggerService` 接口提供统一的日志服务。
+
+## 基本用法 | Basic Usage
+
+### 方式 1：自动类型推断（推荐）| Method 1: Auto Type Inference (Recommended)
+
+使用泛型方法 `ForModule<T>()` 自动获取类型的完整名称（命名空间 + 类名）：
+
+```csharp
+public class PlcService
+{
+    private readonly ILoggerService _logger;
+
+    public PlcService(ILoggerService logger)
+    {
+        // 自动使用 "XP.Hardware.Plc.Services.PlcService" 作为模块名
+        // Automatically uses "XP.Hardware.Plc.Services.PlcService" as module name
+        _logger = logger?.ForModule<PlcService>() ?? throw new ArgumentNullException(nameof(logger));
+    }
+
+    public void DoSomething()
+    {
+        _logger.Info("执行操作 | Performing operation");
+    }
+}
+```
+
+### 方式 2：手动指定模块名 | Method 2: Manual Module Name
+
+如果需要自定义模块名，可以使用字符串参数：
+
+```csharp
+public class PlcService
+{
+    private readonly ILoggerService _logger;
+
+    public PlcService(ILoggerService logger)
+    {
+        // 手动指定简短的模块名
+        // Manually specify a short module name
+        _logger = logger?.ForModule("PlcService") ?? throw new ArgumentNullException(nameof(logger));
+    }
+}
+```
+
+### 方式 3：使用 typeof 获取类型名 | Method 3: Using typeof for Type Name
+
+在静态方法或无法使用泛型的场景：
+
+```csharp
+public class PlcService
+{
+    private readonly ILoggerService _logger;
+
+    public PlcService(ILoggerService logger)
+    {
+        // 使用 typeof 获取类型
+        // Use typeof to get type
+        _logger = logger?.ForModule<PlcService>() ?? throw new ArgumentNullException(nameof(logger));
+    }
+
+    public static void StaticMethod(ILoggerService logger)
+    {
+        // 静态方法中也可以使用泛型
+        // Can also use generics in static methods
+        var log = logger.ForModule<PlcService>();
+        log.Info("静态方法日志 | Static method log");
+    }
+}
+```
+
+## 日志级别 | Log Levels
+
+```csharp
+// 调试信息（开发环境）| Debug information (development environment)
+_logger.Debug("调试信息：变量值={Value} | Debug info: variable value={Value}", someValue);
+
+// 一般信息 | General information
+_logger.Info("操作成功 | Operation successful");
+
+// 警告信息 | Warning information
+_logger.Warn("连接不稳定 | Connection unstable");
+
+// 错误信息（带异常）| Error information (with exception)
+_logger.Error(ex, "操作失败：{Message} | Operation failed: {Message}", ex.Message);
+
+// 致命错误 | Fatal error
+_logger.Fatal(ex, "系统崩溃 | System crash");
+```
+
+## 日志输出格式 | Log Output Format
+
+使用 `ForModule<T>()` 后，日志会自动包含完整的类型信息：
+
+```
+2026-03-12 10:30:15.123 [INF] [XP.Hardware.Plc.Services.PlcService] 正在初始化 PLC 连接... | Initializing PLC connection...
+2026-03-12 10:30:16.456 [INF] [XP.Hardware.Plc.Services.PlcService] PLC 连接成功 | PLC connection successful
+```
+
+## 最佳实践 | Best Practices
+
+### 1. 在构造函数中初始化日志器 | Initialize Logger in Constructor
+
+```csharp
+public class MyService
+{
+    private readonly ILoggerService _logger;
+
+    public MyService(ILoggerService logger)
+    {
+        _logger = logger?.ForModule<MyService>() ?? throw new ArgumentNullException(nameof(logger));
+    }
+}
+```
+
+### 2. 使用结构化日志 | Use Structured Logging
+
+```csharp
+// 好的做法：使用占位符 | Good: use placeholders
+_logger.Info("用户 {UserId} 执行了操作 {Action} | User {UserId} performed action {Action}", userId, action);
+
+// 不好的做法：字符串拼接 | Bad: string concatenation
+_logger.Info($"用户 {userId} 执行了操作 {action}");
+```
+
+### 3. 异常日志包含上下文 | Exception Logs Include Context
+
+```csharp
+try
+{
+    await _plcClient.ConnectAsync(config);
+}
+catch (PlcException ex)
+{
+    _logger.Error(ex, "PLC 连接失败：地址={Address}, 端口={Port} | PLC connection failed: address={Address}, port={Port}", 
+        config.Address, config.Port);
+    throw;
+}
+```
+
+## 对比：三种方式的输出 | Comparison: Output of Three Methods
+
+```csharp
+// 方式 1：ForModule<T>() - 完整类型名
+// Method 1: ForModule<T>() - Full type name
+_logger = logger.ForModule<PlcService>();
+// 输出 | Output: [XP.Hardware.Plc.Services.PlcService]
+
+// 方式 2：ForModule("PlcService") - 自定义名称
+// Method 2: ForModule("PlcService") - Custom name
+_logger = logger.ForModule("PlcService");
+// 输出 | Output: [PlcService]
+
+// 方式 3：不调用 ForModule - 无模块标记
+// Method 3: Don't call ForModule - No module tag
+_logger = logger;
+// 输出 | Output: [] (空标记 | empty tag)
+```
+
+## 配置 | Configuration
+
+日志配置在 `App.config` 中设置，通过 `SerilogConfig` 加载：
+
+```xml
+<appSettings>
+  <add key="Serilog:LogPath" value="C:\Logs\XplorePlane" />
+  <add key="Serilog:MinimumLevel" value="Information" />
+  <add key="Serilog:EnableConsole" value="true" />
+  <add key="Serilog:RollingInterval" value="Day" />
+  <add key="Serilog:FileSizeLimitMB" value="100" />
+  <add key="Serilog:RetainedFileCountLimit" value="30" />
+</appSettings>
+```

XP.Common/Documents/PdfViewer.README.md

@@ -0,0 +1,299 @@
+# PDF 查看与打印模块使用指南 | PDF Viewer & Printer Module Usage Guide
+
+## 概述 | Overview
+
+`XP.Common.PdfViewer` 提供基于 Telerik RadPdfViewer 的 PDF 文件查看与打印功能模块。模块作为 XP.Common 的通用可复用组件，通过 Prism DI 容器注册服务接口，供外部类库通过构造函数注入使用。
+
+### 核心功能 | Core Features
+
+- PDF 文件加载与显示（支持文件路径和文件流两种方式）
+- 内置 RadPdfViewerToolbar 提供页面导航、缩放、旋转、打印等完整工具栏 UI
+- 静默打印（指定打印机、页面范围、打印份数）
+- 打印设置对话框（用户交互式配置打印参数）
+- 打印预览功能
+- 多语言支持（简体中文、繁体中文、英文）
+- 结构化日志记录（使用 ILoggerService）
+- 资源自动释放（IDisposable + 终结器安全网）
+
+---
+
+## 目录结构 | Directory Structure
+
+```
+XP.Common/PdfViewer/
+├── Exceptions/                    # 自定义异常
+│   ├── PdfLoadException.cs        # PDF 加载异常
+│   ├── PrinterNotFoundException.cs # 打印机未找到异常
+│   └── PrintException.cs          # 打印异常
+├── Interfaces/                    # 服务接口
+│   ├── IPdfViewerService.cs       # PDF 查看服务接口
+│   └── IPdfPrintService.cs        # PDF 打印服务接口
+├── Implementations/              # 服务实现
+│   ├── PdfViewerService.cs        # PdfViewerService 实现
+│   └── PdfPrintService.cs         # PdfPrintService 实现
+├── ViewModels/                    # ViewModel
+│   └── PdfViewerWindowViewModel.cs # 阅读器窗口 ViewModel
+└── Views/                         # 视图
+    ├── PdfViewerWindow.xaml       # 阅读器窗口 XAML
+    └── PdfViewerWindow.xaml.cs    # 阅读器窗口 Code-Behind
+```
+
+---
+
+## 服务接口 | Service Interfaces
+
+### IPdfViewerService - PDF 查看服务
+
+负责 PDF 文件加载和阅读器窗口管理。
+
+```csharp
+public interface IPdfViewerService : IDisposable
+{
+    /// 通过文件路径打开 PDF 阅读器窗口
+    void OpenViewer(string filePath);
+
+    /// 通过文件流打开 PDF 阅读器窗口
+    void OpenViewer(Stream stream, string? title = null);
+}
+```
+
+### IPdfPrintService - PDF 打印服务
+
+负责 PDF 打印功能，包括静默打印和交互式打印。
+
+```csharp
+public interface IPdfPrintService
+{
+    /// 使用指定打印机打印 PDF 文件
+    void Print(string filePath, string printerName, int? pageFrom = null, int? pageTo = null, int copies = 1);
+
+    /// 打开打印设置对话框并打印
+    bool PrintWithDialog(string filePath);
+
+    /// 打开打印预览对话框
+    void PrintPreview(string filePath);
+}
+```
+
+---
+
+## 使用示例 | Usage Examples
+
+### 1. 通过文件路径打开 PDF
+
+```csharp
+using XP.Common.PdfViewer.Interfaces;
+
+public class MyService
+{
+    private readonly IPdfViewerService _pdfViewerService;
+
+    public MyService(IPdfViewerService pdfViewerService)
+    {
+        _pdfViewerService = pdfViewerService;
+    }
+
+    public void OpenPdfByPath()
+    {
+        // 打开指定路径的 PDF 文件
+        _pdfViewerService.OpenViewer(@"C:\Documents\UserManual.pdf");
+    }
+}
+```
+
+### 2. 通过文件流打开 PDF
+
+```csharp
+public void OpenPdfByStream()
+{
+    // 从文件流打开 PDF（窗口标题可选）
+    using var stream = File.OpenRead(@"C:\Documents\UserManual.pdf");
+    _pdfViewerService.OpenViewer(stream, "用户手册.pdf");
+}
+```
+
+### 3. 静默打印到指定打印机
+
+```csharp
+using XP.Common.PdfViewer.Interfaces;
+
+public class MyService
+{
+    private readonly IPdfPrintService _printService;
+
+    public MyService(IPdfPrintService printService)
+    {
+        _printService = printService;
+    }
+
+    public void PrintPdf()
+    {
+        // 打印全部页面到指定打印机
+        _printService.Print(
+            filePath: @"C:\Documents\UserManual.pdf",
+            printerName: "HP LaserJet Pro",
+            pageFrom: null,  // null 表示从第一页
+            pageTo: null,    // null 表示到最后一页
+            copies: 1        // 打印 1 份
+        );
+
+        // 打印指定范围（第 1-3 页）
+        _printService.Print(
+            filePath: @"C:\Documents\UserManual.pdf",
+            printerName: "HP LaserJet Pro",
+            pageFrom: 1,
+            pageTo: 3,
+            copies: 2
+        );
+    }
+}
+```
+
+### 4. 打开打印设置对话框
+
+```csharp
+public void OpenPrintDialog()
+{
+    // 显示打印设置对话框，用户确认后打印
+    bool userConfirmed = _printService.PrintWithDialog(@"C:\Documents\UserManual.pdf");
+    
+    if (userConfirmed)
+    {
+        // 用户点击了"确定"按钮
+    }
+    else
+    {
+        // 用户点击了"取消"按钮
+    }
+}
+```
+
+### 5. 打开打印预览
+
+```csharp
+public void ShowPrintPreview()
+{
+    // 打开打印预览对话框
+    _printService.PrintPreview(@"C:\Documents\UserManual.pdf");
+}
+```
+
+---
+
+## DI 注册 | DI Registration
+
+在 `CommonModule.RegisterTypes` 中已注册为单例服务：
+
+```csharp
+containerRegistry.RegisterSingleton<IPdfPrintService, PdfPrintService>();
+containerRegistry.RegisterSingleton<IPdfViewerService, PdfViewerService>();
+```
+
+在 ViewModel 或 Service 中通过构造函数注入使用：
+
+```csharp
+public class MyViewModel
+{
+    private readonly IPdfViewerService _pdfViewerService;
+    private readonly IPdfPrintService _printService;
+
+    public MyViewModel(
+        IPdfViewerService pdfViewerService,
+        IPdfPrintService printService)
+    {
+        _pdfViewerService = pdfViewerService;
+        _printService = printService;
+    }
+}
+```
+
+---
+
+## 多语言资源 | Localization Resources
+
+PDF 模块支持多语言，资源键如下：
+
+| 资源键 | zh-CN | zh-TW | en-US |
+|--------|-------|-------|-------|
+| `PdfViewer_Title` | PDF 阅读器 | PDF 閱讀器 | PDF Viewer |
+| `PdfViewer_TitleWithFile` | PDF 阅读器 - {0} | PDF 閱讀器 - {0} | PDF Viewer - {0} |
+| `PdfViewer_LoadSuccess` | PDF 文件加载成功：{0}（{1} 页）| PDF 檔案載入成功：{0}（{1} 頁）| PDF loaded: {0} ({1} pages) |
+| `PdfViewer_LoadFailed` | PDF 文件加载失败 | PDF 檔案載入失敗 | PDF file load failed |
+| `PdfViewer_PrintSuccess` | 打印任务已提交：{0} → {1} | 列印任務已提交：{0} → {1} | Print job submitted: {0} → {1} |
+| `PdfViewer_PrintFailed` | 打印失败 | 列印失敗 | Print failed |
+| `PdfViewer_PrinterNotFound` | 打印机未找到：{0} | 印表機未找到：{0} | Printer not found: {0} |
+
+---
+
+## 异常处理 | Exception Handling
+
+| 异常类型 | 触发条件 | 说明 |
+|---------|---------|------|
+| `FileNotFoundException` | 文件路径不存在 | `OpenViewer(filePath)` 或 `Print(filePath, ...)` |
+| `ArgumentNullException` | 流参数为 null | `OpenViewer(null, ...)` |
+| `PdfLoadException` | PDF 格式无效或加载失败 | 文件损坏、非 PDF 格式等 |
+| `PrinterNotFoundException` | 指定打印机不存在 | `Print(filePath, printerName, ...)` |
+| `PrintException` | 打印过程中发生错误 | 打印机错误、驱动问题等 |
+
+---
+
+## 注意事项 | Notes
+
+1. **RadPdfViewerToolbar 内置功能**：页面导航（首页/上一页/下一页/末页）、缩放（放大/缩小/适合宽度/适合整页）、旋转（顺时针/逆时针）等功能由 RadPdfViewerToolbar 自动提供，无需手动实现。
+
+2. **资源释放**：`PdfViewerService` 实现 `IDisposable`，窗口��闭时会自动释放 PDF 文档资源。终结器作为安全网，确保未显式释放时也能清理资源。
+
+3. **多语言支持**：RadPdfViewerToolbar 的内置按钮文本（如"首页"、"上一页"、"放大"等）由 Telerik 自身的本地化机制管理，无需在 XP.Common 的 Resources 中维护。
+
+4. **打印设置**：Telerik 提供内置的 `PrintSettings` 类，无需自定义打印设置模型。
+
+5. **日志记录**：所有关键操作（加载成功/失败、打印成功/失败）都会通过 `ILoggerService` 记录结构化日志。
+
+---
+
+## 典型应用场景 | Typical Use Cases
+
+### 场景 1：主窗口添加"用户手册"按钮
+
+```csharp
+// MainWindowViewModel.cs
+private void ExecuteOpenUserManual()
+{
+    var manualPath = ConfigurationManager.AppSettings["UserManual"];
+    var stream = File.OpenRead(manualPath);
+    var fileName = Path.GetFileName(manualPath);
+    _pdfViewerService.OpenViewer(stream, fileName);
+}
+```
+
+### 场景 2：导出报告后自动打开 PDF 预览
+
+```csharp
+public void ExportAndPreview()
+{
+    // 生成 PDF 报告到临时文件
+    var tempPath = Path.Combine(Path.GetTempPath(), $"Report_{DateTime.Now:yyyyMMdd_HHmmss}.pdf");
+    GenerateReport(tempPath);
+
+    // 自动打开 PDF 预览
+    _pdfViewerService.OpenViewer(tempPath);
+}
+```
+
+### 场景 3：批量打印检测报告
+
+```csharp
+public void BatchPrintReports(List<string> reportPaths, string printerName)
+{
+    foreach (var path in reportPaths)
+    {
+        _printService.Print(
+            filePath: path,
+            printerName: printerName,
+            pageFrom: 1,
+            pageTo: null,
+            copies: 1
+        );
+    }
+}
+```

XP.Common/Documents/RealTimeLogViewer.Design.md

@@ -0,0 +1,50 @@
+# 实时日志查看器设计文档
+
+#### 1. 核心目标
+
+构建一个模态或非模态的 WPF 窗口，用于实时订阅 Serilog 事件，根据预定义的格式（如包含 `@l` 级别标记）自动渲染颜色，并提供过滤与自动滚动控制。
+
+---
+
+#### 2. 功能模块规划
+
+为了保证代码的可维护性和复用性，建议采用 MVVM 模式，参考 `XP.Common.GeneralForm` 的目录结构进行扩展：
+
+text
+
+编辑
+
+```
+XP.Common/
+└── GeneralForm/
+    └── Views/
+        ├── RealTimeLogViewer.xaml       // 视图：RichTextBox + 控制栏
+        └── RealTimeLogViewer.xaml.cs
+    └── ViewModels/
+        └── RealTimeLogViewerViewModel.cs // 核心逻辑：处理颜色标记、过滤、滚动
+```
+
+#### 3. 详细功能规格
+
+| 功能模块   | 详细描述                                                | 交互逻辑                                                                                                             |
+| ------ | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| 颜色渲染引擎 | 基于 Serilog 标记<br>解析日志事件中的 Level 或 Message Template。 | * Error/Fatal: 红色/深红色<br>* Warning: 橙色/黄色<br>* Info: 默认色<br>* Debug: 浅灰色<br>利用 `RichTextBox` 的 `TextRange` 动态追加。 |
+| 动态过滤器  | 关键词黑白名单                                             | * 包含: 仅显示包含关键字的行。<br>* 排除: 隐藏包含关键字的行。<br>* 重置: 恢复显示所有。                                                           |
+| 智能滚动   | 跟随开关                                                | * 开启: 新日志到达时，滚动条自动到底。<br>* 关闭: 用户可自由浏览历史，新日志仅在后台缓存/计数。                                                           |
+| 行数限制   | 内存保护机制                                              | * 配置: 默认 2000 行，可调。<br>* 清理: 达到上限后，自动移除最旧的文本段落（`Paragraph`）。                                                     |
+| 日志源接入  | 线程安全订阅                                              | 使用 `IObserver<LogEvent>` 或 `IObservable`，内部通过 `Dispatcher` 安全更新。                                                 |
+
+#### 4. 视觉交互 (UI/UX)
+
+- **布局**：
+  - **顶部工具栏**：包含“自动滚动”开关（带图标）、“清空日志”按钮、过滤输入框。
+  - **中部显示区**：`RichTextBox` (只读)，启用垂直滚动条。
+  - **底部状态栏**：显示当前总日志条数、过滤后的条数。
+- **性能优化**：
+  - 由于 WPF `RichTextBox` 在大量文本下性能较差，建议增加**最大行数限制**（如默认保留 4000 行，超出自动删除顶部旧日志）。
+
+#### 6. 开发建议
+
+1. **颜色解析**：如果 Serilog 输出的是纯文本（如 `[INF] User logged in`），你需要编写正则表达式来匹配 `[INF]`、`[ERR]` 等前缀并着色。
+2. **线程安全**：务必参考 `ProgressWindow` 中 `UpdateProgress` 的实现，使用 `Dispatcher.InvokeAsync` 或 `Dispatcher.CheckAccess` 来确保从后台线程（如 Serilog 的异步写入线程）更新 UI 时不会崩溃。
+3. **资源占用**：考虑到这是一个“基础设施”类库，建议在窗口关闭时（`OnClosed` 事件）取消对 `IObservable` 的订阅，防止内存泄漏。

XP.Common/Dump/Configs/DumpConfig.cs

@@ -0,0 +1,34 @@
+namespace XP.Common.Dump.Configs
+{
+    /// <summary>
+    /// Dump 功能配置实体（从 App.config 读取）
+    /// Dump feature configuration entity (loaded from App.config)
+    /// </summary>
+    public class DumpConfig
+    {
+        /// <summary>
+        /// Dump 文件存储路径 | Dump file storage path
+        /// </summary>
+        public string StoragePath { get; set; } = @"D:\XplorePlane\Dump";
+
+        /// <summary>
+        /// 是否启用定时触发 | Enable scheduled trigger
+        /// </summary>
+        public bool EnableScheduledDump { get; set; } = false;
+
+        /// <summary>
+        /// 定时触发间隔（分钟）| Scheduled trigger interval (minutes)
+        /// </summary>
+        public int ScheduledIntervalMinutes { get; set; } = 60;
+
+        /// <summary>
+        /// Mini Dump 文件大小上限（MB）| Mini Dump file size limit (MB)
+        /// </summary>
+        public long MiniDumpSizeLimitMB { get; set; } = 100;
+
+        /// <summary>
+        /// 文件保留天数 | File retention days
+        /// </summary>
+        public int RetentionDays { get; set; } = 7;
+    }
+}

XP.Common/Dump/Configs/DumpTriggerType.cs

@@ -0,0 +1,23 @@
+namespace XP.Common.Dump.Configs
+{
+    /// <summary>
+    /// Dump 触发类型 | Dump trigger type
+    /// </summary>
+    public enum DumpTriggerType
+    {
+        /// <summary>
+        /// 崩溃触发 | Crash trigger
+        /// </summary>
+        Crash,
+
+        /// <summary>
+        /// 定时触发 | Scheduled trigger
+        /// </summary>
+        Scheduled,
+
+        /// <summary>
+        /// 手动触发 | Manual trigger
+        /// </summary>
+        Manual
+    }
+}

XP.Common/Dump/Implementations/DumpCleaner.cs

@@ -0,0 +1,69 @@
+using System;
+using System.IO;
+using System.Linq;
+using XP.Common.Dump.Configs;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.Dump.Implementations
+{
+    /// <summary>
+    /// Dump 文件自动清理组件，按保留天数策略删除过期文件
+    /// Auto cleanup component for dump files, deletes expired files based on retention policy
+    /// </summary>
+    internal class DumpCleaner
+    {
+        private readonly DumpConfig _config;
+        private readonly ILoggerService _logger;
+
+        public DumpCleaner(DumpConfig config, ILoggerService logger)
+        {
+            _config = config ?? throw new ArgumentNullException(nameof(config));
+            _logger = logger?.ForModule<DumpCleaner>() ?? throw new ArgumentNullException(nameof(logger));
+        }
+
+        /// <summary>
+        /// 执行清理操作：删除超过保留天数的 .dmp 文件
+        /// Execute cleanup: delete .dmp files older than retention days
+        /// </summary>
+        public void CleanExpiredFiles()
+        {
+            try
+            {
+                if (!Directory.Exists(_config.StoragePath))
+                {
+                    _logger.Debug("存储目录不存在，跳过清理：{Path} | Storage directory does not exist, skipping cleanup: {Path}", _config.StoragePath);
+                    return;
+                }
+
+                var dmpFiles = Directory.GetFiles(_config.StoragePath, "*.dmp");
+                var cutoffTime = DateTime.Now.AddDays(-_config.RetentionDays);
+                var deletedCount = 0;
+
+                foreach (var filePath in dmpFiles)
+                {
+                    try
+                    {
+                        var creationTime = File.GetCreationTime(filePath);
+                        if (creationTime < cutoffTime)
+                        {
+                            var fileName = Path.GetFileName(filePath);
+                            File.Delete(filePath);
+                            deletedCount++;
+                            _logger.Info("已删除过期 Dump 文件：{FileName} | Deleted expired dump file: {FileName}", fileName);
+                        }
+                    }
+                    catch (Exception ex)
+                    {
+                        _logger.Error(ex, "删除 Dump 文件失败：{FilePath} | Failed to delete dump file: {FilePath}", filePath);
+                    }
+                }
+
+                _logger.Info("Dump 清理完成，共删除 {Count} 个文件 | Dump cleanup completed, {Count} files deleted", deletedCount);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "Dump 清理过程发生异常：{Message} | Dump cleanup error: {Message}", ex.Message);
+            }
+        }
+    }
+}

XP.Common/Dump/Implementations/DumpService.cs

@@ -0,0 +1,321 @@
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Runtime.InteropServices;
+using System.Threading;
+using System.Threading.Tasks;
+using XP.Common.Dump.Configs;
+using XP.Common.Dump.Interfaces;
+using XP.Common.Dump.Native;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.Dump.Implementations
+{
+    /// <summary>
+    /// Dump 文件管理服务实现，负责 Dump 生成、崩溃事件订阅、定时调度和清理
+    /// Dump file management service implementation, handles dump generation, crash event subscription, scheduled tasks and cleanup
+    /// </summary>
+    public class DumpService : IDumpService
+    {
+        private readonly DumpConfig _config;
+        private readonly ILoggerService _logger;
+        private readonly DumpCleaner _cleaner;
+        private Timer? _scheduledTimer;
+        private Timer? _cleanupTimer;
+        private bool _isStarted;
+        private bool _disposed;
+
+        /// <summary>
+        /// 默认存储路径 | Default storage path
+        /// </summary>
+        private const string DefaultStoragePath = @"D:\XplorePlane\Dump";
+
+        public DumpService(DumpConfig config, ILoggerService logger)
+        {
+            _config = config ?? throw new ArgumentNullException(nameof(config));
+            _logger = logger?.ForModule<DumpService>() ?? throw new ArgumentNullException(nameof(logger));
+            _cleaner = new DumpCleaner(config, logger);
+        }
+
+        /// <summary>
+        /// 生成 Dump 文件名（纯函数）| Generate dump file name (pure function)
+        /// 格式：XplorePlane_{yyyyMMdd_HHmm}_{TriggerType}.dmp
+        /// </summary>
+        /// <param name="triggerType">触发类型 | Trigger type</param>
+        /// <param name="timestamp">时间戳 | Timestamp</param>
+        /// <returns>文件名 | File name</returns>
+        internal static string GenerateFileName(DumpTriggerType triggerType, DateTime timestamp)
+        {
+            return $"XplorePlane_{timestamp:yyyyMMdd_HHmm}_{triggerType}.dmp";
+        }
+
+        /// <summary>
+        /// 验证 Mini Dump 文件大小是否在限制范围内 | Validate Mini Dump file size is within limit
+        /// </summary>
+        /// <param name="fileSizeBytes">文件大小（字节）| File size in bytes</param>
+        /// <param name="sizeLimitMB">大小限制（MB）| Size limit in MB</param>
+        /// <returns>true 表示在限制内 | true if within limit</returns>
+        internal static bool ValidateFileSize(long fileSizeBytes, long sizeLimitMB)
+        {
+            return fileSizeBytes <= sizeLimitMB * 1024 * 1024;
+        }
+
+        /// <summary>
+        /// 写入 Dump 文件的核心方法 | Core method to write dump file
+        /// </summary>
+        /// <param name="triggerType">触发类型 | Trigger type</param>
+        /// <param name="isMiniDump">是否为 Mini Dump | Whether it is a Mini Dump</param>
+        /// <returns>生成的文件完整路径，失败返回 null | Full path of generated file, null on failure</returns>
+        private string? WriteDump(DumpTriggerType triggerType, bool isMiniDump)
+        {
+            try
+            {
+                // 非手动触发请求 Full Dump 时，降级为 Mini Dump | Downgrade to Mini Dump for non-manual Full Dump requests
+                if (!isMiniDump && triggerType != DumpTriggerType.Manual)
+                {
+                    _logger.Warn("非手动触发不允许生成 Full Dump，已降级为 Mini Dump：{TriggerType} | Non-manual trigger cannot generate Full Dump, downgraded to Mini Dump: {TriggerType}", triggerType);
+                    isMiniDump = true;
+                }
+
+                var fileName = GenerateFileName(triggerType, DateTime.Now);
+                var filePath = Path.Combine(_config.StoragePath, fileName);
+
+                // 确定 Dump 类型标志 | Determine dump type flags
+                uint dumpType = isMiniDump
+                    ? (uint)(MiniDumpType.MiniDumpWithDataSegs | MiniDumpType.MiniDumpWithHandleData | MiniDumpType.MiniDumpWithThreadInfo)
+                    : (uint)MiniDumpType.MiniDumpWithFullMemory;
+
+                var process = Process.GetCurrentProcess();
+
+                using (var fileStream = new FileStream(filePath, FileMode.Create, FileAccess.ReadWrite, FileShare.None))
+                {
+                    bool success = NativeMethods.MiniDumpWriteDump(
+                        process.Handle,
+                        (uint)process.Id,
+                        fileStream.SafeFileHandle,
+                        dumpType,
+                        IntPtr.Zero,
+                        IntPtr.Zero,
+                        IntPtr.Zero);
+
+                    if (!success)
+                    {
+                        var errorCode = Marshal.GetLastWin32Error();
+                        _logger.Error(null!, "MiniDumpWriteDump 调用失败，错误码：{ErrorCode} | MiniDumpWriteDump failed, error code: {ErrorCode}", errorCode);
+                        // 清理失败的文件 | Clean up failed file
+                        try { File.Delete(filePath); } catch { }
+                        return null;
+                    }
+                }
+
+                // Mini Dump 文件大小检查 | Mini Dump file size check
+                if (isMiniDump)
+                {
+                    var fileInfo = new FileInfo(filePath);
+                    if (!ValidateFileSize(fileInfo.Length, _config.MiniDumpSizeLimitMB))
+                    {
+                        _logger.Warn("Mini Dump 文件超过大小限制（{SizeMB}MB），已删除：{FilePath} | Mini Dump file exceeds size limit ({SizeMB}MB), deleted: {FilePath}",
+                            _config.MiniDumpSizeLimitMB, filePath);
+                        File.Delete(filePath);
+                        return null;
+                    }
+                }
+
+                var dumpTypeStr = isMiniDump ? "Mini" : "Full";
+                _logger.Info("Dump 文件已生成：{FilePath}，触发类型：{TriggerType}，Dump 类型：{DumpType} | Dump file generated: {FilePath}, trigger: {TriggerType}, type: {DumpType}",
+                    filePath, triggerType, dumpTypeStr);
+
+                return filePath;
+            }
+            catch (IOException ex)
+            {
+                _logger.Error(ex, "Dump 文件写入失败：{Message} | Dump file write failed: {Message}", ex.Message);
+                return null;
+            }
+            catch (UnauthorizedAccessException ex)
+            {
+                _logger.Error(ex, "Dump 文件写入权限不足：{Message} | Dump file write permission denied: {Message}", ex.Message);
+                return null;
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "Dump 文件生成异常：{Message} | Dump file generation error: {Message}", ex.Message);
+                return null;
+            }
+        }
+
+        #region 手动触发方法 | Manual trigger methods
+
+        /// <inheritdoc />
+        public string? CreateMiniDump()
+        {
+            _logger.Info("手动触发 Mini Dump 生成 | Manually triggering Mini Dump generation");
+            var filePath = WriteDump(DumpTriggerType.Manual, isMiniDump: true);
+            if (filePath != null)
+            {
+                _logger.Info("手动 Mini Dump 已生成：{FilePath} | Manual Mini Dump generated: {FilePath}", filePath);
+            }
+            return filePath;
+        }
+
+        /// <inheritdoc />
+        public string? CreateFullDump()
+        {
+            _logger.Info("手动触发 Full Dump 生成 | Manually triggering Full Dump generation");
+            var filePath = WriteDump(DumpTriggerType.Manual, isMiniDump: false);
+            if (filePath != null)
+            {
+                _logger.Info("手动 Full Dump 已生成：{FilePath} | Manual Full Dump generated: {FilePath}", filePath);
+            }
+            return filePath;
+        }
+
+        #endregion
+
+        #region 生命周期管理 | Lifecycle management
+
+        /// <inheritdoc />
+        public void Start()
+        {
+            if (_isStarted) return;
+
+            _logger.Info("Dump 服务启动中 | Dump service starting");
+
+            // 确保存储目录存在 | Ensure storage directory exists
+            EnsureStorageDirectory();
+
+            // 订阅崩溃事件 | Subscribe to crash events
+            AppDomain.CurrentDomain.UnhandledException += OnUnhandledException;
+            TaskScheduler.UnobservedTaskException += OnUnobservedTaskException;
+
+            // 启动定时 Dump 计时器 | Start scheduled dump timer
+            if (_config.EnableScheduledDump)
+            {
+                var intervalMs = _config.ScheduledIntervalMinutes * 60 * 1000;
+                _scheduledTimer = new Timer(OnScheduledDumpCallback, null, intervalMs, intervalMs);
+                _logger.Info("定时 Dump 已启用，间隔：{Interval} 分钟 | Scheduled dump enabled, interval: {Interval} minutes", _config.ScheduledIntervalMinutes);
+            }
+
+            // 启动每日清理计时器（每24小时执行一次）| Start daily cleanup timer (every 24 hours)
+            var dailyMs = 24 * 60 * 60 * 1000;
+            _cleanupTimer = new Timer(OnCleanupCallback, null, dailyMs, dailyMs);
+
+            // 立即执行一次清理 | Execute cleanup immediately
+            _cleaner.CleanExpiredFiles();
+
+            _isStarted = true;
+            _logger.Info("Dump 服务已启动 | Dump service started");
+        }
+
+        /// <inheritdoc />
+        public void Stop()
+        {
+            if (!_isStarted) return;
+
+            _logger.Info("Dump 服务停止中 | Dump service stopping");
+
+            // 取消事件订阅 | Unsubscribe from events
+            AppDomain.CurrentDomain.UnhandledException -= OnUnhandledException;
+            TaskScheduler.UnobservedTaskException -= OnUnobservedTaskException;
+
+            // 停止所有计时器 | Stop all timers
+            _scheduledTimer?.Change(Timeout.Infinite, Timeout.Infinite);
+            _cleanupTimer?.Change(Timeout.Infinite, Timeout.Infinite);
+
+            _isStarted = false;
+            _logger.Info("Dump 服务已停止 | Dump service stopped");
+        }
+
+        /// <inheritdoc />
+        public void Dispose()
+        {
+            if (_disposed) return;
+
+            Stop();
+
+            _scheduledTimer?.Dispose();
+            _scheduledTimer = null;
+
+            _cleanupTimer?.Dispose();
+            _cleanupTimer = null;
+
+            _disposed = true;
+        }
+
+        #endregion
+
+        #region 内部方法 | Internal methods
+
+        /// <summary>
+        /// 确保存储目录存在，不存在则创建，创建失败回退默认路径
+        /// Ensure storage directory exists, create if not, fallback to default on failure
+        /// </summary>
+        private void EnsureStorageDirectory()
+        {
+            try
+            {
+                if (!Directory.Exists(_config.StoragePath))
+                {
+                    Directory.CreateDirectory(_config.StoragePath);
+                    _logger.Info("已创建存储目录：{Path} | Created storage directory: {Path}", _config.StoragePath);
+                }
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "存储目录创建失败：{Path}，回退到默认路径 | Storage directory creation failed: {Path}, falling back to default", _config.StoragePath);
+                _config.StoragePath = DefaultStoragePath;
+
+                try
+                {
+                    if (!Directory.Exists(DefaultStoragePath))
+                    {
+                        Directory.CreateDirectory(DefaultStoragePath);
+                        _logger.Info("已创建默认存储目录：{Path} | Created default storage directory: {Path}", DefaultStoragePath);
+                    }
+                }
+                catch (Exception fallbackEx)
+                {
+                    _logger.Fatal(fallbackEx, "默认存储目录创建也失败：{Path} | Default storage directory creation also failed: {Path}", DefaultStoragePath);
+                }
+            }
+        }
+
+        /// <summary>
+        /// 未处理异常回调 | Unhandled exception callback
+        /// </summary>
+        private void OnUnhandledException(object sender, UnhandledExceptionEventArgs e)
+        {
+            _logger.Info("检测到未处理异常，正在生成崩溃 Dump | Unhandled exception detected, generating crash dump");
+            WriteDump(DumpTriggerType.Crash, isMiniDump: true);
+        }
+
+        /// <summary>
+        /// 未观察到的 Task 异常回调 | Unobserved task exception callback
+        /// </summary>
+        private void OnUnobservedTaskException(object? sender, UnobservedTaskExceptionEventArgs e)
+        {
+            _logger.Info("检测到未观察的 Task 异常，正在生成崩溃 Dump | Unobserved task exception detected, generating crash dump");
+            WriteDump(DumpTriggerType.Crash, isMiniDump: true);
+        }
+
+        /// <summary>
+        /// 定时 Dump 回调 | Scheduled dump callback
+        /// </summary>
+        private void OnScheduledDumpCallback(object? state)
+        {
+            _logger.Debug("定时 Dump 触发 | Scheduled dump triggered");
+            WriteDump(DumpTriggerType.Scheduled, isMiniDump: true);
+        }
+
+        /// <summary>
+        /// 清理回调 | Cleanup callback
+        /// </summary>
+        private void OnCleanupCallback(object? state)
+        {
+            _logger.Debug("定时清理触发 | Scheduled cleanup triggered");
+            _cleaner.CleanExpiredFiles();
+        }
+
+        #endregion
+    }
+}

XP.Common/Dump/Interfaces/IDumpService.cs

@@ -0,0 +1,32 @@
+using System;
+
+namespace XP.Common.Dump.Interfaces
+{
+    /// <summary>
+    /// Dump 文件管理服务接口 | Dump file management service interface
+    /// </summary>
+    public interface IDumpService : IDisposable
+    {
+        /// <summary>
+        /// 手动触发 Mini Dump 生成 | Manually trigger Mini Dump generation
+        /// </summary>
+        /// <returns>生成的 Dump 文件完整路径，失败返回 null | Full path of generated dump file, null on failure</returns>
+        string? CreateMiniDump();
+
+        /// <summary>
+        /// 手动触发 Full Dump 生成 | Manually trigger Full Dump generation
+        /// </summary>
+        /// <returns>生成的 Dump 文件完整路径，失败返回 null | Full path of generated dump file, null on failure</returns>
+        string? CreateFullDump();
+
+        /// <summary>
+        /// 启动服务（订阅崩溃事件、启动定时任务和清理任务）| Start service (subscribe crash events, start scheduled and cleanup tasks)
+        /// </summary>
+        void Start();
+
+        /// <summary>
+        /// 停止服务（取消定时任务、取消事件订阅）| Stop service (cancel scheduled tasks, unsubscribe events)
+        /// </summary>
+        void Stop();
+    }
+}

XP.Common/Dump/Native/MiniDumpType.cs

@@ -0,0 +1,37 @@
+using System;
+
+namespace XP.Common.Dump.Native
+{
+    /// <summary>
+    /// MiniDump 类型标志，用于 MiniDumpWriteDump 的 dumpType 参数
+    /// MiniDump type flags for MiniDumpWriteDump dumpType parameter
+    /// </summary>
+    [Flags]
+    internal enum MiniDumpType : uint
+    {
+        /// <summary>
+        /// 仅包含基本信息 | Basic information only
+        /// </summary>
+        MiniDumpNormal = 0x00000000,
+
+        /// <summary>
+        /// 包含数据段信息 | Include data segment information
+        /// </summary>
+        MiniDumpWithDataSegs = 0x00000001,
+
+        /// <summary>
+        /// 包含完整内存信息（Full Dump 使用）| Include full memory (used for Full Dump)
+        /// </summary>
+        MiniDumpWithFullMemory = 0x00000002,
+
+        /// <summary>
+        /// 包含句柄信息 | Include handle information
+        /// </summary>
+        MiniDumpWithHandleData = 0x00000004,
+
+        /// <summary>
+        /// 包含线程信息 | Include thread information
+        /// </summary>
+        MiniDumpWithThreadInfo = 0x00001000,
+    }
+}

XP.Common/Dump/Native/NativeMethods.cs

@@ -0,0 +1,25 @@
+using System;
+using System.Runtime.InteropServices;
+using Microsoft.Win32.SafeHandles;
+
+namespace XP.Common.Dump.Native
+{
+    /// <summary>
+    /// Windows 原生方法 P/Invoke 声明 | Windows native method P/Invoke declarations
+    /// </summary>
+    internal static class NativeMethods
+    {
+        /// <summary>
+        /// 将进程的 Mini Dump 写入指定文件 | Write a Mini Dump of the process to the specified file
+        /// </summary>
+        [DllImport("dbghelp.dll", SetLastError = true)]
+        internal static extern bool MiniDumpWriteDump(
+            IntPtr hProcess,
+            uint processId,
+            SafeHandle hFile,
+            uint dumpType,
+            IntPtr exceptionParam,
+            IntPtr userStreamParam,
+            IntPtr callbackParam);
+    }
+}

XP.Common/GeneralForm/ViewModels/InputDialogViewModel.cs

@@ -0,0 +1,109 @@
+using System;
+using Prism.Mvvm;
+using XP.Common.Localization;
+
+namespace XP.Common.GeneralForm.ViewModels
+{
+    /// <summary>
+    /// 输入对话框 ViewModel | Input dialog ViewModel
+    /// </summary>
+    public class InputDialogViewModel : BindableBase
+    {
+        private readonly Func<string, string?>? _validate;
+        private string _inputText;
+        private string? _validationError;
+
+        /// <summary>
+        /// 窗口标题 | Window title
+        /// </summary>
+        public string Title { get; }
+
+        /// <summary>
+        /// 提示文本 | Prompt text
+        /// </summary>
+        public string Prompt { get; }
+
+        /// <summary>
+        /// 确定按钮文本（多语言）| OK button text (localized)
+        /// </summary>
+        public string OkText { get; }
+
+        /// <summary>
+        /// 取消按钮文本（多语言）| Cancel button text (localized)
+        /// </summary>
+        public string CancelText { get; }
+
+        /// <summary>
+        /// 用户输入的文本 | User input text
+        /// </summary>
+        public string InputText
+        {
+            get => _inputText;
+            set
+            {
+                if (SetProperty(ref _inputText, value))
+                {
+                    // 输入变化时清除验证错误 | Clear validation error on input change
+                    ValidationError = null;
+                }
+            }
+        }
+
+        /// <summary>
+        /// 验证错误信息，null 表示无错误 | Validation error message, null means no error
+        /// </summary>
+        public string? ValidationError
+        {
+            get => _validationError;
+            set
+            {
+                if (SetProperty(ref _validationError, value))
+                {
+                    RaisePropertyChanged(nameof(HasValidationError));
+                }
+            }
+        }
+
+        /// <summary>
+        /// 是否存在验证错误 | Whether there is a validation error
+        /// </summary>
+        public bool HasValidationError => !string.IsNullOrEmpty(ValidationError);
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="prompt">提示文本 | Prompt text</param>
+        /// <param name="title">窗口标题 | Window title</param>
+        /// <param name="defaultValue">默认值 | Default value</param>
+        /// <param name="validate">验证委托，返回 null 表示通过，返回错误信息则显示 | Validation delegate</param>
+        public InputDialogViewModel(
+            string prompt,
+            string title,
+            string defaultValue = "",
+            Func<string, string?>? validate = null)
+        {
+            Prompt = prompt;
+            Title = title;
+            _inputText = defaultValue;
+            _validate = validate;
+
+            // 按钮文本使用多语言 | Button text uses localization
+            OkText = LocalizationHelper.Get("Button_OK");
+            CancelText = LocalizationHelper.Get("Button_Cancel");
+        }
+
+        /// <summary>
+        /// 执行验证，返回是否通过 | Run validation, returns whether it passed
+        /// </summary>
+        /// <returns>true 表示验证通过 | true means validation passed</returns>
+        public bool Validate()
+        {
+            if (_validate == null)
+                return true;
+
+            var error = _validate(InputText);
+            ValidationError = error;
+            return error == null;
+        }
+    }
+}

XP.Common/GeneralForm/ViewModels/ProgressWindowViewModel.cs

@@ -0,0 +1,103 @@
+using System;
+using Prism.Mvvm;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.GeneralForm.ViewModels
+{
+    /// <summary>
+    /// 进度条窗口 ViewModel，管理进度数据和窗口行为逻辑
+    /// </summary>
+    public class ProgressWindowViewModel : BindableBase
+    {
+        private readonly ILoggerService? _logger;
+        private string _message;
+        private double _progress;
+
+        /// <summary>
+        /// 窗口标题（只读）
+        /// </summary>
+        public string Title { get; }
+
+        /// <summary>
+        /// 提示信息文本
+        /// </summary>
+        public string Message
+        {
+            get => _message;
+            set => SetProperty(ref _message, value);
+        }
+
+        /// <summary>
+        /// 进度值，范围 0-100
+        /// </summary>
+        public double Progress
+        {
+            get => _progress;
+            set
+            {
+                if (SetProperty(ref _progress, value))
+                {
+                    RaisePropertyChanged(nameof(ProgressText));
+                }
+            }
+        }
+
+        /// <summary>
+        /// 百分比显示文本，由 Progress 自动计算（只读）
+        /// </summary>
+        public string ProgressText => $"{Math.Floor(Progress)}%";
+
+        /// <summary>
+        /// 是否允许用户关闭窗口（只读）
+        /// </summary>
+        public bool IsCancelable { get; }
+
+        /// <summary>
+        /// 构造函数
+        /// </summary>
+        /// <param name="title">窗口标题</param>
+        /// <param name="message">提示信息</param>
+        /// <param name="progress">初始进度值</param>
+        /// <param name="isCancelable">是否允许取消</param>
+        /// <param name="logger">日志服务（可选）</param>
+        public ProgressWindowViewModel(
+            string title = "操作进行中",
+            string message = "请稍候...",
+            double progress = 0,
+            bool isCancelable = true,
+            ILoggerService? logger = null)
+        {
+            Title = title;
+            _message = message;
+            _progress = progress;
+            IsCancelable = isCancelable;
+
+            // 创建模块化日志实例（logger 为 null 时静默跳过）
+            _logger = logger?.ForModule<ProgressWindowViewModel>();
+
+            // 构造时记录 Info 级别日志
+            _logger?.Info("进度窗口已创建：Title={Title}, IsCancelable={IsCancelable}", Title, IsCancelable);
+        }
+
+        /// <summary>
+        /// 更新进度和提示信息（唯一的外部更新入口）
+        /// </summary>
+        /// <param name="message">提示信息文本</param>
+        /// <param name="progress">进度值，超出 [0, 100] 范围时自动修正</param>
+        public void UpdateProgress(string message, double progress)
+        {
+            // 检查 progress 是否超出有效范围，记录 Warn 日志
+            if (progress < 0 || progress > 100)
+            {
+                _logger?.Warn("进度值超出有效范围 [0, 100]：{Progress}，将自动修正", progress);
+            }
+
+            // 将 progress 值 Clamp 到 [0, 100] 范围
+            progress = Math.Clamp(progress, 0, 100);
+
+            // 更新属性，触发 PropertyChanged 通知
+            Message = message;
+            Progress = progress;
+        }
+    }
+}

XP.Common/GeneralForm/Views/InputDialog.xaml

@@ -0,0 +1,66 @@
+<Window x:Class="XP.Common.GeneralForm.Views.InputDialog"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation"
+        Title="{Binding Title}"
+        WindowStartupLocation="CenterOwner"
+        ResizeMode="NoResize"
+        Width="400" Height="180"
+        ShowInTaskbar="False"
+        Topmost="True"
+        WindowStyle="SingleBorderWindow">
+
+    <Window.Resources>
+        <BooleanToVisibilityConverter x:Key="BoolToVisibilityConverter"/>
+    </Window.Resources>
+
+    <Grid Margin="20,16,20,16">
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="*"/>
+            <RowDefinition Height="Auto"/>
+        </Grid.RowDefinitions>
+
+        <!-- 提示文本 | Prompt text -->
+        <TextBlock Grid.Row="0"
+                   Text="{Binding Prompt}"
+                   TextWrapping="Wrap"
+                   FontSize="13"
+                   Foreground="#FF333333"
+                   Margin="0,0,0,8"/>
+
+        <!-- 输入框 | Input text box -->
+        <telerik:RadWatermarkTextBox Grid.Row="1"
+                                     Text="{Binding InputText, UpdateSourceTrigger=PropertyChanged}"
+                                     Height="28"
+                                     FontSize="13"
+                                     telerik:StyleManager.Theme="Crystal"
+                                     Margin="0,0,0,2"/>
+
+        <!-- 验证错误提示 | Validation error message -->
+        <TextBlock Grid.Row="2"
+                   Text="{Binding ValidationError}"
+                   Foreground="#FFD32F2F"
+                   FontSize="11"
+                   TextWrapping="Wrap"
+                   Margin="0,7,0,0"
+                   Visibility="{Binding HasValidationError, Converter={StaticResource BoolToVisibilityConverter}}"/>
+
+        <!-- 按钮区域 | Button area -->
+        <StackPanel Grid.Row="4" Orientation="Horizontal" HorizontalAlignment="Right">
+            <telerik:RadButton Content="{Binding OkText}"
+                               Click="OnOkClick"
+                               Width="80" Height="28"
+                               Margin="0,0,8,0"
+                               IsDefault="True"
+                               telerik:StyleManager.Theme="Crystal"/>
+            <telerik:RadButton Content="{Binding CancelText}"
+                               Click="OnCancelClick"
+                               Width="80" Height="28"
+                               IsCancel="True"
+                               telerik:StyleManager.Theme="Crystal"/>
+        </StackPanel>
+    </Grid>
+</Window>

XP.Common/GeneralForm/Views/InputDialog.xaml.cs

@@ -0,0 +1,92 @@
+using System;
+using System.Windows;
+using XP.Common.GeneralForm.ViewModels;
+using XP.Common.Localization;
+
+namespace XP.Common.GeneralForm.Views
+{
+    /// <summary>
+    /// 通用输入对话框，支持单行文本输入和可选的输入验证
+    /// General input dialog with single-line text input and optional validation
+    /// </summary>
+    public partial class InputDialog : Window
+    {
+        private readonly InputDialogViewModel _viewModel;
+
+        /// <summary>
+        /// 用户输入的结果，取消时为 null | User input result, null if cancelled
+        /// </summary>
+        public string? Result { get; private set; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="prompt">提示文本 | Prompt text</param>
+        /// <param name="title">窗口标题 | Window title</param>
+        /// <param name="defaultValue">默认值 | Default value</param>
+        /// <param name="validate">可选的验证委托，返回 null 表示通过，返回错误信息则阻止确认 | Optional validation delegate</param>
+        public InputDialog(
+            string prompt,
+            string title,
+            string defaultValue = "",
+            Func<string, string?>? validate = null)
+        {
+            _viewModel = new InputDialogViewModel(prompt, title, defaultValue, validate);
+            DataContext = _viewModel;
+
+            InitializeComponent();
+
+            // 继承调用方窗口图标 | Inherit caller window icon
+            if (Application.Current?.MainWindow != null)
+            {
+                Icon = Application.Current.MainWindow.Icon;
+            }
+        }
+
+        /// <summary>
+        /// 确定按钮点击事件 | OK button click handler
+        /// </summary>
+        private void OnOkClick(object sender, RoutedEventArgs e)
+        {
+            // 执行验证 | Run validation
+            if (!_viewModel.Validate())
+                return;
+
+            Result = _viewModel.InputText;
+            DialogResult = true;
+        }
+
+        /// <summary>
+        /// 取消按钮点击事件 | Cancel button click handler
+        /// </summary>
+        private void OnCancelClick(object sender, RoutedEventArgs e)
+        {
+            Result = null;
+            DialogResult = false;
+        }
+
+        /// <summary>
+        /// 静态便捷方法，显示输入对话框并返回结果 | Static convenience method
+        /// </summary>
+        /// <param name="prompt">提示文本 | Prompt text</param>
+        /// <param name="title">窗口标题 | Window title</param>
+        /// <param name="defaultValue">默认值 | Default value</param>
+        /// <param name="validate">可选的验证委托 | Optional validation delegate</param>
+        /// <param name="owner">父窗口（可选）| Owner window (optional)</param>
+        /// <returns>用户输入的值，取消时返回 null | User input, null if cancelled</returns>
+        public static string? Show(
+            string prompt,
+            string title,
+            string defaultValue = "",
+            Func<string, string?>? validate = null,
+            Window? owner = null)
+        {
+            var dialog = new InputDialog(prompt, title, defaultValue, validate);
+            // owner 未指定时自动回退到主窗口，确保对话框有父窗口约束不会被遮挡
+            // Fall back to MainWindow if owner not specified, ensuring dialog stays in front
+            dialog.Owner = owner ?? Application.Current?.MainWindow;
+            dialog.ShowDialog();
+            return dialog.Result;
+        }
+    }
+}

XP.Common/GeneralForm/Views/ProgressWindow.xaml

@@ -0,0 +1,43 @@
+<Window
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation" x:Class="XP.Common.GeneralForm.Views.ProgressWindow"
+        Title="{Binding Title}"
+        WindowStartupLocation="CenterScreen"
+        ResizeMode="NoResize"
+        Width="400"
+        Height="150"
+        ShowInTaskbar="False"
+        WindowStyle="SingleBorderWindow">
+
+    <!-- 主布局：从上到下依次为提示信息、进度条、百分比文本 -->
+    <Grid Margin="24,20,24,20">
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto" />
+            <RowDefinition Height="Auto" />
+            <RowDefinition Height="Auto" />
+        </Grid.RowDefinitions>
+
+        <!-- 提示信息文本 -->
+        <TextBlock Grid.Row="0"
+                   Text="{Binding Message}"
+                   TextWrapping="Wrap"
+                   FontSize="14"
+                   Margin="0,0,0,12" />
+
+        <!-- 进度条 -->
+        <telerik:RadProgressBar Grid.Row="1"
+                     Value="{Binding Progress, Mode=OneWay}"
+                     Minimum="0"
+                     Maximum="100"
+                     Height="18"
+                     Margin="0,0,0,8" telerik:StyleManager.Theme="Crystal" />
+
+        <!-- 百分比文本 -->
+        <TextBlock Grid.Row="2"
+                   Text="{Binding ProgressText}"
+                   HorizontalAlignment="Center"
+                   FontSize="12"
+                   Foreground="#666666" />
+    </Grid>
+</Window>

XP.Common/GeneralForm/Views/ProgressWindow.xaml.cs

@@ -0,0 +1,180 @@
+using System;
+using System.ComponentModel;
+using System.Runtime.InteropServices;
+using System.Threading.Tasks;
+using System.Windows;
+using System.Windows.Interop;
+using XP.Common.GeneralForm.ViewModels;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.GeneralForm.Views
+{
+    /// <summary>
+    /// 通用进度条模态窗口，支持线程安全的进度更新和关闭操作
+    /// </summary>
+    public partial class ProgressWindow : Window
+    {
+        #region Win32 API
+
+        [DllImport("user32.dll")]
+        private static extern IntPtr GetSystemMenu(IntPtr hWnd, bool bRevert);
+
+        [DllImport("user32.dll")]
+        private static extern bool EnableMenuItem(IntPtr hMenu, uint uIDEnableItem, uint uEnable);
+
+        private const uint SC_CLOSE = 0xF060;
+        private const uint MF_BYCOMMAND = 0x00000000;
+        private const uint MF_GRAYED = 0x00000001;
+        private const uint MF_ENABLED = 0x00000000;
+
+        #endregion
+
+        private readonly ProgressWindowViewModel _viewModel;
+        private readonly ILoggerService? _logger;
+        private bool _isClosingByCode;
+
+        /// <summary>
+        /// 构造函数
+        /// </summary>
+        /// <param name="title">窗口标题</param>
+        /// <param name="message">提示信息</param>
+        /// <param name="isCancelable">是否允许用户关闭窗口</param>
+        /// <param name="logger">日志服务（可选）</param>
+        public ProgressWindow(
+            string title = "操作进行中",
+            string message = "请稍候...",
+            bool isCancelable = true,
+            ILoggerService? logger = null)
+        {
+            // 创建 ViewModel 并设置为 DataContext
+            _viewModel = new ProgressWindowViewModel(title, message, 0, isCancelable, logger);
+            DataContext = _viewModel;
+
+            // 保存日志服务引用，用于 View 层日志记录
+            _logger = logger?.ForModule<ProgressWindow>();
+
+            InitializeComponent();
+
+            // 继承主窗口图标
+            if (Application.Current?.MainWindow != null)
+            {
+                Icon = Application.Current.MainWindow.Icon;
+            }
+
+            // 订阅 Closing 事件，拦截用户手动关闭
+            Closing += OnWindowClosing;
+        }
+
+        /// <summary>
+        /// 更新进度和提示信息（线程安全，可从任意线程调用）
+        /// </summary>
+        /// <param name="message">提示信息文本</param>
+        /// <param name="progress">进度值</param>
+        public void UpdateProgress(string message, double progress)
+        {
+            try
+            {
+                if (Dispatcher.CheckAccess())
+                {
+                    _viewModel.UpdateProgress(message, progress);
+                }
+                else
+                {
+                    Dispatcher.Invoke(() => _viewModel.UpdateProgress(message, progress));
+                }
+            }
+            catch (TaskCanceledException)
+            {
+                // 窗口已关闭时 Dispatcher 调度可能抛出此异常，静默处理
+            }
+            catch (Exception)
+            {
+                // 其他调度异常静默处理，避免影响调用方
+            }
+        }
+
+        /// <summary>
+        /// 线程安全关闭窗口（使用 new 关键字隐藏基类 Close 方法，因为 Window.Close() 不是虚方法）
+        /// </summary>
+        public new void Close()
+        {
+            try
+            {
+                _isClosingByCode = true;
+
+                if (Dispatcher.CheckAccess())
+                {
+                    _logger?.Info("进度窗口正在关闭：Title={Title}", _viewModel.Title);
+                    base.Close();
+                }
+                else
+                {
+                    Dispatcher.Invoke(() =>
+                    {
+                        _logger?.Info("进度窗口正在关闭：Title={Title}", _viewModel.Title);
+                        base.Close();
+                    });
+                }
+            }
+            catch (TaskCanceledException)
+            {
+                // 窗口已关闭时 Dispatcher 调度可能抛出此异常，静默处理
+            }
+            catch (Exception)
+            {
+                // 其他调度异常静默处理，避免影响调用方
+            }
+        }
+
+        /// <summary>
+        /// 窗口源初始化时，根据 IsCancelable 控制关闭按钮状态
+        /// </summary>
+        protected override void OnSourceInitialized(EventArgs e)
+        {
+            base.OnSourceInitialized(e);
+
+            if (!_viewModel.IsCancelable)
+            {
+                DisableCloseButton();
+            }
+        }
+
+        /// <summary>
+        /// 拦截窗口关闭事件
+        /// </summary>
+        private void OnWindowClosing(object? sender, CancelEventArgs e)
+        {
+            // 当不可取消且非程序主动关闭时，阻止关闭
+            if (!_viewModel.IsCancelable && !_isClosingByCode)
+            {
+                e.Cancel = true;
+            }
+        }
+
+        /// <summary>
+        /// 通过 Win32 API 禁用窗口关闭按钮（灰色不可点击）
+        /// </summary>
+        private void DisableCloseButton()
+        {
+            var hwnd = new WindowInteropHelper(this).Handle;
+            var hMenu = GetSystemMenu(hwnd, false);
+            if (hMenu != IntPtr.Zero)
+            {
+                EnableMenuItem(hMenu, SC_CLOSE, MF_BYCOMMAND | MF_GRAYED);
+            }
+        }
+
+        /// <summary>
+        /// 通过 Win32 API 启用窗口关闭按钮
+        /// </summary>
+        private void EnableCloseButton()
+        {
+            var hwnd = new WindowInteropHelper(this).Handle;
+            var hMenu = GetSystemMenu(hwnd, false);
+            if (hMenu != IntPtr.Zero)
+            {
+                EnableMenuItem(hMenu, SC_CLOSE, MF_BYCOMMAND | MF_ENABLED);
+            }
+        }
+    }
+}

XP.Common/Helpers/ConfigLoader.cs

@@ -0,0 +1,91 @@
+using System.Configuration;
+using XP.Common.Configs;
+using XP.Common.Dump.Configs;
+
+namespace XP.Common.Helpers
+{
+    /// <summary>
+    /// 通用配置加载工具（读取App.config）
+    /// </summary>
+    public static class ConfigLoader
+    {
+        /// <summary>
+        /// 加载Serilog配置
+        /// </summary>
+        public static SerilogConfig LoadSerilogConfig()
+        {
+            var config = new SerilogConfig();
+
+            var logPath = ConfigurationManager.AppSettings["Serilog:LogPath"];
+            if (!string.IsNullOrEmpty(logPath)) config.LogPath = logPath;
+
+            var minLevel = ConfigurationManager.AppSettings["Serilog:MinimumLevel"];
+            if (!string.IsNullOrEmpty(minLevel)) config.MinimumLevel = minLevel;
+
+            var enableConsole = ConfigurationManager.AppSettings["Serilog:EnableConsole"];
+            if (bool.TryParse(enableConsole, out var console)) config.EnableConsole = console;
+
+            var rollingInterval = ConfigurationManager.AppSettings["Serilog:RollingInterval"];
+            if (!string.IsNullOrEmpty(rollingInterval)) config.RollingInterval = rollingInterval;
+
+            var fileSize = ConfigurationManager.AppSettings["Serilog:FileSizeLimitMB"];
+            if (long.TryParse(fileSize, out var size)) config.FileSizeLimitMB = size;
+
+            var retainCount = ConfigurationManager.AppSettings["Serilog:RetainedFileCountLimit"];
+            if (int.TryParse(retainCount, out var count)) config.RetainedFileCountLimit = count;
+
+            return config;
+        }
+
+        /// <summary>
+        /// 加载SQLite配置
+        /// </summary>
+        public static SqliteConfig LoadSqliteConfig()
+        {
+            var config = new SqliteConfig();
+
+            var dbPath = ConfigurationManager.AppSettings["Sqlite:DbFilePath"];
+            if (!string.IsNullOrEmpty(dbPath)) config.DbFilePath = dbPath;
+
+            var timeout = ConfigurationManager.AppSettings["Sqlite:ConnectionTimeout"];
+            if (int.TryParse(timeout, out var t)) config.ConnectionTimeout = t;
+
+            var createIfNotExists = ConfigurationManager.AppSettings["Sqlite:CreateIfNotExists"];
+            if (bool.TryParse(createIfNotExists, out var c)) config.CreateIfNotExists = c;
+
+            var enableWal = ConfigurationManager.AppSettings["Sqlite:EnableWalMode"];
+            if (bool.TryParse(enableWal, out var w)) config.EnableWalMode = w;
+
+            var enableSqlLog = ConfigurationManager.AppSettings["Sqlite:EnableSqlLogging"];
+            if (bool.TryParse(enableSqlLog, out var l)) config.EnableSqlLogging = l;
+
+            return config;
+        }
+
+        /// <summary>
+        /// 加载 Dump 配置 | Load Dump configuration
+        /// </summary>
+        public static DumpConfig LoadDumpConfig()
+        {
+            var config = new DumpConfig();
+
+            var storagePath = ConfigurationManager.AppSettings["Dump:StoragePath"];
+            if (!string.IsNullOrEmpty(storagePath)) config.StoragePath = storagePath;
+
+            var enableScheduled = ConfigurationManager.AppSettings["Dump:EnableScheduledDump"];
+            if (bool.TryParse(enableScheduled, out var enabled)) config.EnableScheduledDump = enabled;
+
+            var interval = ConfigurationManager.AppSettings["Dump:ScheduledIntervalMinutes"];
+            if (int.TryParse(interval, out var min)) config.ScheduledIntervalMinutes = min;
+
+            var sizeLimit = ConfigurationManager.AppSettings["Dump:MiniDumpSizeLimitMB"];
+            if (long.TryParse(sizeLimit, out var size)) config.MiniDumpSizeLimitMB = size;
+
+            var retentionDays = ConfigurationManager.AppSettings["Dump:RetentionDays"];
+            if (int.TryParse(retentionDays, out var days)) config.RetentionDays = days;
+
+            return config;
+        }
+
+    }
+}

XP.Common/Helpers/ProcessHelper.cs

@@ -0,0 +1,199 @@
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Runtime.InteropServices;
+
+namespace XP.Common.Helpers
+{
+    /// <summary>
+    /// 进程管理工具类 | Process Management Helper
+    /// 提供启动外部程序、窗口置前等通用功能 | Provides common functions like launching external programs and bringing windows to front
+    /// </summary>
+    public static class ProcessHelper
+    {
+        #region Win32 API
+
+        [DllImport("user32.dll")]
+        private static extern bool SetForegroundWindow(IntPtr hWnd);
+
+        [DllImport("user32.dll")]
+        private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
+
+        [DllImport("user32.dll")]
+        private static extern bool IsIconic(IntPtr hWnd);
+
+        private const int SW_RESTORE = 9;
+
+        #endregion
+
+        /// <summary>
+        /// 启动或激活外部程序 | Start or activate an external program
+        /// </summary>
+        /// <param name="exePath">可执行文件完整路径 | Full path to the executable</param>
+        /// <param name="singleInstance">是否单实例模式：true=已运行则置前，false=直接启动新实例 | Single instance mode: true=activate if running, false=always start new instance</param>
+        /// <returns>操作结果 | Operation result</returns>
+        public static ProcessResult StartOrActivate(string exePath, bool singleInstance = true)
+        {
+            if (string.IsNullOrWhiteSpace(exePath))
+            {
+                return ProcessResult.Fail("程序路径未配置 | Program path not configured");
+            }
+
+            if (!File.Exists(exePath))
+            {
+                return ProcessResult.Fail($"程序文件不存在: {exePath} | Program file not found: {exePath}");
+            }
+
+            try
+            {
+                // 获取进程名（不含扩展名）| Get process name (without extension)
+                var processName = Path.GetFileNameWithoutExtension(exePath);
+
+                if (singleInstance)
+                {
+                    var processes = Process.GetProcessesByName(processName);
+
+                    if (processes.Length > 0)
+                    {
+                        // 程序已运行，将窗口置前 | Program already running, bring window to front
+                        var process = processes[0];
+                        var hWnd = process.MainWindowHandle;
+
+                        if (hWnd != IntPtr.Zero)
+                        {
+                            BringToFront(hWnd);
+                        }
+
+                        return ProcessResult.Activated();
+                    }
+                }
+
+                // 启动程序 | Start program
+                Process.Start(new ProcessStartInfo
+                {
+                    FileName = exePath,
+                    UseShellExecute = true
+                });
+
+                return ProcessResult.Started();
+            }
+            catch (Exception ex)
+            {
+                return ProcessResult.Fail($"操作失败: {ex.Message} | Operation failed: {ex.Message}");
+            }
+        }
+
+        /// <summary>
+        /// 判断指定进程是否正在运行 | Check if a process is running
+        /// </summary>
+        /// <param name="processName">进程名（不含扩展名）| Process name (without extension)</param>
+        /// <returns>是否运行中 | Whether the process is running</returns>
+        public static bool IsProcessRunning(string processName)
+        {
+            return Process.GetProcessesByName(processName).Length > 0;
+        }
+
+        /// <summary>
+        /// 根据可执行文件路径查找已运行的进程 | Find a running process by executable file path
+        /// 通过进程名匹配并验证完整路径，确保找到的是同一个程序 | Matches by process name and verifies full path
+        /// </summary>
+        /// <param name="exePath">可执行文件完整路径 | Full path to the executable</param>
+        /// <returns>找到的进程对象，未找到返回 null | The found process, or null if not found</returns>
+        public static Process FindRunningProcess(string exePath)
+        {
+            if (string.IsNullOrWhiteSpace(exePath))
+                return null;
+
+            var processName = Path.GetFileNameWithoutExtension(exePath);
+            var normalizedTarget = NormalizePath(exePath);
+
+            try
+            {
+                var processes = Process.GetProcessesByName(processName);
+                foreach (var proc in processes)
+                {
+                    try
+                    {
+                        // 验证完整路径匹配，避免同名不同路径的进程误关联
+                        var procPath = proc.MainModule?.FileName;
+                        if (procPath != null && string.Equals(NormalizePath(procPath), normalizedTarget, StringComparison.OrdinalIgnoreCase))
+                        {
+                            return proc;
+                        }
+                    }
+                    catch
+                    {
+                        // 无法访问进程信息（权限不足等），跳过
+                    }
+                }
+            }
+            catch
+            {
+                // GetProcessesByName 异常，返回 null
+            }
+
+            return null;
+        }
+
+        /// <summary>
+        /// 标准化文件路径，用于路径比较 | Normalize file path for comparison
+        /// </summary>
+        private static string NormalizePath(string path)
+        {
+            return Path.GetFullPath(path).TrimEnd(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar);
+        }
+
+        /// <summary>
+        /// 将窗口置前显示 | Bring a window to the foreground
+        /// </summary>
+        /// <param name="hWnd">窗口句柄 | Window handle</param>
+        public static void BringToFront(IntPtr hWnd)
+        {
+            if (hWnd == IntPtr.Zero) return;
+
+            // 如果窗口被最小化，先恢复 | If window is minimized, restore it first
+            if (IsIconic(hWnd))
+            {
+                ShowWindow(hWnd, SW_RESTORE);
+            }
+
+            SetForegroundWindow(hWnd);
+        }
+    }
+
+    /// <summary>
+    /// 进程操作结果 | Process Operation Result
+    /// </summary>
+    public class ProcessResult
+    {
+        /// <summary>
+        /// 是否成功 | Whether the operation succeeded
+        /// </summary>
+        public bool Success { get; private set; }
+
+        /// <summary>
+        /// 是否为新启动（false表示激活已有窗口）| Whether it was newly started (false means activated existing window)
+        /// </summary>
+        public bool IsNewlyStarted { get; private set; }
+
+        /// <summary>
+        /// 错误信息 | Error message
+        /// </summary>
+        public string ErrorMessage { get; private set; }
+
+        /// <summary>
+        /// 创建启动成功结果 | Create a started result
+        /// </summary>
+        public static ProcessResult Started() => new() { Success = true, IsNewlyStarted = true };
+
+        /// <summary>
+        /// 创建激活成功结果 | Create an activated result
+        /// </summary>
+        public static ProcessResult Activated() => new() { Success = true, IsNewlyStarted = false };
+
+        /// <summary>
+        /// 创建失败结果 | Create a failed result
+        /// </summary>
+        public static ProcessResult Fail(string errorMessage) => new() { Success = false, ErrorMessage = errorMessage };
+    }
+}

XP.Common/Localization/Configs/LocalizationConfig.cs

@@ -0,0 +1,142 @@
+using System;
+using System.Configuration;
+using System.Globalization;
+using XP.Common.Localization.Enums;
+using XP.Common.Localization.Interfaces;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.Localization.Configs
+{
+    /// <summary>
+    /// 本地化配置实现 | Localization configuration implementation
+    /// 使用 App.config 存储语言设置 | Uses App.config to store language settings
+    /// </summary>
+    public class LocalizationConfig : ILocalizationConfig
+    {
+        private const string LanguageKey = "Language";
+        private readonly ILoggerService _logger;
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="logger">日志服务 | Logger service</param>
+        public LocalizationConfig(ILoggerService logger)
+        {
+            _logger = (logger ?? throw new ArgumentNullException(nameof(logger))).ForModule<LocalizationConfig>();
+        }
+
+        /// <summary>
+        /// 获取保存的语言设置 | Get saved language setting
+        /// </summary>
+        /// <returns>语言设置，如果未设置则返回 null | Language setting, or null if not set</returns>
+        public SupportedLanguage? GetSavedLanguage()
+        {
+            try
+            {
+                var languageString = ConfigurationManager.AppSettings[LanguageKey];
+
+                if (string.IsNullOrWhiteSpace(languageString))
+                {
+                    _logger.Info("No saved language setting found in configuration");
+                    return null;
+                }
+
+                if (Enum.TryParse<SupportedLanguage>(languageString, true, out var language))
+                {
+                    _logger.Info($"Loaded saved language setting: {language}");
+                    return language;
+                }
+
+                _logger.Warn($"Invalid language setting in configuration: '{languageString}'. Expected values: ZhCN, ZhTW, EnUS");
+                return null;
+            }
+            catch (ConfigurationErrorsException ex)
+            {
+                _logger.Error(ex, "Configuration error while reading language setting");
+                return null;
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "Unexpected error while reading saved language setting");
+                return null;
+            }
+        }
+
+        /// <summary>
+        /// 保存语言设置 | Save language setting
+        /// </summary>
+        /// <param name="language">要保存的语言 | Language to save</param>
+        public void SaveLanguage(SupportedLanguage language)
+        {
+            try
+            {
+                var config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
+                var appSettings = config.AppSettings.Settings;
+
+                var languageValue = language.ToString();
+
+                if (appSettings[LanguageKey] == null)
+                {
+                    appSettings.Add(LanguageKey, languageValue);
+                    _logger.Info($"Added new language setting to configuration: {language}");
+                }
+                else
+                {
+                    appSettings[LanguageKey].Value = languageValue;
+                    _logger.Info($"Updated language setting in configuration: {language}");
+                }
+
+                config.Save(ConfigurationSaveMode.Modified);
+                ConfigurationManager.RefreshSection("appSettings");
+
+                _logger.Info($"Successfully saved language setting: {language}");
+            }
+            catch (ConfigurationErrorsException ex)
+            {
+                _logger.Error(ex, $"Configuration error while saving language setting: {language}");
+                throw new InvalidOperationException($"Failed to save language setting to configuration file: {ex.Message}", ex);
+            }
+            catch (UnauthorizedAccessException ex)
+            {
+                _logger.Error(ex, $"Access denied while saving language setting: {language}");
+                throw new InvalidOperationException("Access denied to configuration file. Please check file permissions.", ex);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, $"Unexpected error while saving language setting: {language}");
+                throw new InvalidOperationException($"Failed to save language setting: {ex.Message}", ex);
+            }
+        }
+
+        /// <summary>
+        /// 获取系统默认语言 | Get system default language
+        /// </summary>
+        /// <returns>系统默认语言 | System default language</returns>
+        public SupportedLanguage GetSystemDefaultLanguage()
+        {
+            try
+            {
+                var systemCulture = CultureInfo.CurrentUICulture.Name;
+                _logger.Info($"Detecting system default language from culture: {systemCulture}");
+
+                var defaultLanguage = systemCulture switch
+                {
+                    "zh-CN" => SupportedLanguage.ZhCN,
+                    "zh-TW" or "zh-HK" or "zh-MO" => SupportedLanguage.ZhTW,
+                    "en-US" or "en" => SupportedLanguage.EnUS,
+                    _ when systemCulture.StartsWith("zh", StringComparison.OrdinalIgnoreCase) => SupportedLanguage.ZhCN,
+                    _ when systemCulture.StartsWith("en", StringComparison.OrdinalIgnoreCase) => SupportedLanguage.EnUS,
+                    _ => SupportedLanguage.ZhCN // 默认简体中文 | Default to Simplified Chinese
+                };
+
+                _logger.Info($"System default language determined: {defaultLanguage} (from culture: {systemCulture})");
+                return defaultLanguage;
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "Error while detecting system default language, falling back to ZhCN");
+                return SupportedLanguage.ZhCN; // 默认简体中文 | Default to Simplified Chinese
+            }
+        }
+    }
+}

XP.Common/Localization/Enums/SupportedLanguage.cs

@@ -0,0 +1,28 @@
+using System.ComponentModel;
+
+namespace XP.Common.Localization.Enums
+{
+    /// <summary>
+    /// 支持的语言枚举 | Supported language enumeration
+    /// </summary>
+    public enum SupportedLanguage
+    {
+        /// <summary>
+        /// 简体中文 | Simplified Chinese
+        /// </summary>
+        [Description("zh-CN")]
+        ZhCN,
+
+        /// <summary>
+        /// 繁体中文 | Traditional Chinese
+        /// </summary>
+        [Description("zh-TW")]
+        ZhTW,
+
+        /// <summary>
+        /// 美式英语 | American English
+        /// </summary>
+        [Description("en-US")]
+        EnUS
+    }
+}

XP.Common/Localization/Events/LanguageChangedEvent.cs

@@ -0,0 +1,12 @@
+using Prism.Events;
+
+namespace XP.Common.Localization.Events
+{
+    /// <summary>
+    /// Prism 语言切换事件 | Prism language changed event
+    /// 用于跨模块通知语言切换 | Used for cross-module language change notification
+    /// </summary>
+    public class LanguageChangedEvent : PubSubEvent<LanguageChangedEventArgs>
+    {
+    }
+}

XP.Common/Localization/Events/LanguageChangedEventArgs.cs

@@ -0,0 +1,38 @@
+using System;
+using XP.Common.Localization.Enums;
+
+namespace XP.Common.Localization.Events
+{
+    /// <summary>
+    /// 语言切换事件参数 | Language changed event arguments
+    /// </summary>
+    public class LanguageChangedEventArgs : EventArgs
+    {
+        /// <summary>
+        /// 旧语言 | Old language
+        /// </summary>
+        public SupportedLanguage OldLanguage { get; }
+
+        /// <summary>
+        /// 新语言 | New language
+        /// </summary>
+        public SupportedLanguage NewLanguage { get; }
+
+        /// <summary>
+        /// 切换时间 | Change timestamp
+        /// </summary>
+        public DateTime Timestamp { get; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="oldLanguage">旧语言 | Old language</param>
+        /// <param name="newLanguage">新语言 | New language</param>
+        public LanguageChangedEventArgs(SupportedLanguage oldLanguage, SupportedLanguage newLanguage)
+        {
+            OldLanguage = oldLanguage;
+            NewLanguage = newLanguage;
+            Timestamp = DateTime.Now;
+        }
+    }
+}

XP.Common/Localization/Exceptions/LocalizationException.cs

@@ -0,0 +1,28 @@
+using System;
+
+namespace XP.Common.Localization.Exceptions
+{
+    /// <summary>
+    /// 本地化异常基类 | Localization exception base class
+    /// </summary>
+    public class LocalizationException : Exception
+    {
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="message">异常消息 | Exception message</param>
+        public LocalizationException(string message) : base(message)
+        {
+        }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="message">异常消息 | Exception message</param>
+        /// <param name="innerException">内部异常 | Inner exception</param>
+        public LocalizationException(string message, Exception innerException)
+            : base(message, innerException)
+        {
+        }
+    }
+}

XP.Common/Localization/Exceptions/LocalizationInitializationException.cs

@@ -0,0 +1,30 @@
+using System;
+
+namespace XP.Common.Localization.Exceptions
+{
+    /// <summary>
+    /// 本地化初始化异常 | Localization initialization exception
+    /// 当资源文件无法加载时抛出 | Thrown when resource files cannot be loaded
+    /// </summary>
+    public class LocalizationInitializationException : LocalizationException
+    {
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="message">异常消息 | Exception message</param>
+        public LocalizationInitializationException(string message)
+            : base(message)
+        {
+        }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="message">异常消息 | Exception message</param>
+        /// <param name="innerException">内部异常 | Inner exception</param>
+        public LocalizationInitializationException(string message, Exception innerException)
+            : base(message, innerException)
+        {
+        }
+    }
+}

XP.Common/Localization/Exceptions/ResourceKeyNotFoundException.cs

@@ -0,0 +1,25 @@
+using System;
+
+namespace XP.Common.Localization.Exceptions
+{
+    /// <summary>
+    /// 资源键未找到异常 | Resource key not found exception
+    /// </summary>
+    public class ResourceKeyNotFoundException : LocalizationException
+    {
+        /// <summary>
+        /// 资源键 | Resource key
+        /// </summary>
+        public string ResourceKey { get; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="resourceKey">资源键 | Resource key</param>
+        public ResourceKeyNotFoundException(string resourceKey)
+            : base($"Resource key not found: {resourceKey}")
+        {
+            ResourceKey = resourceKey;
+        }
+    }
+}

XP.Common/Localization/Extensions/LocalizationExtension.cs

@@ -0,0 +1,74 @@
+using System;
+using System.Windows.Markup;
+using XP.Common.Localization.Interfaces;
+
+namespace XP.Common.Localization.Extensions
+{
+    /// <summary>
+    /// 本地化标记扩展 | Localization markup extension
+    /// 用法: {loc:Localization Key=ResourceKey} | Usage: {loc:Localization Key=ResourceKey}
+    /// </summary>
+    [MarkupExtensionReturnType(typeof(string))]
+    public class LocalizationExtension : MarkupExtension
+    {
+        private static ILocalizationService? _localizationService;
+        private string _key = string.Empty;
+
+        /// <summary>
+        /// 资源键 | Resource key
+        /// </summary>
+        [ConstructorArgument("key")]
+        public string Key
+        {
+            get => _key;
+            set => _key = value;
+        }
+
+        /// <summary>
+        /// 默认构造函数 | Default constructor
+        /// </summary>
+        public LocalizationExtension()
+        {
+        }
+
+        /// <summary>
+        /// 带资源键的构造函数 | Constructor with resource key
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        public LocalizationExtension(string key)
+        {
+            _key = key;
+        }
+
+        /// <summary>
+        /// 初始化本地化服务（由 CommonModule 调用）| Initialize localization service (called by CommonModule)
+        /// </summary>
+        /// <param name="localizationService">本地化服务实例 | Localization service instance</param>
+        public static void Initialize(ILocalizationService localizationService)
+        {
+            _localizationService = localizationService;
+        }
+
+        /// <summary>
+        /// 提供本地化字符串值 | Provide localized string value
+        /// </summary>
+        /// <param name="serviceProvider">服务提供者 | Service provider</param>
+        /// <returns>本地化字符串 | Localized string</returns>
+        public override object ProvideValue(IServiceProvider serviceProvider)
+        {
+            if (string.IsNullOrEmpty(_key))
+            {
+                return string.Empty;
+            }
+
+            if (_localizationService == null)
+            {
+                // 设计时回退 | Design-time fallback
+                return $"[{_key}]";
+            }
+
+            // 直接返回当前语言的翻译字符串 | Return translated text for current language
+            return _localizationService.GetString(_key);
+        }
+    }
+}

XP.Common/Localization/Helpers/LocalizationHelper.cs

@@ -0,0 +1,57 @@
+using System.Globalization;
+using System.Resources;
+using XP.Common.Localization.Interfaces;
+using XP.Common.Resources;
+
+namespace XP.Common.Localization
+{
+    /// <summary>
+    /// 静态本地化帮助类 | Static localization helper
+    /// 用法：Loc.Get("ResourceKey") 或 Loc.Get("ResourceKey", param1, param2)
+    /// Usage: Loc.Get("ResourceKey") or Loc.Get("ResourceKey", param1, param2)
+    /// </summary>
+    public static class LocalizationHelper
+    {
+        private static ILocalizationService? _localizationService;
+
+        /// <summary>
+        /// 初始化本地化帮助类（由 CommonModule 或 App 启动时调用）
+        /// Initialize the localization helper (called by CommonModule or App at startup)
+        /// </summary>
+        /// <param name="localizationService">本地化服务实例 | Localization service instance</param>
+        public static void Initialize(ILocalizationService localizationService)
+        {
+            _localizationService = localizationService;
+        }
+
+        /// <summary>
+        /// 获取本地化字符串（使用当前 UI 语言）| Get localized string (using current UI culture)
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <returns>本地化字符串，找不到时返回键本身 | Localized string, returns key itself if not found</returns>
+        public static string Get(string key)
+        {
+            if (string.IsNullOrEmpty(key))
+                return string.Empty;
+
+            if (_localizationService != null)
+                return _localizationService.GetString(key);
+
+            // 兼容回退：未初始化时仍使用原始 ResourceManager
+            // Fallback: use original ResourceManager when not initialized
+            return Resources.Resources.ResourceManager.GetString(key, CultureInfo.CurrentUICulture) ?? key;
+        }
+
+        /// <summary>
+        /// 获取本地化字符串并格式化 | Get localized string with formatting
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <param name="args">格式化参数 | Format arguments</param>
+        /// <returns>格式化后的本地化字符串 | Formatted localized string</returns>
+        public static string Get(string key, params object[] args)
+        {
+            var template = Get(key);
+            return args.Length > 0 ? string.Format(template, args) : template;
+        }
+    }
+}

XP.Common/Localization/Implementations/ResourceSource.cs

@@ -0,0 +1,34 @@
+using System;
+using System.Resources;
+
+namespace XP.Common.Localization.Implementations
+{
+    /// <summary>
+    /// 资源源条目，封装名称与 ResourceManager 的映射
+    /// Resource source entry, encapsulating the mapping between name and ResourceManager
+    /// </summary>
+    internal class ResourceSource
+    {
+        /// <summary>
+        /// 资源源唯一标识 | Resource source unique identifier
+        /// </summary>
+        public string Name { get; }
+
+        /// <summary>
+        /// .NET 资源管理器实例 | .NET ResourceManager instance
+        /// </summary>
+        public ResourceManager ResourceManager { get; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="name">资源源名称（如 "XP.Scan"）| Resource source name (e.g. "XP.Scan")</param>
+        /// <param name="resourceManager">模块的 ResourceManager 实例 | Module's ResourceManager instance</param>
+        /// <exception cref="ArgumentNullException">当 name 或 resourceManager 为 null 时抛出 | Thrown when name or resourceManager is null</exception>
+        public ResourceSource(string name, ResourceManager resourceManager)
+        {
+            Name = name ?? throw new ArgumentNullException(nameof(name));
+            ResourceManager = resourceManager ?? throw new ArgumentNullException(nameof(resourceManager));
+        }
+    }
+}

XP.Common/Localization/Implementations/ResxLocalizationService.cs

@@ -0,0 +1,311 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Linq;
+using System.Reflection;
+using System.Resources;
+using System.Threading;
+using Prism.Events;
+using XP.Common.Localization.Enums;
+using XP.Common.Localization.Events;
+using XP.Common.Localization.Interfaces;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.Localization.Implementations
+{
+    /// <summary>
+    /// Resx 本地化服务实现 | Resx localization service implementation
+    /// 使用 .NET ResourceManager 加载 Resx 资源文件 | Uses .NET ResourceManager to load Resx resource files
+    /// 支持多资源源 Fallback Chain 机制 | Supports multi-source Fallback Chain mechanism
+    /// </summary>
+    public class ResxLocalizationService : ILocalizationService
+    {
+        private readonly List<ResourceSource> _resourceSources = new List<ResourceSource>();
+        private readonly ReaderWriterLockSlim _rwLock = new ReaderWriterLockSlim();
+        private readonly IEventAggregator _eventAggregator;
+        private readonly ILocalizationConfig _config;
+        private readonly ILoggerService _logger;
+        private SupportedLanguage _currentLanguage;
+
+        /// <summary>
+        /// 获取当前语言 | Get current language
+        /// </summary>
+        public SupportedLanguage CurrentLanguage => _currentLanguage;
+
+        /// <summary>
+        /// 语言切换事件 | Language changed event
+        /// </summary>
+        public event EventHandler<LanguageChangedEventArgs>? LanguageChanged;
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="eventAggregator">事件聚合器 | Event aggregator</param>
+        /// <param name="config">本地化配置 | Localization configuration</param>
+        /// <param name="logger">日志服务 | Logger service</param>
+        public ResxLocalizationService(
+            IEventAggregator eventAggregator,
+            ILocalizationConfig config,
+            ILoggerService logger)
+        {
+            _eventAggregator = eventAggregator ?? throw new ArgumentNullException(nameof(eventAggregator));
+            _config = config ?? throw new ArgumentNullException(nameof(config));
+            _logger = (logger ?? throw new ArgumentNullException(nameof(logger))).ForModule<ResxLocalizationService>();
+
+            // 初始化默认资源源（XP.Common），注册到 Fallback Chain[0]
+            // Initialize default resource source (XP.Common), registered at Fallback Chain[0]
+            var defaultResourceManager = new ResourceManager(
+                "XP.Common.Resources.Resources",
+                Assembly.GetExecutingAssembly());
+            _resourceSources.Add(new ResourceSource("XP.Common", defaultResourceManager));
+
+            // 加载保存的语言或使用默认语言 | Load saved language or use default language
+            InitializeLanguage();
+        }
+
+        /// <summary>
+        /// 获取本地化字符串（使用当前语言）| Get localized string (using current language)
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <returns>本地化字符串 | Localized string</returns>
+        public string GetString(string key)
+        {
+            return GetString(key, CultureInfo.CurrentUICulture);
+        }
+
+        /// <summary>
+        /// 获取本地化字符串（指定语言）| Get localized string (specified language)
+        /// 从 Fallback Chain 末尾向前遍历，第一个返回非 null 值的 ResourceManager 即为结果
+        /// Traverses the Fallback Chain from end to beginning, first ResourceManager returning non-null wins
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <param name="culture">文化信息 | Culture info</param>
+        /// <returns>本地化字符串 | Localized string</returns>
+        public string GetString(string key, CultureInfo culture)
+        {
+            if (string.IsNullOrEmpty(key))
+            {
+                return string.Empty;
+            }
+
+            _rwLock.EnterReadLock();
+            try
+            {
+                // 从末尾向前遍历（后注册 = 高优先级）
+                // Traverse from end to beginning (last registered = highest priority)
+                for (int i = _resourceSources.Count - 1; i >= 0; i--)
+                {
+                    try
+                    {
+                        var value = _resourceSources[i].ResourceManager.GetString(key, culture);
+                        if (value != null)
+                        {
+                            return value;
+                        }
+                    }
+                    catch (Exception ex)
+                    {
+                        // 单个 ResourceManager 抛出异常时捕获并继续遍历下一个
+                        // Catch exception from individual ResourceManager and continue to next
+                        _logger.Error(ex, $"资源源 '{_resourceSources[i].Name}' 查找键 '{key}' 时出错 | Error looking up key '{key}' in resource source '{_resourceSources[i].Name}'");
+                    }
+                }
+            }
+            finally
+            {
+                _rwLock.ExitReadLock();
+            }
+
+            // 全部未找到则返回 key 本身并记录警告日志
+            // If all sources fail to find the key, return the key itself and log warning
+            _logger.Warn($"资源键未找到 | Resource key not found: '{key}' for culture '{culture?.Name ?? "null"}'");
+            return key;
+        }
+
+        /// <summary>
+        /// 注册模块资源源到 Fallback Chain 末尾（最高优先级）
+        /// Register a module resource source to the end of the Fallback Chain (highest priority)
+        /// </summary>
+        /// <param name="name">资源源名称 | Resource source name</param>
+        /// <param name="resourceManager">模块的 ResourceManager 实例 | Module's ResourceManager instance</param>
+        public void RegisterResourceSource(string name, ResourceManager resourceManager)
+        {
+            if (name == null) throw new ArgumentNullException(nameof(name));
+            if (resourceManager == null) throw new ArgumentNullException(nameof(resourceManager));
+
+            _rwLock.EnterWriteLock();
+            try
+            {
+                // 检查重复名称 | Check for duplicate name
+                if (_resourceSources.Any(s => s.Name == name))
+                {
+                    _logger.Warn($"资源源 '{name}' 已存在，注册被拒绝 | Resource source '{name}' already exists, registration rejected");
+                    throw new InvalidOperationException($"Resource source '{name}' is already registered.");
+                }
+
+                _resourceSources.Add(new ResourceSource(name, resourceManager));
+                _logger.Info($"资源源 '{name}' 已注册到 Fallback Chain | Resource source '{name}' registered to Fallback Chain");
+            }
+            finally
+            {
+                _rwLock.ExitWriteLock();
+            }
+        }
+
+        /// <summary>
+        /// 从 Fallback Chain 中注销指定资源源
+        /// Unregister the specified resource source from the Fallback Chain
+        /// </summary>
+        /// <param name="name">资源源名称 | Resource source name</param>
+        public void UnregisterResourceSource(string name)
+        {
+            if (name == null) throw new ArgumentNullException(nameof(name));
+
+            // 禁止注销默认资源源 | Prevent unregistering default resource source
+            if (name == "XP.Common")
+            {
+                throw new InvalidOperationException("Cannot unregister the default resource source 'XP.Common'.");
+            }
+
+            _rwLock.EnterWriteLock();
+            try
+            {
+                var source = _resourceSources.FirstOrDefault(s => s.Name == name);
+                if (source != null)
+                {
+                    _resourceSources.Remove(source);
+                    _logger.Info($"资源源 '{name}' 已从 Fallback Chain 注销 | Resource source '{name}' unregistered from Fallback Chain");
+                }
+                else
+                {
+                    // 注销不存在的名称时静默忽略，记录警告日志
+                    // Silently ignore non-existent name, log warning
+                    _logger.Warn($"资源源 '{name}' 不存在，注销操作被忽略 | Resource source '{name}' does not exist, unregister ignored");
+                }
+            }
+            finally
+            {
+                _rwLock.ExitWriteLock();
+            }
+        }
+
+        /// <summary>
+        /// 设置当前语言（仅保存配置，重启后生效）| Set current language (save config only, takes effect after restart)
+        /// </summary>
+        /// <param name="language">目标语言 | Target language</param>
+        public void SetLanguage(SupportedLanguage language)
+        {
+            _rwLock.EnterWriteLock();
+            try
+            {
+                // 如果语言相同，无需保存 | If language is the same, no need to save
+                if (_currentLanguage == language)
+                {
+                    _logger.Info($"语言已经是 {language}，无需切换 | Language is already {language}, no need to switch");
+                    return;
+                }
+
+                try
+                {
+                    _logger.Info($"保存语言设置，重启后生效 | Saving language setting, takes effect after restart: {_currentLanguage} -> {language}");
+
+                    // 仅保存到配置，不更新运行时状态 | Only save to config, do not update runtime state
+                    _config.SaveLanguage(language);
+
+                    _logger.Info($"语言设置已保存 | Language setting saved: {language}");
+                }
+                catch (Exception ex)
+                {
+                    _logger.Error(ex, $"语言设置保存失败 | Failed to save language setting: {language}");
+                    throw;
+                }
+            }
+            finally
+            {
+                _rwLock.ExitWriteLock();
+            }
+        }
+
+        /// <summary>
+        /// 获取所有支持的语言 | Get all supported languages
+        /// </summary>
+        /// <returns>支持的语言列表 | List of supported languages</returns>
+        public IEnumerable<SupportedLanguage> GetSupportedLanguages()
+        {
+            return Enum.GetValues(typeof(SupportedLanguage))
+                       .Cast<SupportedLanguage>();
+        }
+
+        /// <summary>
+        /// 初始化语言设置 | Initialize language settings
+        /// </summary>
+        private void InitializeLanguage()
+        {
+            try
+            {
+                // 尝试获取保存的语言 | Try to get saved language
+                var savedLanguage = _config.GetSavedLanguage();
+                var language = savedLanguage ?? _config.GetSystemDefaultLanguage();
+
+                _currentLanguage = language;
+                var culture = GetCultureInfo(language);
+                CultureInfo.CurrentUICulture = culture;
+                CultureInfo.CurrentCulture = culture;
+
+                _logger.Info($"语言初始化完成 | Language initialized: {language} (Culture: {culture.Name})");
+
+                // 验证资源文件是否可加载 | Verify resource file can be loaded
+                ValidateResourceFile(culture);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "语言初始化失败 | Language initialization failed");
+                throw;
+            }
+        }
+
+        /// <summary>
+        /// 获取语言对应的 CultureInfo | Get CultureInfo for language
+        /// </summary>
+        /// <param name="language">支持的语言 | Supported language</param>
+        /// <returns>文化信息 | Culture info</returns>
+        private CultureInfo GetCultureInfo(SupportedLanguage language)
+        {
+            return language switch
+            {
+                SupportedLanguage.ZhCN => new CultureInfo("zh-CN"),
+                SupportedLanguage.ZhTW => new CultureInfo("zh-TW"),
+                SupportedLanguage.EnUS => new CultureInfo("en-US"),
+                _ => new CultureInfo("zh-CN") // 默认简体中文 | Default to Simplified Chinese
+            };
+        }
+
+        /// <summary>
+        /// 验证资源文件是否可加载 | Validate resource file can be loaded
+        /// 使用默认资源源（XP.Common）进行验证 | Uses default resource source (XP.Common) for validation
+        /// </summary>
+        /// <param name="culture">文化信息 | Culture info</param>
+        private void ValidateResourceFile(CultureInfo culture)
+        {
+            try
+            {
+                // 使用第一个资源源（XP.Common）进行验证
+                // Use the first resource source (XP.Common) for validation
+                var testValue = _resourceSources[0].ResourceManager.GetString("App_Title", culture);
+
+                if (testValue != null)
+                {
+                    _logger.Info($"资源文件验证成功 | Resource file validated for culture: {culture.Name}");
+                }
+                else
+                {
+                    _logger.Warn($"资源文件可能不完整 | Resource file may be incomplete for culture: {culture.Name}");
+                }
+            }
+            catch (Exception)
+            {
+                _logger.Warn($"资源文件验证失败，将使用默认资源 | Resource file validation failed, will use default resources for culture: {culture.Name}");
+            }
+        }
+    }
+}

XP.Common/Localization/Interfaces/ILocalizationConfig.cs

@@ -0,0 +1,29 @@
+using XP.Common.Localization.Enums;
+
+namespace XP.Common.Localization.Interfaces
+{
+    /// <summary>
+    /// 本地化配置接口 | Localization configuration interface
+    /// 负责语言设置的加载和保存 | Responsible for loading and saving language settings
+    /// </summary>
+    public interface ILocalizationConfig
+    {
+        /// <summary>
+        /// 获取保存的语言设置 | Get saved language setting
+        /// </summary>
+        /// <returns>语言设置，如果未设置则返回 null | Language setting, or null if not set</returns>
+        SupportedLanguage? GetSavedLanguage();
+
+        /// <summary>
+        /// 保存语言设置 | Save language setting
+        /// </summary>
+        /// <param name="language">要保存的语言 | Language to save</param>
+        void SaveLanguage(SupportedLanguage language);
+
+        /// <summary>
+        /// 获取系统默认语言 | Get system default language
+        /// </summary>
+        /// <returns>系统默认语言 | System default language</returns>
+        SupportedLanguage GetSystemDefaultLanguage();
+    }
+}

XP.Common/Localization/Interfaces/ILocalizationService.cs

@@ -0,0 +1,68 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Resources;
+using XP.Common.Localization.Enums;
+using XP.Common.Localization.Events;
+
+namespace XP.Common.Localization.Interfaces
+{
+    /// <summary>
+    /// 本地化服务接口 | Localization service interface
+    /// 提供多语言资源访问和语言切换功能 | Provides multilingual resource access and language switching
+    /// </summary>
+    public interface ILocalizationService
+    {
+        /// <summary>
+        /// 获取当前语言 | Get current language
+        /// </summary>
+        SupportedLanguage CurrentLanguage { get; }
+
+        /// <summary>
+        /// 语言切换事件 | Language changed event
+        /// </summary>
+        event EventHandler<LanguageChangedEventArgs> LanguageChanged;
+
+        /// <summary>
+        /// 获取本地化字符串（使用当前语言）| Get localized string (using current language)
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <returns>本地化字符串 | Localized string</returns>
+        string GetString(string key);
+
+        /// <summary>
+        /// 获取本地化字符串（指定语言）| Get localized string (specified language)
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <param name="culture">文化信息 | Culture info</param>
+        /// <returns>本地化字符串 | Localized string</returns>
+        string GetString(string key, CultureInfo culture);
+
+        /// <summary>
+        /// 设置当前语言 | Set current language
+        /// </summary>
+        /// <param name="language">目标语言 | Target language</param>
+        void SetLanguage(SupportedLanguage language);
+
+        /// <summary>
+        /// 获取所有支持的语言 | Get all supported languages
+        /// </summary>
+        /// <returns>支持的语言列表 | List of supported languages</returns>
+        IEnumerable<SupportedLanguage> GetSupportedLanguages();
+
+        /// <summary>
+        /// 注册模块资源源到 Fallback Chain 末尾（最高优先级）
+        /// Register a module resource source to the end of the Fallback Chain (highest priority)
+        /// </summary>
+        /// <param name="name">资源源名称（如 "XP.Scan"），用于标识和注销 | Resource source name (e.g. "XP.Scan"), used for identification and unregistration</param>
+        /// <param name="resourceManager">模块的 ResourceManager 实例 | The module's ResourceManager instance</param>
+        void RegisterResourceSource(string name, ResourceManager resourceManager);
+
+        /// <summary>
+        /// 从 Fallback Chain 中注销指定资源源
+        /// Unregister the specified resource source from the Fallback Chain
+        /// </summary>
+        /// <param name="name">资源源名称 | Resource source name</param>
+        void UnregisterResourceSource(string name);
+    }
+}

XP.Common/Localization/ViewModels/LanguageOption.cs

@@ -0,0 +1,39 @@
+using XP.Common.Localization.Enums;
+
+namespace XP.Common.Localization.ViewModels
+{
+    /// <summary>
+    /// 语言选项数据模型 | Language option data model
+    /// 用于在 UI 中显示可选语言 | Used to display available languages in UI
+    /// </summary>
+    public class LanguageOption
+    {
+        /// <summary>
+        /// 语言枚举值 | Language enum value
+        /// </summary>
+        public SupportedLanguage Language { get; }
+
+        /// <summary>
+        /// 显示名称 | Display name
+        /// </summary>
+        public string DisplayName { get; }
+
+        /// <summary>
+        /// 语言标志/图标 | Language flag/icon
+        /// </summary>
+        public string Flag { get; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="language">语言 | Language</param>
+        /// <param name="displayName">显示名称 | Display name</param>
+        /// <param name="flag">标志 | Flag</param>
+        public LanguageOption(SupportedLanguage language, string displayName, string flag = "")
+        {
+            Language = language;
+            DisplayName = displayName;
+            Flag = flag;
+        }
+    }
+}

XP.Common/Localization/ViewModels/LanguageSwitcherViewModel.cs

@@ -0,0 +1,209 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Windows;
+using Prism.Commands;
+using Prism.Mvvm;
+using XP.Common.Localization.Enums;
+using XP.Common.Localization.Interfaces;
+using XP.Common.Logging.Interfaces;
+
+
+namespace XP.Common.Localization.ViewModels
+{
+    /// <summary>
+    /// 语言切换器 ViewModel | Language switcher ViewModel
+    /// 提供语言选择和切换功能 | Provides language selection and switching functionality
+    /// </summary>
+    public class LanguageSwitcherViewModel : BindableBase
+    {
+        private readonly ILocalizationService _localizationService;
+        private readonly ILocalizationConfig _config;
+        private readonly ILoggerService _logger;
+        private LanguageOption? _selectedLanguage;
+
+        /// <summary>
+        /// 选中的语言选项 | Selected language option
+        /// </summary>
+        public LanguageOption? SelectedLanguage
+        {
+            get => _selectedLanguage;
+            set
+            {
+                if (SetProperty(ref _selectedLanguage, value))
+                {
+                    ApplyCommand.RaiseCanExecuteChanged();
+                    UpdatePreviewTexts();
+                }
+            }
+        }
+
+        /// <summary>
+        /// 可用语言列表 | Available languages list
+        /// </summary>
+        public IEnumerable<LanguageOption> AvailableLanguages { get; }
+
+        /// <summary>
+        /// 应用按钮命令 | Apply button command
+        /// </summary>
+        public DelegateCommand ApplyCommand { get; }
+
+        private string _previewRestartNotice = string.Empty;
+        /// <summary>
+        /// 预览重启提示文本 | Preview restart notice text
+        /// </summary>
+        public string PreviewRestartNotice
+        {
+            get => _previewRestartNotice;
+            set => SetProperty(ref _previewRestartNotice, value);
+        }
+
+        private string _previewApplyButtonText = string.Empty;
+        /// <summary>
+        /// 预览应用按钮文本 | Preview apply button text
+        /// </summary>
+        public string PreviewApplyButtonText
+        {
+            get => _previewApplyButtonText;
+            set => SetProperty(ref _previewApplyButtonText, value);
+        }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="localizationService">本地化服务 | Localization service</param>
+        /// <param name="config">本地化配置 | Localization configuration</param>
+        /// <param name="logger">日志服务 | Logger service</param>
+        public LanguageSwitcherViewModel(
+            ILocalizationService localizationService,
+            ILocalizationConfig config,
+            ILoggerService logger)
+        {
+            _localizationService = localizationService ?? throw new ArgumentNullException(nameof(localizationService));
+            _config = config ?? throw new ArgumentNullException(nameof(config));
+            _logger = logger.ForModule<LanguageSwitcherViewModel>();
+
+            // 初始化可用语言列表 | Initialize available languages list
+            AvailableLanguages = new[]
+            {
+                new LanguageOption(SupportedLanguage.ZhCN, "简体中文", "🇨🇳"),
+                new LanguageOption(SupportedLanguage.ZhTW, "繁體中文", "🇹🇼"),
+                new LanguageOption(SupportedLanguage.EnUS, "English", "🇺🇸")
+            };
+
+            // 设置当前选中的语言 | Set currently selected language
+            var currentLang = localizationService.CurrentLanguage;
+            foreach (var lang in AvailableLanguages)
+            {
+                if (lang.Language == currentLang)
+                {
+                    _selectedLanguage = lang;
+                    break;
+                }
+            }
+
+            // 初始化命令 | Initialize commands
+            ApplyCommand = new DelegateCommand(OnApply, CanApply);
+            
+            // 初始化预览文本 | Initialize preview texts
+            UpdatePreviewTexts();
+        }
+
+        /// <summary>
+        /// 更新预览文本 | Update preview texts
+        /// </summary>
+        private void UpdatePreviewTexts()
+        {
+            if (_selectedLanguage == null)
+                return;
+
+            // 获取选中语言的 CultureInfo | Get CultureInfo for selected language
+            var previewCulture = GetCultureInfo(_selectedLanguage.Language);
+            
+            // 使用选中的语言获取本地化文本 | Get localized text using selected language
+            PreviewRestartNotice = _localizationService.GetString("Settings_Language_RestartNotice", previewCulture);
+            PreviewApplyButtonText = _localizationService.GetString("Button_Apply", previewCulture);
+        }
+
+        /// <summary>
+        /// 判断是否可以应用 | Determine if can apply
+        /// 与配置文件中已保存的语言比较 | Compare with saved language in config
+        /// </summary>
+        private bool CanApply()
+        {
+            if (_selectedLanguage == null)
+                return false;
+
+            // 获取配置文件中已保存的语言 | Get saved language from config
+            var savedLanguage = _config.GetSavedLanguage() ?? _localizationService.CurrentLanguage;
+            return _selectedLanguage.Language != savedLanguage;
+        }
+
+        /// <summary>
+        /// 应用语言切换 | Apply language change
+        /// </summary>
+        private void OnApply()
+        {
+            if (_selectedLanguage == null)
+                return;
+
+            try
+            {
+                var newLanguage = _selectedLanguage.Language;
+                _localizationService.SetLanguage(newLanguage);
+                
+                _logger.Info($"Language switched to {newLanguage}");
+
+                // 显示重启提示对话框 | Show restart prompt dialog
+                MessageBox.Show(
+                    _localizationService.GetString("Settings_Language_SavedRestartRequired"),
+                    _localizationService.GetString("Dialog_Notice"),
+                    MessageBoxButton.OK,
+                    MessageBoxImage.Information);
+                
+                // 更新命令状态 | Update command state
+                ApplyCommand.RaiseCanExecuteChanged();
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, $"Failed to switch language to {_selectedLanguage.Language}");
+                
+                // 显示错误对话框 | Show error dialog
+                var errorMsg = string.Format(
+                    _localizationService.GetString("Settings_Language_SwitchFailed"),
+                    ex.Message);
+                MessageBox.Show(
+                    errorMsg,
+                    _localizationService.GetString("Dialog_Error"),
+                    MessageBoxButton.OK,
+                    MessageBoxImage.Error);
+                
+                // 恢复到之前的语言 | Restore previous language
+                var currentLang = _localizationService.CurrentLanguage;
+                foreach (var lang in AvailableLanguages)
+                {
+                    if (lang.Language == currentLang)
+                    {
+                        _selectedLanguage = lang;
+                        RaisePropertyChanged(nameof(SelectedLanguage));
+                        break;
+                    }
+                }
+            }
+        }
+
+        /// <summary>
+        /// 获取语言对应的 CultureInfo | Get CultureInfo for language
+        /// </summary>
+        private CultureInfo GetCultureInfo(SupportedLanguage language)
+        {
+            return language switch
+            {
+                SupportedLanguage.ZhCN => new CultureInfo("zh-CN"),
+                SupportedLanguage.ZhTW => new CultureInfo("zh-TW"),
+                SupportedLanguage.EnUS => new CultureInfo("en-US"),
+                _ => new CultureInfo("zh-CN")
+            };
+        }
+    }
+}

XP.Common/Localization/Views/LanguageSwitcherWindow.xaml

@@ -0,0 +1,130 @@
+<Window x:Class="XP.Common.Localization.Views.LanguageSwitcherWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
+        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+        xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation"
+        xmlns:loc="clr-namespace:XP.Common.Localization.Extensions"
+        xmlns:vm="clr-namespace:XP.Common.Localization.ViewModels"
+        mc:Ignorable="d"
+        d:DataContext="{d:DesignInstance Type=vm:LanguageSwitcherViewModel}"
+        Title="{loc:Localization Key=Settings_Language}"
+        Height="315" Width="500"
+        MinHeight="300" MinWidth="450"
+        ResizeMode="CanResize"
+        WindowStartupLocation="CenterOwner"
+        Background="White">
+    
+    <!-- 主容器，带边距 | Main container with margins -->
+    <Grid Margin="24,16,24,16">
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="*"/>
+            <RowDefinition Height="Auto"/>
+        </Grid.RowDefinitions>
+        
+        <!-- 标题 | Title -->
+        <TextBlock Grid.Row="0" 
+                   Text="{loc:Localization Key=Settings_Language}"
+                   FontSize="18"
+                   FontWeight="SemiBold"
+                   Margin="0,0,0,8"/>
+        
+        <!-- 副标题/描述 | Subtitle/Description -->
+        <TextBlock Grid.Row="1" 
+                   Text="{loc:Localization Key=Settings_Language_Description}"
+                   FontSize="12"
+                   Foreground="#757575"
+                   Margin="0,0,0,20"/>
+        
+        <!-- 直接显示下拉选择框（无卡片）| Direct ComboBox display (no card) -->
+        <telerik:RadComboBox Grid.Row="2"
+                             ItemsSource="{Binding AvailableLanguages}"
+                             SelectedItem="{Binding SelectedLanguage, Mode=TwoWay}"
+                             HorizontalAlignment="Stretch"
+                             VerticalAlignment="Center"
+                             Height="36"
+                             Margin="0,0,0,16"
+                             telerik:StyleManager.Theme="Crystal">
+            <telerik:RadComboBox.ItemTemplate>
+                <DataTemplate>
+                    <StackPanel Orientation="Horizontal" Margin="4,2">
+                        <!-- 语言标志 | Language flag -->
+                        <TextBlock Text="{Binding Flag}" 
+                                   Margin="0,0,8,0"
+                                   FontSize="16"
+                                   VerticalAlignment="Center"/>
+                        <!-- 语言名称 | Language name -->
+                        <TextBlock Text="{Binding DisplayName}" 
+                                   VerticalAlignment="Center"
+                                   FontSize="13"/>
+                    </StackPanel>
+                </DataTemplate>
+            </telerik:RadComboBox.ItemTemplate>
+        </telerik:RadComboBox>
+        
+        <!-- 提示信息区域 | Notice information area -->
+        <Border Grid.Row="3"
+                Background="#E3F2FD"
+                BorderBrush="#2196F3"
+                BorderThickness="1"
+                CornerRadius="4"
+                Padding="12"
+                Margin="0,0,0,16">
+            <Grid>
+                <Grid.ColumnDefinitions>
+                    <ColumnDefinition Width="Auto"/>
+                    <ColumnDefinition Width="*"/>
+                </Grid.ColumnDefinitions>
+                
+                <!-- 信息图标 | Information icon -->
+                <Path Grid.Column="0"
+                      Data="M12,2C6.48,2 2,6.48 2,12C2,17.52 6.48,22 12,22C17.52,22 22,17.52 22,12C22,6.48 17.52,2 12,2M13,17H11V11H13V17M13,9H11V7H13V9Z"
+                      Fill="#2196F3"
+                      Width="20"
+                      Height="20"
+                      Stretch="Uniform"
+                      VerticalAlignment="Top"
+                      Margin="0,2,12,0"/>
+                
+                <!-- 提示文本 | Notice text -->
+                <TextBlock Grid.Column="1"
+                           Text="{Binding PreviewRestartNotice}"
+                           FontSize="12"
+                           FontWeight="Medium"
+                           Foreground="#1976D2"
+                           TextWrapping="Wrap"
+                           VerticalAlignment="Center"/>
+            </Grid>
+        </Border>
+        
+        <!-- 占位空间 | Spacer -->
+        <Grid Grid.Row="4"/>
+        
+        <!-- 底部操作区 | Bottom action area -->
+        <Grid Grid.Row="5">
+            <Grid.ColumnDefinitions>
+                <ColumnDefinition Width="*"/>
+                <ColumnDefinition Width="Auto"/>
+            </Grid.ColumnDefinitions>
+            
+            <!-- 应用按钮（绿色）| Apply button (green) -->
+            <telerik:RadButton Grid.Column="1"
+                               Content="{Binding PreviewApplyButtonText}"
+                               Command="{Binding ApplyCommand}"
+                               Width="100"
+                               Height="36"
+                               telerik:StyleManager.Theme="Crystal">
+                <telerik:RadButton.Background>
+                    <LinearGradientBrush EndPoint="0.5,1" StartPoint="0.5,0">
+                        <GradientStop Color="White"/>
+                        <GradientStop Color="#FF77E062" Offset="1"/>
+                    </LinearGradientBrush>
+                </telerik:RadButton.Background>
+            </telerik:RadButton>
+        </Grid>
+    </Grid>
+</Window>

XP.Common/Localization/Views/LanguageSwitcherWindow.xaml.cs

@@ -0,0 +1,28 @@
+using System.Windows;
+using XP.Common.Localization.ViewModels;
+
+namespace XP.Common.Localization.Views
+{
+    /// <summary>
+    /// LanguageSwitcherWindow.xaml 的交互逻辑 | Interaction logic for LanguageSwitcherWindow.xaml
+    /// </summary>
+    public partial class LanguageSwitcherWindow : Window
+    {
+        public LanguageSwitcherWindow()
+        {
+            InitializeComponent();
+        }
+
+        /// <summary>
+        /// 构造函数（带 ViewModel）| Constructor (with ViewModel)
+        /// </summary>
+        /// <param name="viewModel">语言切换器 ViewModel | Language switcher ViewModel</param>
+        public LanguageSwitcherWindow(LanguageSwitcherViewModel viewModel) : this()
+        {
+            DataContext = viewModel;
+
+            if (Application.Current?.MainWindow != null)
+                Icon = Application.Current.MainWindow.Icon;
+        }
+    }
+}

XP.Common/Logging/Implementations/SerilogLoggerService.cs

@@ -0,0 +1,74 @@
+using System;
+using Serilog;
+using XP.Common.Logging.Interfaces;
+
+namespace XP.Common.Logging.Implementations
+{
+    /// <summary>
+    /// Serilog日志服务实现（适配ILoggerService接口）| Serilog logger service implementation (adapts ILoggerService interface)
+    /// </summary>
+    public class SerilogLoggerService : ILoggerService
+    {
+        private ILogger _logger;
+
+        /// <summary>
+        /// 构造函数：初始化全局日志实例 | Constructor: initialize global logger instance
+        /// </summary>
+        public SerilogLoggerService()
+        {
+            _logger = Log.Logger;
+        }
+
+        /// <summary>
+        /// 私有构造函数：用于模块标记 | Private constructor: for module tagging
+        /// </summary>
+        private SerilogLoggerService(ILogger logger)
+        {
+            _logger = logger ?? Log.Logger;
+        }
+
+        public void Debug(string message, params object[] args)
+        {
+            _logger.Debug(message, args);
+        }
+
+        public void Info(string message, params object[] args)
+        {
+            _logger.Information(message, args);
+        }
+
+        public void Warn(string message, params object[] args)
+        {
+            _logger.Warning(message, args);
+        }
+
+        public void Error(Exception ex, string message, params object[] args)
+        {
+            _logger.Error(ex, message, args);
+        }
+
+        public void Fatal(Exception ex, string message, params object[] args)
+        {
+            _logger.Fatal(ex, message, args);
+        }
+
+        /// <summary>
+        /// 手动指定模块名 | Manually specify module name
+        /// </summary>
+        public ILoggerService ForModule(string moduleName)
+        {
+            if (string.IsNullOrEmpty(moduleName)) return this;
+            return new SerilogLoggerService(_logger.ForContext("SourceContext", moduleName));
+        }
+
+        /// <summary>
+        /// 自动使用类型全名作为模块名 | Automatically use type full name as module name
+        /// </summary>
+        /// <typeparam name="T">类型参数 | Type parameter</typeparam>
+        public ILoggerService ForModule<T>()
+        {
+            var typeName = typeof(T).FullName ?? typeof(T).Name;
+            return new SerilogLoggerService(_logger.ForContext("SourceContext", typeName));
+        }
+    }
+}

XP.Common/Logging/Interfaces/ILoggerService.cs

@@ -0,0 +1,47 @@
+using System;
+
+namespace XP.Common.Logging.Interfaces
+{
+    /// <summary>
+    /// 通用日志服务接口（与具体日志框架解耦）| Generic logger service interface (decoupled from specific logging framework)
+    /// </summary>
+    public interface ILoggerService
+    {
+        /// <summary>
+        /// 调试日志 | Debug log
+        /// </summary>
+        void Debug(string message, params object[] args);
+
+        /// <summary>
+        /// 信息日志 | Information log
+        /// </summary>
+        void Info(string message, params object[] args);
+
+        /// <summary>
+        /// 警告日志 | Warning log
+        /// </summary>
+        void Warn(string message, params object[] args);
+
+        /// <summary>
+        /// 错误日志（带异常）| Error log (with exception)
+        /// </summary>
+        void Error(Exception ex, string message, params object[] args);
+
+        /// <summary>
+        /// 致命错误日志（带异常）| Fatal error log (with exception)
+        /// </summary>
+        void Fatal(Exception ex, string message, params object[] args);
+
+        /// <summary>
+        /// 标记日志所属模块（手动指定模块名）| Mark logger module (manually specify module name)
+        /// </summary>
+        /// <param name="moduleName">模块名称 | Module name</param>
+        ILoggerService ForModule(string moduleName);
+
+        /// <summary>
+        /// 标记日志所属模块（自动使用类型全名）| Mark logger module (automatically use type full name)
+        /// </summary>
+        /// <typeparam name="T">类型参数（自动推断命名空间+类名）| Type parameter (automatically infer namespace + class name)</typeparam>
+        ILoggerService ForModule<T>();
+    }
+}

XP.Common/Logging/SerilogInitializer.cs

@@ -0,0 +1,57 @@
+using System;
+using Serilog;
+using Serilog.Events;
+using XP.Common.Configs;
+using XP.Common.Logging.ViewModels;
+
+namespace XP.Common.Logging
+{
+    /// <summary>
+    /// Serilog全局初始化工具（应用启动时调用一次）
+    /// </summary>
+    public static class SerilogInitializer
+    {
+        /// <summary>
+        /// 初始化Serilog日志
+        /// </summary>
+        public static void Initialize(SerilogConfig config)
+        {
+            if (config == null) throw new ArgumentNullException(nameof(config));
+
+            // 确保日志目录存在
+            if (!System.IO.Directory.Exists(config.LogPath))
+                System.IO.Directory.CreateDirectory(config.LogPath);
+
+            // 解析日志级别
+            if (!Enum.TryParse<LogEventLevel>(config.MinimumLevel, true, out var minLevel))
+                minLevel = LogEventLevel.Information;
+
+            // 解析文件分割规则
+            if (!Enum.TryParse<RollingInterval>(config.RollingInterval, true, out var rollingInterval))
+                rollingInterval = RollingInterval.Day;
+
+            // 构建Serilog配置
+            var loggerConfig = new LoggerConfiguration()
+                .MinimumLevel.Is(minLevel)
+                .Enrich.FromLogContext() // 启用上下文（模块标记）
+                .WriteTo.File(
+                    path: System.IO.Path.Combine(config.LogPath, "app_.log"), // 最终文件名：app_20260307.log
+                    rollingInterval: rollingInterval,
+                    fileSizeLimitBytes: config.FileSizeLimitMB * 1024 * 1024,
+                    retainedFileCountLimit: config.RetainedFileCountLimit,
+                    outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff} [{Level:u3}] [{SourceContext}] {Message:lj}{NewLine}{Exception}"
+                );
+
+            // 调试环境输出到控制台
+            if (config.EnableConsole)
+                loggerConfig.WriteTo.Console(
+                    outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff} [{Level:u3}] [{SourceContext}] {Message:lj}{NewLine}{Exception}");
+
+            // 注册实时日志查看器 Sink（接收所有级别日志）| Register real-time log viewer sink (receive all levels)
+            loggerConfig.WriteTo.Sink(RealTimeLogSink.Instance, Serilog.Events.LogEventLevel.Verbose);
+
+            // 全局初始化
+            Log.Logger = loggerConfig.CreateLogger();
+        }
+    }
+}

XP.Common/Logging/ViewModels/RealTimeLogSink.cs

@@ -0,0 +1,49 @@
+using System;
+using System.Collections.Concurrent;
+using System.Collections.Generic;
+using System.Linq;
+using Serilog.Core;
+using Serilog.Events;
+
+namespace XP.Common.Logging.ViewModels
+{
+    /// <summary>
+    /// Serilog 自定义 Sink，将日志事件转发到 RealTimeLogViewerViewModel，并维护环形缓冲区
+    /// Custom Serilog Sink that forwards log events and maintains a ring buffer for history
+    /// </summary>
+    public class RealTimeLogSink : ILogEventSink
+    {
+        private const int BufferCapacity = 500;
+        private readonly ConcurrentQueue<LogEvent> _buffer = new();
+
+        /// <summary>
+        /// 全局单例实例 | Global singleton instance
+        /// </summary>
+        public static RealTimeLogSink Instance { get; } = new();
+
+        /// <summary>
+        /// 日志事件到达时触发 | Fired when a log event arrives
+        /// </summary>
+        public event Action<LogEvent>? LogEventReceived;
+
+        public void Emit(LogEvent logEvent)
+        {
+            // 入队缓冲区 | Enqueue to buffer
+            _buffer.Enqueue(logEvent);
+            while (_buffer.Count > BufferCapacity)
+            {
+                _buffer.TryDequeue(out _);
+            }
+
+            LogEventReceived?.Invoke(logEvent);
+        }
+
+        /// <summary>
+        /// 获取缓冲区中的历史日志快照 | Get a snapshot of buffered history logs
+        /// </summary>
+        public List<LogEvent> GetBufferedHistory()
+        {
+            return _buffer.ToList();
+        }
+    }
+}

XP.Common/Logging/ViewModels/RealTimeLogViewerViewModel.cs

@@ -0,0 +1,329 @@
+using System;
+using System.Collections.ObjectModel;
+using System.Linq;
+using System.Windows;
+using System.Windows.Media;
+using System.Windows.Threading;
+using Prism.Commands;
+using Prism.Mvvm;
+using Serilog.Events;
+using XP.Common.Localization;
+
+namespace XP.Common.Logging.ViewModels
+{
+    /// <summary>
+    /// 实时日志查看器 ViewModel，管理日志条目、过滤、自动滚动等逻辑
+    /// Real-time log viewer ViewModel, manages log entries, filtering, auto-scroll, etc.
+    /// </summary>
+    public class RealTimeLogViewerViewModel : BindableBase
+    {
+        private readonly Dispatcher _dispatcher;
+        private readonly ObservableCollection<LogDisplayEntry> _allEntries = new();
+        private string _filterText = string.Empty;
+        private bool _isAutoScroll = true;
+        private int _maxLines = 2000;
+        private int _totalCount;
+        private int _filteredCount;
+        private bool _showDebug = true;
+        private bool _showInfo = true;
+        private bool _showWarning = true;
+        private bool _showError = true;
+        private bool _showFatal = true;
+
+        public RealTimeLogViewerViewModel()
+        {
+            _dispatcher = Application.Current?.Dispatcher ?? Dispatcher.CurrentDispatcher;
+
+            FilteredEntries = new ObservableCollection<LogDisplayEntry>();
+            ClearCommand = new DelegateCommand(ClearAll);
+        }
+
+        /// <summary>
+        /// 过滤后的日志条目集合（绑定到 UI）| Filtered log entries (bound to UI)
+        /// </summary>
+        public ObservableCollection<LogDisplayEntry> FilteredEntries { get; }
+
+        /// <summary>
+        /// 过滤关键词 | Filter keyword
+        /// </summary>
+        public string FilterText
+        {
+            get => _filterText;
+            set
+            {
+                if (SetProperty(ref _filterText, value))
+                {
+                    ApplyFilter();
+                }
+            }
+        }
+
+        /// <summary>
+        /// 是否自动滚动到底部 | Whether to auto-scroll to bottom
+        /// </summary>
+        public bool IsAutoScroll
+        {
+            get => _isAutoScroll;
+            set => SetProperty(ref _isAutoScroll, value);
+        }
+
+        /// <summary>
+        /// 最大行数限制 | Maximum line count limit
+        /// </summary>
+        public int MaxLines
+        {
+            get => _maxLines;
+            set => SetProperty(ref _maxLines, value);
+        }
+
+        /// <summary>
+        /// 总日志条数 | Total log entry count
+        /// </summary>
+        public int TotalCount
+        {
+            get => _totalCount;
+            private set => SetProperty(ref _totalCount, value);
+        }
+
+        /// <summary>
+        /// 过滤后的日志条数 | Filtered log entry count
+        /// </summary>
+        public int FilteredCount
+        {
+            get => _filteredCount;
+            private set => SetProperty(ref _filteredCount, value);
+        }
+
+        /// <summary>
+        /// 是否显示 Debug 级别日志 | Whether to show Debug level logs
+        /// </summary>
+        public bool ShowDebug
+        {
+            get => _showDebug;
+            set { if (SetProperty(ref _showDebug, value)) ApplyFilter(); }
+        }
+
+        /// <summary>
+        /// 是否显示 Info 级别日志 | Whether to show Information level logs
+        /// </summary>
+        public bool ShowInfo
+        {
+            get => _showInfo;
+            set { if (SetProperty(ref _showInfo, value)) ApplyFilter(); }
+        }
+
+        /// <summary>
+        /// 是否显示 Warning 级别日志 | Whether to show Warning level logs
+        /// </summary>
+        public bool ShowWarning
+        {
+            get => _showWarning;
+            set { if (SetProperty(ref _showWarning, value)) ApplyFilter(); }
+        }
+
+        /// <summary>
+        /// 是否显示 Error 级别日志 | Whether to show Error level logs
+        /// </summary>
+        public bool ShowError
+        {
+            get => _showError;
+            set { if (SetProperty(ref _showError, value)) ApplyFilter(); }
+        }
+
+        /// <summary>
+        /// 是否显示 Fatal 级别日志 | Whether to show Fatal level logs
+        /// </summary>
+        public bool ShowFatal
+        {
+            get => _showFatal;
+            set { if (SetProperty(ref _showFatal, value)) ApplyFilter(); }
+        }
+
+        /// <summary>
+        /// 状态栏文本 | Status bar text
+        /// </summary>
+        public string StatusText
+        {
+            get
+            {
+                bool hasLevelFilter = !(_showDebug && _showInfo && _showWarning && _showError && _showFatal);
+                bool hasTextFilter = !string.IsNullOrEmpty(_filterText);
+                if (hasLevelFilter || hasTextFilter)
+                    return LocalizationHelper.Get("LogViewer_StatusFiltered", TotalCount, FilteredCount);
+                return LocalizationHelper.Get("LogViewer_StatusTotal", TotalCount);
+            }
+        }
+
+        /// <summary>
+        /// 清空日志命令 | Clear log command
+        /// </summary>
+        public DelegateCommand ClearCommand { get; }
+
+        /// <summary>
+        /// 自动滚动请求事件，View 层订阅此事件执行滚动 | Auto-scroll request event
+        /// </summary>
+        public event Action? ScrollToBottomRequested;
+
+        /// <summary>
+        /// 添加日志事件（线程安全，可从任意线程调用）| Add log event (thread-safe)
+        /// </summary>
+        public void AddLogEvent(LogEvent logEvent)
+        {
+            if (logEvent == null) return;
+
+            var entry = new LogDisplayEntry(logEvent);
+
+            if (_dispatcher.CheckAccess())
+            {
+                AddEntryInternal(entry);
+            }
+            else
+            {
+                _dispatcher.InvokeAsync(() => AddEntryInternal(entry));
+            }
+        }
+
+        /// <summary>
+        /// 内部添加日志条目 | Internal add log entry
+        /// </summary>
+        private void AddEntryInternal(LogDisplayEntry entry)
+        {
+            _allEntries.Add(entry);
+
+            // 超出最大行数时移除最旧的条目 | Remove oldest entries when exceeding max lines
+            while (_allEntries.Count > _maxLines)
+            {
+                var removed = _allEntries[0];
+                _allEntries.RemoveAt(0);
+                FilteredEntries.Remove(removed);
+            }
+
+            // 判断是否匹配过滤条件 | Check if entry matches filter
+            if (MatchesFilter(entry))
+            {
+                FilteredEntries.Add(entry);
+            }
+
+            TotalCount = _allEntries.Count;
+            FilteredCount = FilteredEntries.Count;
+            RaisePropertyChanged(nameof(StatusText));
+
+            // 请求自动滚动 | Request auto-scroll
+            if (_isAutoScroll)
+            {
+                ScrollToBottomRequested?.Invoke();
+            }
+        }
+
+        /// <summary>
+        /// 应用过滤器 | Apply filter
+        /// </summary>
+        private void ApplyFilter()
+        {
+            FilteredEntries.Clear();
+
+            foreach (var entry in _allEntries)
+            {
+                if (MatchesFilter(entry))
+                {
+                    FilteredEntries.Add(entry);
+                }
+            }
+
+            FilteredCount = FilteredEntries.Count;
+            RaisePropertyChanged(nameof(StatusText));
+        }
+
+        /// <summary>
+        /// 判断条目是否匹配过滤条件 | Check if entry matches filter
+        /// </summary>
+        private bool MatchesFilter(LogDisplayEntry entry)
+        {
+            // 级别过滤 | Level filter
+            var levelMatch = entry.LevelFull switch
+            {
+                "Debug" => _showDebug,
+                "Information" => _showInfo,
+                "Warning" => _showWarning,
+                "Error" => _showError,
+                "Fatal" => _showFatal,
+                _ => true
+            };
+            if (!levelMatch) return false;
+
+            // 关键词过滤 | Keyword filter
+            if (string.IsNullOrWhiteSpace(_filterText)) return true;
+            return entry.Message.Contains(_filterText, StringComparison.OrdinalIgnoreCase)
+                || entry.Level.Contains(_filterText, StringComparison.OrdinalIgnoreCase)
+                || entry.Source.Contains(_filterText, StringComparison.OrdinalIgnoreCase);
+        }
+
+        /// <summary>
+        /// 清空所有日志 | Clear all logs
+        /// </summary>
+        private void ClearAll()
+        {
+            _allEntries.Clear();
+            FilteredEntries.Clear();
+            TotalCount = 0;
+            FilteredCount = 0;
+            RaisePropertyChanged(nameof(StatusText));
+        }
+    }
+
+    /// <summary>
+    /// 日志显示条目模型 | Log display entry model
+    /// </summary>
+    public class LogDisplayEntry
+    {
+        public LogDisplayEntry(LogEvent logEvent)
+        {
+            Timestamp = logEvent.Timestamp.LocalDateTime;
+            TimestampDisplay = Timestamp.ToString("HH:mm:ss.fff");
+            Level = logEvent.Level.ToString().Substring(0, 3).ToUpper();
+            LevelFull = logEvent.Level.ToString();
+
+            // 渲染消息文本 | Render message text
+            Message = logEvent.RenderMessage();
+
+            // 如果有异常，追加异常信息 | Append exception info if present
+            if (logEvent.Exception != null)
+            {
+                Message += Environment.NewLine + logEvent.Exception.ToString();
+            }
+
+            // 提取 SourceContext | Extract SourceContext
+            if (logEvent.Properties.TryGetValue("SourceContext", out var sourceValue))
+            {
+                Source = sourceValue.ToString().Trim('"');
+            }
+            else
+            {
+                Source = string.Empty;
+            }
+
+            // 根据日志级别设置颜色 | Set color based on log level
+            LevelColor = logEvent.Level switch
+            {
+                LogEventLevel.Fatal => new SolidColorBrush(Color.FromRgb(180, 0, 0)),
+                LogEventLevel.Error => new SolidColorBrush(Colors.Red),
+                LogEventLevel.Warning => new SolidColorBrush(Color.FromRgb(200, 130, 0)),
+                LogEventLevel.Debug => new SolidColorBrush(Colors.Gray),
+                LogEventLevel.Verbose => new SolidColorBrush(Colors.LightGray),
+                _ => new SolidColorBrush(Color.FromRgb(30, 30, 30))
+            };
+
+            // Freeze 画刷，使其可跨线程访问（避免 DependencySource 线程异常）
+            // Freeze the brush so it can be accessed from any thread
+            LevelColor.Freeze();
+        }
+
+        public DateTime Timestamp { get; }
+        public string TimestampDisplay { get; }
+        public string Level { get; }
+        public string LevelFull { get; }
+        public string Message { get; }
+        public string Source { get; }
+        public SolidColorBrush LevelColor { get; }
+    }
+}

XP.Common/Logging/Views/RealTimeLogViewer.xaml

@@ -0,0 +1,148 @@
+<Window x:Class="XP.Common.GeneralForm.Views.RealTimeLogViewer"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation"
+        xmlns:loc="clr-namespace:XP.Common.Localization.Extensions"
+        Title="{loc:Localization LogViewer_Title}"
+        Width="960" Height="600"
+        MinWidth="700" MinHeight="400"
+        WindowStartupLocation="CenterScreen"
+        ShowInTaskbar="True"
+        WindowStyle="SingleBorderWindow">
+
+    <Grid>
+        <Grid.RowDefinitions>
+            <!-- 顶部工具栏 | Top toolbar -->
+            <RowDefinition Height="Auto"/>
+            <!-- 级别筛选栏 | Level filter bar -->
+            <RowDefinition Height="Auto"/>
+            <!-- 日志显示区 | Log display area -->
+            <RowDefinition Height="*"/>
+            <!-- 底部状态栏 | Bottom status bar -->
+            <RowDefinition Height="Auto"/>
+        </Grid.RowDefinitions>
+
+        <!-- === 顶部工具栏 | Top Toolbar === -->
+        <DockPanel Grid.Row="0" Margin="8,6" LastChildFill="True">
+            <!-- 左侧：自动滚动开关 + 清空按钮 | Left: Auto-scroll toggle + Clear button -->
+            <StackPanel DockPanel.Dock="Left" Orientation="Horizontal" VerticalAlignment="Center">
+                <telerik:RadToggleButton x:Name="AutoScrollToggle"
+                                         telerik:StyleManager.Theme="Crystal"
+                                         IsChecked="{Binding IsAutoScroll, Mode=TwoWay}"
+                                         Content="{loc:Localization LogViewer_AutoScroll}"
+                                         Padding="10,4" Margin="0,0,6,0"/>
+                <telerik:RadButton telerik:StyleManager.Theme="Crystal"
+                                   Command="{Binding ClearCommand}"
+                                   Content="{loc:Localization LogViewer_ClearLog}"
+                                   Padding="10,4" Margin="0,0,12,0"/>
+            </StackPanel>
+
+            <!-- 右侧：过滤输入框 | Right: Filter input -->
+            <StackPanel Orientation="Horizontal" HorizontalAlignment="Right" VerticalAlignment="Center">
+                <TextBlock Text="{loc:Localization LogViewer_Filter}" VerticalAlignment="Center" Margin="0,0,4,0"/>
+                <telerik:RadWatermarkTextBox telerik:StyleManager.Theme="Crystal"
+                                             Text="{Binding FilterText, UpdateSourceTrigger=PropertyChanged, Delay=300}"
+                                             WatermarkContent="{loc:Localization LogViewer_FilterWatermark}"
+                                             Width="260" Padding="4,3"
+                                             VerticalAlignment="Center"/>
+            </StackPanel>
+        </DockPanel>
+
+        <!-- === 级别筛选栏 | Level Filter Bar === -->
+        <Border Grid.Row="1" Background="#FFF8F8F8" BorderBrush="#FFDDDDDD" BorderThickness="0,0,0,1" Padding="8,4">
+            <StackPanel Orientation="Horizontal" VerticalAlignment="Center">
+                <TextBlock Text="{loc:Localization LogViewer_LevelFilter}" VerticalAlignment="Center" Margin="0,0,8,0" Foreground="#FF666666" FontSize="12"/>
+                <CheckBox Content="Debug" IsChecked="{Binding ShowDebug}" VerticalAlignment="Center" Margin="0,0,10,0" Foreground="Gray"/>
+                <CheckBox Content="Info" IsChecked="{Binding ShowInfo}" VerticalAlignment="Center" Margin="0,0,10,0" Foreground="#FF1E1E1E"/>
+                <CheckBox Content="Warning" IsChecked="{Binding ShowWarning}" VerticalAlignment="Center" Margin="0,0,10,0" Foreground="#FFC88200"/>
+                <CheckBox Content="Error" IsChecked="{Binding ShowError}" VerticalAlignment="Center" Margin="0,0,10,0" Foreground="Red"/>
+                <CheckBox Content="Fatal" IsChecked="{Binding ShowFatal}" VerticalAlignment="Center" Margin="0,0,10,0" Foreground="#FFB40000"/>
+            </StackPanel>
+        </Border>
+
+        <!-- === 日志显示区（RadGridView）| Log Display Area === -->
+        <telerik:RadGridView Grid.Row="2"
+                             x:Name="LogGridView"
+                             telerik:StyleManager.Theme="Crystal"
+                             ItemsSource="{Binding FilteredEntries}"
+                             AutoGenerateColumns="False"
+                             IsReadOnly="True"
+                             RowIndicatorVisibility="Collapsed"
+                             ShowGroupPanel="False"
+                             ShowColumnHeaders="True"
+                             CanUserFreezeColumns="False"
+                             CanUserReorderColumns="False"
+                             CanUserSortColumns="False"
+                             CanUserResizeColumns="True"
+                             IsFilteringAllowed="False"
+                             SelectionMode="Extended"
+                             FontFamily="Consolas"
+                             FontSize="12"
+                             Margin="4,0,4,0">
+            <telerik:RadGridView.Columns>
+                <!-- 时间戳列 | Timestamp column -->
+                <telerik:GridViewDataColumn Header="{loc:Localization LogViewer_ColTime}"
+                                            DataMemberBinding="{Binding TimestampDisplay}"
+                                            Width="100"
+                                            IsReadOnly="True"/>
+
+                <!-- 级别列 | Level column -->
+                <telerik:GridViewDataColumn Header="{loc:Localization LogViewer_ColLevel}"
+                                            DataMemberBinding="{Binding Level}"
+                                            Width="60"
+                                            IsReadOnly="True">
+                    <telerik:GridViewDataColumn.CellStyle>
+                        <Style TargetType="telerik:GridViewCell">
+                            <Setter Property="Foreground" Value="{Binding LevelColor}"/>
+                            <Setter Property="FontWeight" Value="SemiBold"/>
+                        </Style>
+                    </telerik:GridViewDataColumn.CellStyle>
+                </telerik:GridViewDataColumn>
+
+                <!-- 来源列 | Source column -->
+                <telerik:GridViewDataColumn Header="{loc:Localization LogViewer_ColSource}"
+                                            DataMemberBinding="{Binding Source}"
+                                            Width="200"
+                                            IsReadOnly="True">
+                    <telerik:GridViewDataColumn.CellStyle>
+                        <Style TargetType="telerik:GridViewCell">
+                            <Setter Property="Foreground" Value="{Binding LevelColor}"/>
+                        </Style>
+                    </telerik:GridViewDataColumn.CellStyle>
+                </telerik:GridViewDataColumn>
+
+                <!-- 消息列 | Message column -->
+                <telerik:GridViewDataColumn Header="{loc:Localization LogViewer_ColMessage}"
+                                            DataMemberBinding="{Binding Message}"
+                                            Width="*"
+                                            IsReadOnly="True">
+                    <telerik:GridViewDataColumn.CellStyle>
+                        <Style TargetType="telerik:GridViewCell">
+                            <Setter Property="Foreground" Value="{Binding LevelColor}"/>
+                        </Style>
+                    </telerik:GridViewDataColumn.CellStyle>
+                </telerik:GridViewDataColumn>
+            </telerik:RadGridView.Columns>
+        </telerik:RadGridView>
+
+        <!-- === 底部状态栏 | Bottom Status Bar === -->
+        <StatusBar Grid.Row="3" Background="#FFF0F0F0" BorderBrush="#FFCCCCCC" BorderThickness="0,1,0,0">
+            <StatusBarItem>
+                <TextBlock Text="{Binding StatusText}" Foreground="#FF666666" FontSize="12"/>
+            </StatusBarItem>
+            <Separator/>
+            <StatusBarItem HorizontalAlignment="Right">
+                <StackPanel Orientation="Horizontal">
+                    <TextBlock Text="{loc:Localization LogViewer_MaxLines}" Foreground="#FF999999" FontSize="11" VerticalAlignment="Center"/>
+                    <telerik:RadNumericUpDown telerik:StyleManager.Theme="Crystal"
+                                              Value="{Binding MaxLines, Mode=TwoWay}"
+                                              Minimum="100" Maximum="10000"
+                                              NumberDecimalDigits="0"
+                                              SmallChange="500"
+                                              Width="90" Height="22"
+                                              VerticalAlignment="Center"/>
+                </StackPanel>
+            </StatusBarItem>
+        </StatusBar>
+    </Grid>
+</Window>

XP.Common/Logging/Views/RealTimeLogViewer.xaml.cs

@@ -0,0 +1,85 @@
+using System;
+using System.Windows;
+using Serilog.Events;
+using XP.Common.Logging.ViewModels;
+
+namespace XP.Common.GeneralForm.Views
+{
+    /// <summary>
+    /// 实时日志查看器窗口，订阅 Serilog 事件并实时显示
+    /// Real-time log viewer window, subscribes to Serilog events and displays in real-time
+    /// </summary>
+    public partial class RealTimeLogViewer : Window
+    {
+        private readonly RealTimeLogViewerViewModel _viewModel;
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="maxLines">最大行数限制，默认 2000 | Max line count, default 2000</param>
+        public RealTimeLogViewer(int maxLines = 2000)
+        {
+            _viewModel = new RealTimeLogViewerViewModel { MaxLines = maxLines };
+            DataContext = _viewModel;
+
+            InitializeComponent();
+
+            // 继承主窗口图标 | Inherit main window icon
+            if (Application.Current?.MainWindow != null)
+            {
+                Icon = Application.Current.MainWindow.Icon;
+            }
+
+            // 订阅自动滚动事件 | Subscribe to auto-scroll event
+            _viewModel.ScrollToBottomRequested += OnScrollToBottomRequested;
+
+            // 加载缓冲区中的历史日志 | Load buffered history logs
+            var history = RealTimeLogSink.Instance.GetBufferedHistory();
+            foreach (var logEvent in history)
+            {
+                _viewModel.AddLogEvent(logEvent);
+            }
+
+            // 订阅 Serilog Sink 事件（在历史加载之后，避免重复）| Subscribe after history load
+            RealTimeLogSink.Instance.LogEventReceived += OnLogEventReceived;
+
+            Closed += OnWindowClosed;
+        }
+
+        /// <summary>
+        /// 接收 Serilog 日志事件 | Receive Serilog log event
+        /// </summary>
+        private void OnLogEventReceived(LogEvent logEvent)
+        {
+            _viewModel.AddLogEvent(logEvent);
+        }
+
+        /// <summary>
+        /// 自动滚动到底部 | Auto-scroll to bottom
+        /// </summary>
+        private void OnScrollToBottomRequested()
+        {
+            try
+            {
+                if (LogGridView.Items.Count > 0)
+                {
+                    var lastItem = LogGridView.Items[LogGridView.Items.Count - 1];
+                    LogGridView.ScrollIntoView(lastItem);
+                }
+            }
+            catch
+            {
+                // 滚动失败时静默处理 | Silently handle scroll failures
+            }
+        }
+
+        /// <summary>
+        /// 窗口关闭时取消订阅，防止内存泄漏 | Unsubscribe on close to prevent memory leaks
+        /// </summary>
+        private void OnWindowClosed(object? sender, EventArgs e)
+        {
+            _viewModel.ScrollToBottomRequested -= OnScrollToBottomRequested;
+            RealTimeLogSink.Instance.LogEventReceived -= OnLogEventReceived;
+        }
+    }
+}

XP.Common/Module/CommonModule.cs

@@ -0,0 +1,80 @@
+using System;
+using Prism.Ioc;
+using Prism.Modularity;
+using XP.Common.Dump.Configs;
+using XP.Common.Dump.Implementations;
+using XP.Common.Dump.Interfaces;
+using XP.Common.Helpers;
+using XP.Common.Localization.Configs;
+using XP.Common.Localization.Extensions;
+using XP.Common.Localization.Implementations;
+using XP.Common.Localization.Interfaces;
+using XP.Common.Logging.Interfaces;
+using XP.Common.PdfViewer.Implementations;
+using XP.Common.PdfViewer.Interfaces;
+
+namespace XP.Common.Module
+{
+    /// <summary>
+    /// 通用模块 | Common module
+    /// 提供通用基础设施服务，包括本地化支持 | Provides common infrastructure services including localization support
+    /// </summary>
+    public class CommonModule : IModule
+    {
+        /// <summary>
+        /// 模块初始化 | Module initialization
+        /// 在所有类型注册完成后调用 | Called after all types are registered
+        /// </summary>
+        public void OnInitialized(IContainerProvider containerProvider)
+        {
+            // 获取日志服务 | Get logger service
+            var logger = containerProvider.Resolve<ILoggerService>().ForModule("XP.Common.Module.CommonModule");
+            
+            try
+            {
+                // 解析本地化服务 | Resolve localization service
+                var localizationService = containerProvider.Resolve<ILocalizationService>();
+                
+                // 初始化 LocalizationExtension | Initialize LocalizationExtension
+                LocalizationExtension.Initialize(localizationService);
+                
+                logger.Info("本地化系统初始化成功 | Localization system initialized successfully");
+                logger.Info($"当前语言 | Current language: {localizationService.CurrentLanguage}");
+
+                // 启动 Dump 服务 | Start Dump service
+                var dumpService = containerProvider.Resolve<IDumpService>();
+                dumpService.Start();
+                logger.Info("Dump 服务初始化成功 | Dump service initialized successfully");
+            }
+            catch (Exception ex)
+            {
+                logger.Error(ex, "本地化系统初始化失败 | Localization system initialization failed");
+                throw;
+            }
+        }
+
+        /// <summary>
+        /// 注册类型到 DI 容器 | Register types to DI container
+        /// </summary>
+        public void RegisterTypes(IContainerRegistry containerRegistry)
+        {
+            // 注册本地化配置服务为单例 | Register localization config service as singleton
+            containerRegistry.RegisterSingleton<ILocalizationConfig, LocalizationConfig>();
+            
+            // 注册本地化服务为单例 | Register localization service as singleton
+            containerRegistry.RegisterSingleton<ILocalizationService, ResxLocalizationService>();
+
+            // 注册 Dump 配置为单例（通过工厂方法加载）| Register Dump config as singleton (via factory method)
+            containerRegistry.RegisterSingleton<DumpConfig>(() => ConfigLoader.LoadDumpConfig());
+
+            // 注册 Dump 服务为单例 | Register Dump service as singleton
+            containerRegistry.RegisterSingleton<IDumpService, DumpService>();
+
+            // 注册 PDF 打印服务为单例 | Register PDF print service as singleton
+            containerRegistry.RegisterSingleton<IPdfPrintService, PdfPrintService>();
+
+            // 注册 PDF 查看服务为单例 | Register PDF viewer service as singleton
+            containerRegistry.RegisterSingleton<IPdfViewerService, PdfViewerService>();
+        }
+    }
+}

XP.Common/PdfViewer/Exceptions/PdfLoadException.cs

@@ -0,0 +1,22 @@
+using System;
+
+namespace XP.Common.PdfViewer.Exceptions
+{
+    /// <summary>
+    /// PDF 加载异常 | PDF load exception
+    /// 当 PDF 文件格式无效或加载失败时抛出 | Thrown when PDF format is invalid or loading fails
+    /// </summary>
+    public class PdfLoadException : Exception
+    {
+        /// <summary>
+        /// 加载失败的文件路径 | File path that failed to load
+        /// </summary>
+        public string? FilePath { get; }
+
+        public PdfLoadException(string message, string? filePath = null, Exception? innerException = null)
+            : base(message, innerException)
+        {
+            FilePath = filePath;
+        }
+    }
+}

XP.Common/PdfViewer/Exceptions/PrintException.cs

@@ -0,0 +1,14 @@
+using System;
+
+namespace XP.Common.PdfViewer.Exceptions
+{
+    /// <summary>
+    /// 打印异常 | Print exception
+    /// 当打印过程中发生错误时抛出 | Thrown when an error occurs during printing
+    /// </summary>
+    public class PrintException : Exception
+    {
+        public PrintException(string message, Exception? innerException = null)
+            : base(message, innerException) { }
+    }
+}

XP.Common/PdfViewer/Exceptions/PrinterNotFoundException.cs

@@ -0,0 +1,22 @@
+using System;
+
+namespace XP.Common.PdfViewer.Exceptions
+{
+    /// <summary>
+    /// 打印机未找到异常 | Printer not found exception
+    /// 当指定的打印机名称不存在或不可用时抛出 | Thrown when specified printer is not found or unavailable
+    /// </summary>
+    public class PrinterNotFoundException : Exception
+    {
+        /// <summary>
+        /// 未找到的打印机名称 | Name of the printer that was not found
+        /// </summary>
+        public string PrinterName { get; }
+
+        public PrinterNotFoundException(string printerName)
+            : base($"打印机未找到 | Printer not found: {printerName}")
+        {
+            PrinterName = printerName;
+        }
+    }
+}

XP.Common/PdfViewer/Implementations/PdfPrintService.cs

@@ -0,0 +1,276 @@
+using System;
+using System.Drawing.Printing;
+using System.IO;
+using System.Windows;
+using System.Windows.Controls;
+using Telerik.Windows.Controls;
+using Telerik.Windows.Documents.Fixed.FormatProviders.Pdf;
+using Telerik.Windows.Documents.Fixed.Print;
+using XP.Common.Logging.Interfaces;
+using XP.Common.PdfViewer.Exceptions;
+using XP.Common.PdfViewer.Interfaces;
+
+namespace XP.Common.PdfViewer.Implementations
+{
+    /// <summary>
+    /// PDF 打印服务实现 | PDF print service implementation
+    /// 基于 Telerik RadPdfViewer.Print() 实现 | Based on Telerik RadPdfViewer.Print()
+    /// </summary>
+    public class PdfPrintService : IPdfPrintService
+    {
+        private readonly ILoggerService _logger;
+
+        public PdfPrintService(ILoggerService logger)
+        {
+            _logger = logger?.ForModule<PdfPrintService>()
+                ?? throw new ArgumentNullException(nameof(logger));
+        }
+
+        /// <summary>
+        /// 使用指定打印机打印 PDF 文件 | Print PDF file with specified printer
+        /// </summary>
+        public void Print(string filePath, string printerName, int? pageFrom = null, int? pageTo = null, int copies = 1)
+        {
+            // 1. 验证文件路径存在 | Validate file path exists
+            ValidateFilePath(filePath);
+
+            // 2. 验证打印机名称有效 | Validate printer name is valid
+            ValidatePrinterName(printerName);
+
+            RadPdfViewer? pdfViewer = null;
+            try
+            {
+                // 3. 创建隐藏的 RadPdfViewer 并加载 PDF | Create hidden RadPdfViewer and load PDF
+                pdfViewer = CreatePdfViewerWithDocument(filePath);
+
+                // 4. 创建 PrintDialog 并配置打印机名称 | Create PrintDialog and configure printer name
+                var printDialog = new PrintDialog();
+                printDialog.PrintQueue = new System.Printing.PrintQueue(
+                    new System.Printing.LocalPrintServer(), printerName);
+
+                // 5. 配置页面范围 | Configure page range
+                if (pageFrom.HasValue || pageTo.HasValue)
+                {
+                    printDialog.PageRangeSelection = PageRangeSelection.UserPages;
+                    printDialog.PageRange = new PageRange(
+                        pageFrom ?? 1,
+                        pageTo ?? int.MaxValue);
+                }
+
+                // 6. 配置打印份数 | Configure copies
+                if (copies > 1)
+                {
+                    printDialog.PrintTicket.CopyCount = copies;
+                }
+
+                // 7. 配置 Telerik PrintSettings | Configure Telerik PrintSettings
+                var printSettings = new Telerik.Windows.Documents.Fixed.Print.PrintSettings
+                {
+                    DocumentName = Path.GetFileName(filePath),
+                    PageMargins = new Thickness(0),
+                    UseDefaultPrinter = false
+                };
+
+                // 8. 调用 RadPdfViewer.Print() 静默打印 | Call RadPdfViewer.Print() for silent printing
+                pdfViewer.Print(printDialog, printSettings);
+
+                // 9. 记录 Info 日志 | Log info
+                var pageRange = FormatPageRange(pageFrom, pageTo);
+                _logger.Info("打印任务已提交 | Print job submitted: {FileName} → {PrinterName}, 页面范围 | Pages: {PageRange}, 份数 | Copies: {Copies}",
+                    Path.GetFileName(filePath), printerName, pageRange, copies);
+            }
+            catch (Exception ex) when (ex is not FileNotFoundException
+                                    and not PrinterNotFoundException
+                                    and not PdfLoadException)
+            {
+                _logger.Error(ex, "打印失败 | Print failed: {FileName} → {PrinterName}", Path.GetFileName(filePath), printerName);
+                throw new PrintException($"打印失败 | Print failed: {Path.GetFileName(filePath)}", ex);
+            }
+            finally
+            {
+                // 10. 释放资源 | Release resources
+                DisposePdfViewer(pdfViewer);
+            }
+        }
+
+        /// <summary>
+        /// 打开打印设置对话框并打印 | Open print settings dialog and print
+        /// </summary>
+        public bool PrintWithDialog(string filePath)
+        {
+            // 1. 验证文件路径 | Validate file path
+            ValidateFilePath(filePath);
+
+            RadPdfViewer? pdfViewer = null;
+            try
+            {
+                // 2. 加载 PDF 到隐藏的 RadPdfViewer | Load PDF into hidden RadPdfViewer
+                pdfViewer = CreatePdfViewerWithDocument(filePath);
+
+                // 3. 配置 PrintSettings | Configure PrintSettings
+                var printSettings = new Telerik.Windows.Documents.Fixed.Print.PrintSettings
+                {
+                    DocumentName = Path.GetFileName(filePath),
+                    PageMargins = new Thickness(0),
+                    UseDefaultPrinter = false
+                };
+
+                // 4. 调用 RadPdfViewer.Print() 弹出 PrintDialog | Call RadPdfViewer.Print() to show PrintDialog
+                pdfViewer.Print(printSettings);
+
+                _logger.Info("用户通过对话框打印 | User printed via dialog: {FileName}", Path.GetFileName(filePath));
+                return true;
+            }
+            catch (Exception ex) when (ex is not FileNotFoundException and not PdfLoadException)
+            {
+                _logger.Error(ex, "打印失败 | Print failed: {FileName}", Path.GetFileName(filePath));
+                throw new PrintException($"打印失败 | Print failed: {Path.GetFileName(filePath)}", ex);
+            }
+            finally
+            {
+                // 5. 释放资源 | Release resources
+                DisposePdfViewer(pdfViewer);
+            }
+        }
+
+        /// <summary>
+        /// 打开打印预览对话框 | Open print preview dialog
+        /// </summary>
+        public void PrintPreview(string filePath)
+        {
+            // 1. 验证文件路径 | Validate file path
+            ValidateFilePath(filePath);
+
+            RadPdfViewer? pdfViewer = null;
+            try
+            {
+                // 2. 加载 PDF 到隐藏的 RadPdfViewer | Load PDF into hidden RadPdfViewer
+                pdfViewer = CreatePdfViewerWithDocument(filePath);
+
+                // 3. 通过 PrintDialog 显示预览 | Show preview via PrintDialog
+                var printDialog = new PrintDialog();
+
+                var printSettings = new Telerik.Windows.Documents.Fixed.Print.PrintSettings
+                {
+                    DocumentName = Path.GetFileName(filePath),
+                    PageMargins = new Thickness(0),
+                    UseDefaultPrinter = false
+                };
+
+                // 显示打印对话框（含预览功能）| Show print dialog (with preview capability)
+                pdfViewer.Print(printDialog, printSettings);
+
+                _logger.Info("打印预览已显示 | Print preview shown: {FileName}", Path.GetFileName(filePath));
+            }
+            catch (Exception ex) when (ex is not FileNotFoundException and not PdfLoadException)
+            {
+                _logger.Error(ex, "打印预览失败 | Print preview failed: {FileName}", Path.GetFileName(filePath));
+                throw new PrintException($"打印预览失败 | Print preview failed: {Path.GetFileName(filePath)}", ex);
+            }
+            finally
+            {
+                // 4. 释放资源 | Release resources
+                DisposePdfViewer(pdfViewer);
+            }
+        }
+
+        #region 私有辅助方法 | Private Helper Methods
+
+        /// <summary>
+        /// 验证文件路径是否存在 | Validate file path exists
+        /// </summary>
+        private void ValidateFilePath(string filePath)
+        {
+            if (string.IsNullOrWhiteSpace(filePath))
+            {
+                throw new ArgumentNullException(nameof(filePath), "文件路径不能为空 | File path cannot be null or empty");
+            }
+
+            if (!File.Exists(filePath))
+            {
+                _logger.Error(new FileNotFoundException(filePath), "文件不存在 | File not found: {FilePath}", filePath);
+                throw new FileNotFoundException($"文件不存在 | File not found: {filePath}", filePath);
+            }
+        }
+
+        /// <summary>
+        /// 验证打印机名称是否有效 | Validate printer name is valid
+        /// </summary>
+        private void ValidatePrinterName(string printerName)
+        {
+            if (string.IsNullOrWhiteSpace(printerName))
+            {
+                throw new ArgumentNullException(nameof(printerName), "打印机名称不能为空 | Printer name cannot be null or empty");
+            }
+
+            // 通过 PrinterSettings.InstalledPrinters 查询系统已安装的打印机 | Query installed printers
+            bool found = false;
+            foreach (string installedPrinter in PrinterSettings.InstalledPrinters)
+            {
+                if (string.Equals(installedPrinter, printerName, StringComparison.OrdinalIgnoreCase))
+                {
+                    found = true;
+                    break;
+                }
+            }
+
+            if (!found)
+            {
+                _logger.Error(new PrinterNotFoundException(printerName),
+                    "打印机未找到 | Printer not found: {PrinterName}", printerName);
+                throw new PrinterNotFoundException(printerName);
+            }
+        }
+
+        /// <summary>
+        /// 创建隐藏的 RadPdfViewer 并加载 PDF 文档 | Create hidden RadPdfViewer and load PDF document
+        /// </summary>
+        private RadPdfViewer CreatePdfViewerWithDocument(string filePath)
+        {
+            var pdfViewer = new RadPdfViewer();
+
+            try
+            {
+                var provider = new PdfFormatProvider();
+                using var fileStream = File.OpenRead(filePath);
+                pdfViewer.Document = provider.Import(fileStream);
+                return pdfViewer;
+            }
+            catch (Exception ex) when (ex is not FileNotFoundException)
+            {
+                // 释放已创建的 viewer | Dispose created viewer
+                DisposePdfViewer(pdfViewer);
+                _logger.Error(ex, "PDF 文件加载失败 | PDF file load failed: {FilePath}", filePath);
+                throw new PdfLoadException("PDF 文件加载失败 | PDF file load failed", filePath, ex);
+            }
+        }
+
+        /// <summary>
+        /// 释放 RadPdfViewer 资源 | Dispose RadPdfViewer resources
+        /// </summary>
+        private static void DisposePdfViewer(RadPdfViewer? pdfViewer)
+        {
+            if (pdfViewer != null)
+            {
+                pdfViewer.Document = null;
+            }
+        }
+
+        /// <summary>
+        /// 格式化页面范围字符串 | Format page range string
+        /// </summary>
+        private static string FormatPageRange(int? pageFrom, int? pageTo)
+        {
+            if (!pageFrom.HasValue && !pageTo.HasValue)
+            {
+                return "全部 | All";
+            }
+
+            var from = pageFrom?.ToString() ?? "1";
+            var to = pageTo?.ToString() ?? "末页 | Last";
+            return $"{from}-{to}";
+        }
+
+        #endregion
+    }
+}

XP.Common/PdfViewer/Implementations/PdfViewerService.cs

@@ -0,0 +1,167 @@
+using System;
+using System.IO;
+using XP.Common.Localization;
+using XP.Common.Logging.Interfaces;
+using XP.Common.PdfViewer.Exceptions;
+using XP.Common.PdfViewer.Interfaces;
+using XP.Common.PdfViewer.ViewModels;
+using XP.Common.PdfViewer.Views;
+
+namespace XP.Common.PdfViewer.Implementations
+{
+    /// <summary>
+    /// PDF 查看服务实现 | PDF viewer service implementation
+    /// 基于 Telerik RadPdfViewer 实现 | Based on Telerik RadPdfViewer
+    /// </summary>
+    public class PdfViewerService : IPdfViewerService
+    {
+        private readonly ILoggerService _logger;
+        private readonly IPdfPrintService _printService;
+        private bool _disposed;
+
+        public PdfViewerService(ILoggerService logger, IPdfPrintService printService)
+        {
+            _logger = logger?.ForModule<PdfViewerService>()
+                ?? throw new ArgumentNullException(nameof(logger));
+            _printService = printService
+                ?? throw new ArgumentNullException(nameof(printService));
+        }
+
+        /// <summary>
+        /// 通过文件路径打开 PDF 阅读器窗口 | Open PDF viewer window by file path
+        /// </summary>
+        /// <param name="filePath">PDF 文件路径 | PDF file path</param>
+        /// <exception cref="FileNotFoundException">文件不存在 | File not found</exception>
+        /// <exception cref="PdfLoadException">PDF 格式无效 | Invalid PDF format</exception>
+        public void OpenViewer(string filePath)
+        {
+            ObjectDisposedException.ThrowIf(_disposed, this);
+
+            // 1. 验证文件路径存在 | Validate file path exists
+            if (string.IsNullOrWhiteSpace(filePath))
+            {
+                throw new ArgumentNullException(nameof(filePath),
+                    "文件路径不能为空 | File path cannot be null or empty");
+            }
+
+            if (!File.Exists(filePath))
+            {
+                _logger.Error(new FileNotFoundException(filePath),
+                    "文件不存在 | File not found: {FilePath}", filePath);
+                throw new FileNotFoundException(
+                    $"文件不存在 | File not found: {filePath}", filePath);
+            }
+
+            try
+            {
+                // 2. 创建 PdfViewerWindowViewModel | Create PdfViewerWindowViewModel
+                var viewModel = new PdfViewerWindowViewModel(filePath, _printService, _logger);
+
+                // 3. 创建 PdfViewerWindow 并设置 DataContext | Create PdfViewerWindow and set DataContext
+                var window = new PdfViewerWindow
+                {
+                    DataContext = viewModel
+                };
+
+                // 4. 记录 Info 日志 | Log info
+                _logger.Info("打开 PDF 阅读器窗口 | Opening PDF viewer window: {FileName}",
+                    Path.GetFileName(filePath));
+
+                // 5. 显示窗口（非模态）| Show window (non-modal)
+                window.Show();
+            }
+            catch (Exception ex) when (ex is not FileNotFoundException
+                                    and not ArgumentNullException
+                                    and not PdfLoadException)
+            {
+                _logger.Error(ex, "PDF 文件加载失败 | PDF file load failed: {FilePath}", filePath);
+                throw new PdfLoadException(
+                    "PDF 文件加载失败 | PDF file load failed", filePath, ex);
+            }
+        }
+
+        /// <summary>
+        /// 通过文件流打开 PDF 阅读器窗口 | Open PDF viewer window by stream
+        /// </summary>
+        /// <param name="stream">PDF 文件流 | PDF file stream</param>
+        /// <param name="title">窗口标题（可选）| Window title (optional)</param>
+        /// <exception cref="ArgumentNullException">流为 null | Stream is null</exception>
+        /// <exception cref="PdfLoadException">PDF 格式无效 | Invalid PDF format</exception>
+        public void OpenViewer(Stream stream, string? title = null)
+        {
+            ObjectDisposedException.ThrowIf(_disposed, this);
+
+            // 1. 验证 stream 非 null | Validate stream is not null
+            ArgumentNullException.ThrowIfNull(stream, nameof(stream));
+
+            try
+            {
+                // 2. 创建 ViewModel | Create ViewModel
+                var viewModel = new PdfViewerWindowViewModel(stream, title, _printService, _logger);
+
+                // 3. 创建 PdfViewerWindow 并设置 DataContext | Create PdfViewerWindow and set DataContext
+                var window = new PdfViewerWindow
+                {
+                    DataContext = viewModel
+                };
+
+                // 4. 记录 Info 日志 | Log info
+                var displayTitle = title ?? LocalizationHelper.Get("PdfViewer_Title");
+                _logger.Info("打开 PDF 阅读器窗口（流模式）| Opening PDF viewer window (stream mode): {Title}",
+                    displayTitle);
+
+                // 5. 显示窗口（非模态）| Show window (non-modal)
+                window.Show();
+            }
+            catch (Exception ex) when (ex is not ArgumentNullException
+                                    and not PdfLoadException)
+            {
+                _logger.Error(ex, "PDF 文件加载失败（流模式）| PDF file load failed (stream mode)");
+                throw new PdfLoadException(
+                    "PDF 文件加载失败 | PDF file load failed", null, ex);
+            }
+        }
+
+        #region IDisposable 模式 | IDisposable Pattern
+
+        /// <summary>
+        /// 释放资源 | Dispose resources
+        /// </summary>
+        public void Dispose()
+        {
+            Dispose(disposing: true);
+            GC.SuppressFinalize(this);
+        }
+
+        /// <summary>
+        /// 释放资源的核心方法 | Core dispose method
+        /// </summary>
+        /// <param name="disposing">是否由 Dispose() 调用 | Whether called by Dispose()</param>
+        protected virtual void Dispose(bool disposing)
+        {
+            if (_disposed)
+            {
+                return;
+            }
+
+            if (disposing)
+            {
+                // 释放托管资源 | Dispose managed resources
+                _logger.Info("PdfViewerService 已释放 | PdfViewerService disposed");
+            }
+
+            _disposed = true;
+        }
+
+        /// <summary>
+        /// 终结器安全网 | Finalizer safety net
+        /// 确保未显式释放时仍能清理非托管资源 | Ensures unmanaged resources are cleaned up if not explicitly disposed
+        /// </summary>
+        ~PdfViewerService()
+        {
+            Dispose(disposing: false);
+        }
+
+        #endregion
+    }
+}

XP.Common/PdfViewer/Interfaces/IPdfPrintService.cs

@@ -0,0 +1,40 @@
+using System;
+using System.IO;
+using XP.Common.PdfViewer.Exceptions;
+
+namespace XP.Common.PdfViewer.Interfaces
+{
+    /// <summary>
+    /// PDF 打印服务接口 | PDF print service interface
+    /// 提供 PDF 文件打印功能 | Provides PDF file printing functionality
+    /// </summary>
+    public interface IPdfPrintService
+    {
+        /// <summary>
+        /// 使用指定打印机打印 PDF 文件 | Print PDF file with specified printer
+        /// </summary>
+        /// <param name="filePath">PDF 文件路径 | PDF file path</param>
+        /// <param name="printerName">打印机名称 | Printer name</param>
+        /// <param name="pageFrom">起始页码（从 1 开始，null 表示从第一页）| Start page (1-based, null for first page)</param>
+        /// <param name="pageTo">结束页码（从 1 开始，null 表示到最后一页）| End page (1-based, null for last page)</param>
+        /// <param name="copies">打印份数（默认 1）| Number of copies (default 1)</param>
+        /// <exception cref="FileNotFoundException">文件不存在 | File not found</exception>
+        /// <exception cref="PdfLoadException">PDF 格式无效 | Invalid PDF format</exception>
+        /// <exception cref="PrinterNotFoundException">打印机不存在 | Printer not found</exception>
+        /// <exception cref="PrintException">打印失败 | Print failed</exception>
+        void Print(string filePath, string printerName, int? pageFrom = null, int? pageTo = null, int copies = 1);
+
+        /// <summary>
+        /// 打开打印设置对话框并打印 | Open print settings dialog and print
+        /// </summary>
+        /// <param name="filePath">PDF 文件路径 | PDF file path</param>
+        /// <returns>用户是否确认打印 | Whether user confirmed printing</returns>
+        bool PrintWithDialog(string filePath);
+
+        /// <summary>
+        /// 打开打印预览对话框 | Open print preview dialog
+        /// </summary>
+        /// <param name="filePath">PDF 文件路径 | PDF file path</param>
+        void PrintPreview(string filePath);
+    }
+}

XP.Common/PdfViewer/Interfaces/IPdfViewerService.cs

@@ -0,0 +1,30 @@
+using System;
+using System.IO;
+using XP.Common.PdfViewer.Exceptions;
+
+namespace XP.Common.PdfViewer.Interfaces
+{
+    /// <summary>
+    /// PDF 查看服务接口 | PDF viewer service interface
+    /// 提供 PDF 文件加载和阅读器窗口管理功能 | Provides PDF file loading and viewer window management
+    /// </summary>
+    public interface IPdfViewerService : IDisposable
+    {
+        /// <summary>
+        /// 通过文件路径打开 PDF 阅读器窗口 | Open PDF viewer window by file path
+        /// </summary>
+        /// <param name="filePath">PDF 文件路径 | PDF file path</param>
+        /// <exception cref="FileNotFoundException">文件不存在 | File not found</exception>
+        /// <exception cref="PdfLoadException">PDF 格式无效 | Invalid PDF format</exception>
+        void OpenViewer(string filePath);
+
+        /// <summary>
+        /// 通过文件流打开 PDF 阅读器窗口 | Open PDF viewer window by stream
+        /// </summary>
+        /// <param name="stream">PDF 文件流 | PDF file stream</param>
+        /// <param name="title">窗口标题（可选）| Window title (optional)</param>
+        /// <exception cref="ArgumentNullException">流为 null | Stream is null</exception>
+        /// <exception cref="PdfLoadException">PDF 格式无效 | Invalid PDF format</exception>
+        void OpenViewer(Stream stream, string? title = null);
+    }
+}

XP.Common/PdfViewer/ViewModels/PdfViewerWindowViewModel.cs

@@ -0,0 +1,138 @@
+using System;
+using System.IO;
+using Prism.Commands;
+using Prism.Mvvm;
+using XP.Common.Localization;
+using XP.Common.Logging.Interfaces;
+using XP.Common.PdfViewer.Interfaces;
+
+namespace XP.Common.PdfViewer.ViewModels
+{
+    /// <summary>
+    /// PDF 阅读器窗口 ViewModel | PDF viewer window ViewModel
+    /// 轻量级 ViewModel，核心功能由 RadPdfViewer 控件内置处理 | Lightweight ViewModel, core features handled by RadPdfViewer
+    /// </summary>
+    public class PdfViewerWindowViewModel : BindableBase
+    {
+        private readonly IPdfPrintService _printService;
+        private readonly ILoggerService _logger;
+
+        /// <summary>
+        /// 窗口标题（含文件名）| Window title (with file name)
+        /// </summary>
+        public string Title { get; }
+
+        /// <summary>
+        /// PDF 文件路径（用于打印）| PDF file path (for printing)
+        /// </summary>
+        public string? FilePath { get; }
+
+        /// <summary>
+        /// PDF 文件流（用于流加载场景）| PDF file stream (for stream loading scenario)
+        /// </summary>
+        public Stream? PdfStream { get; }
+
+        /// <summary>
+        /// 打印命令（打开打印设置对话框）| Print command (open print settings dialog)
+        /// </summary>
+        public DelegateCommand PrintCommand { get; }
+
+        /// <summary>
+        /// 打印预览命令 | Print preview command
+        /// </summary>
+        public DelegateCommand PrintPreviewCommand { get; }
+
+        /// <summary>
+        /// 通过文件路径创建 ViewModel | Create ViewModel by file path
+        /// </summary>
+        /// <param name="filePath">PDF 文件路径 | PDF file path</param>
+        /// <param name="printService">打印服务 | Print service</param>
+        /// <param name="logger">日志服务 | Logger service</param>
+        public PdfViewerWindowViewModel(
+            string filePath,
+            IPdfPrintService printService,
+            ILoggerService logger)
+        {
+            _printService = printService ?? throw new ArgumentNullException(nameof(printService));
+            _logger = logger ?? throw new ArgumentNullException(nameof(logger));
+
+            FilePath = filePath ?? throw new ArgumentNullException(nameof(filePath));
+            PdfStream = null;
+
+            // 使用多语言标题，包含文件名 | Use localized title with file name
+            var fileName = Path.GetFileName(filePath);
+            Title = LocalizationHelper.Get("PdfViewer_TitleWithFile", fileName);
+
+            // 初始化命令 | Initialize commands
+            PrintCommand = new DelegateCommand(ExecutePrint, CanExecutePrint);
+            PrintPreviewCommand = new DelegateCommand(ExecutePrintPreview, CanExecutePrint);
+        }
+
+        /// <summary>
+        /// 通过文件流创建 ViewModel | Create ViewModel by stream
+        /// </summary>
+        /// <param name="stream">PDF 文件流 | PDF file stream</param>
+        /// <param name="title">窗口标题（可选）| Window title (optional)</param>
+        /// <param name="printService">打印服务 | Print service</param>
+        /// <param name="logger">日志服务 | Logger service</param>
+        public PdfViewerWindowViewModel(
+            Stream stream,
+            string? title,
+            IPdfPrintService printService,
+            ILoggerService logger)
+        {
+            _printService = printService ?? throw new ArgumentNullException(nameof(printService));
+            _logger = logger ?? throw new ArgumentNullException(nameof(logger));
+
+            PdfStream = stream ?? throw new ArgumentNullException(nameof(stream));
+            FilePath = null;
+
+            // 使用自定义标题或默认多语言标题 | Use custom title or default localized title
+            Title = !string.IsNullOrWhiteSpace(title)
+                ? title
+                : LocalizationHelper.Get("PdfViewer_Title");
+
+            // 初始化命令（流模式下无文件路径，命令不可用）| Initialize commands (no file path in stream mode, commands disabled)
+            PrintCommand = new DelegateCommand(ExecutePrint, CanExecutePrint);
+            PrintPreviewCommand = new DelegateCommand(ExecutePrintPreview, CanExecutePrint);
+        }
+
+        /// <summary>
+        /// 执行打印（打开打印设置对话框）| Execute print (open print settings dialog)
+        /// </summary>
+        private void ExecutePrint()
+        {
+            try
+            {
+                _printService.PrintWithDialog(FilePath!);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "打印失败 | Print failed: {FilePath}", FilePath ?? string.Empty);
+            }
+        }
+
+        /// <summary>
+        /// 执行打印预览 | Execute print preview
+        /// </summary>
+        private void ExecutePrintPreview()
+        {
+            try
+            {
+                _printService.PrintPreview(FilePath!);
+            }
+            catch (Exception ex)
+            {
+                _logger.Error(ex, "打印预览失败 | Print preview failed: {FilePath}", FilePath ?? string.Empty);
+            }
+        }
+
+        /// <summary>
+        /// 判断打印命令是否可用（仅当 FilePath 有效时）| Check if print command is available (only when FilePath is valid)
+        /// </summary>
+        private bool CanExecutePrint()
+        {
+            return !string.IsNullOrEmpty(FilePath);
+        }
+    }
+}

XP.Common/PdfViewer/Views/PdfViewerWindow.xaml

@@ -0,0 +1,75 @@
+<Window x:Class="XP.Common.PdfViewer.Views.PdfViewerWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation"
+        xmlns:converters="clr-namespace:Telerik.Windows.Documents.Converters;assembly=Telerik.Windows.Controls.FixedDocumentViewers"
+        Title="{Binding Title}"
+        Width="1024" Height="768"
+        MinWidth="800" MinHeight="600"
+        WindowStartupLocation="CenterScreen"
+        ShowInTaskbar="True"
+        WindowStyle="SingleBorderWindow">
+
+    <Window.Resources>
+        <!-- 缩略图转换器：将 RadFixedDocument 转换为缩略图集合 | Thumbnail converter: converts RadFixedDocument to thumbnails collection -->
+        <converters:ThumbnailsConverter x:Key="ThumbnailsConverter" ThumbnailsHeight="200"/>
+    </Window.Resources>
+
+    <Grid>
+        <Grid.RowDefinitions>
+            <!-- 工具栏（RadPdfViewerToolbar 内置导航/缩放/旋转/打印）| Toolbar (built-in navigation/zoom/rotate/print) -->
+            <RowDefinition Height="Auto"/>
+            <!-- PDF 显示区域 | PDF display area -->
+            <RowDefinition Height="*"/>
+        </Grid.RowDefinitions>
+
+        <!-- Telerik 内置工具栏 | Built-in toolbar -->
+        <telerik:RadPdfViewerToolBar Grid.Row="0"
+                                     telerik:StyleManager.Theme="Crystal"
+                                     RadPdfViewer="{Binding ElementName=pdfViewer, Mode=OneTime}"/>
+
+        <!-- 主内容区域：左侧缩略图面板 + 右侧 PDF 显示 | Main content: left thumbnails + right PDF display -->
+        <Grid Grid.Row="1">
+            <Grid.ColumnDefinitions>
+                <!-- 左侧缩略图面板 | Left thumbnails panel -->
+                <ColumnDefinition Width="180"/>
+                <!-- PDF 显示区域 | PDF display area -->
+                <ColumnDefinition Width="*"/>
+            </Grid.ColumnDefinitions>
+
+            <!-- 页面缩略图面板 | Page thumbnails panel -->
+            <Border Grid.Column="0" BorderBrush="#DDDDDD" BorderThickness="0,0,1,0" Background="#F5F5F5">
+                <ListBox x:Name="thumbnailListBox"
+                         ItemsSource="{Binding ElementName=pdfViewer, Path=Document, Converter={StaticResource ThumbnailsConverter}}"
+                         SelectionChanged="ThumbnailListBox_SelectionChanged"
+                         ScrollViewer.HorizontalScrollBarVisibility="Disabled"
+                         Background="Transparent"
+                         BorderThickness="0"
+                         Padding="4">
+                    <ListBox.ItemTemplate>
+                        <DataTemplate>
+                            <StackPanel Margin="2,4" HorizontalAlignment="Center">
+                                <!-- 缩略图图片 | Thumbnail image -->
+                                <Border BorderBrush="#CCCCCC" BorderThickness="1" Background="White"
+                                        HorizontalAlignment="Center">
+                                    <Image Source="{Binding ImageSource}" Stretch="Uniform"
+                                           MaxWidth="150" MaxHeight="200"/>
+                                </Border>
+                                <!-- 页码 | Page number -->
+                                <TextBlock Text="{Binding PageNumber}" 
+                                           HorizontalAlignment="Center" Margin="0,2,0,0"
+                                           FontSize="11" Foreground="#666666"/>
+                            </StackPanel>
+                        </DataTemplate>
+                    </ListBox.ItemTemplate>
+                </ListBox>
+            </Border>
+
+            <!-- PDF 渲染区域 | PDF rendering area -->
+            <telerik:RadPdfViewer Grid.Column="1"
+                                  x:Name="pdfViewer"
+                                  telerik:StyleManager.Theme="Crystal"
+                                  DataContext="{Binding ElementName=pdfViewer, Path=CommandDescriptors}"/>
+        </Grid>
+    </Grid>
+</Window>

XP.Common/PdfViewer/Views/PdfViewerWindow.xaml.cs

@@ -0,0 +1,132 @@
+using System;
+using System.IO;
+using System.Windows;
+using System.Windows.Controls;
+using Telerik.Windows.Documents.Fixed.FormatProviders.Pdf;
+using XP.Common.PdfViewer.Exceptions;
+using XP.Common.PdfViewer.ViewModels;
+
+namespace XP.Common.PdfViewer.Views
+{
+    /// <summary>
+    /// PDF 阅读器窗口 code-behind | PDF viewer window code-behind
+    /// 负责在 Loaded 事件中加载 PDF 文档，在 Closed 事件中释放资源
+    /// Responsible for loading PDF document on Loaded event and releasing resources on Closed event
+    /// </summary>
+    public partial class PdfViewerWindow : Window
+    {
+        // 防止缩略图选择和页面跳转之间的循环触发 | Prevent circular trigger between thumbnail selection and page navigation
+        private bool _isSyncingSelection;
+
+        public PdfViewerWindow()
+        {
+            InitializeComponent();
+            Loaded += OnLoaded;
+            Closed += OnClosed;
+        }
+
+        /// <summary>
+        /// 窗口加载事件：通过 PdfFormatProvider 加载 PDF 文档到 RadPdfViewer
+        /// Window loaded event: load PDF document into RadPdfViewer via PdfFormatProvider
+        /// </summary>
+        private void OnLoaded(object sender, RoutedEventArgs e)
+        {
+            var vm = DataContext as PdfViewerWindowViewModel;
+            if (vm == null) return;
+
+            try
+            {
+                var provider = new PdfFormatProvider();
+
+                if (vm.PdfStream != null)
+                {
+                    // 从文件流加载 PDF | Load PDF from stream
+                    pdfViewer.Document = provider.Import(vm.PdfStream);
+                }
+                else if (!string.IsNullOrEmpty(vm.FilePath))
+                {
+                    // 从文件路径加载 PDF | Load PDF from file path
+                    using var stream = File.OpenRead(vm.FilePath);
+                    pdfViewer.Document = provider.Import(stream);
+                }
+
+                // 文档加载后，监听页面变化以同步缩略图选中状态 | After document loaded, listen for page changes to sync thumbnail selection
+                pdfViewer.CurrentPageChanged += PdfViewer_CurrentPageChanged;
+
+                // 初始选中第一页缩略图 | Initially select first page thumbnail
+                if (thumbnailListBox.Items.Count > 0)
+                {
+                    thumbnailListBox.SelectedIndex = 0;
+                }
+            }
+            catch (Exception ex) when (ex is not PdfLoadException)
+            {
+                // 捕获加载异常并包装为 PdfLoadException | Catch loading exceptions and wrap as PdfLoadException
+                throw new PdfLoadException(
+                    "PDF 文件加载失败 | PDF file load failed",
+                    vm.FilePath,
+                    ex);
+            }
+        }
+
+        /// <summary>
+        /// 缩略图列表选择变化：跳转到对应页面 | Thumbnail selection changed: navigate to corresponding page
+        /// ListBox.SelectedIndex 从 0 开始，RadPdfViewer.CurrentPageNumber 从 1 开始
+        /// ListBox.SelectedIndex is 0-based, RadPdfViewer.CurrentPageNumber is 1-based
+        /// </summary>
+        private void ThumbnailListBox_SelectionChanged(object sender, SelectionChangedEventArgs e)
+        {
+            if (_isSyncingSelection) return;
+            if (thumbnailListBox.SelectedIndex < 0) return;
+
+            _isSyncingSelection = true;
+            try
+            {
+                // SelectedIndex(0-based) + 1 = CurrentPageNumber(1-based)
+                pdfViewer.CurrentPageNumber = thumbnailListBox.SelectedIndex + 1;
+            }
+            finally
+            {
+                _isSyncingSelection = false;
+            }
+        }
+
+        /// <summary>
+        /// PDF 阅读器页面变化：同步缩略图选中状态 | PDF viewer page changed: sync thumbnail selection
+        /// </summary>
+        private void PdfViewer_CurrentPageChanged(object? sender, EventArgs e)
+        {
+            if (_isSyncingSelection) return;
+
+            _isSyncingSelection = true;
+            try
+            {
+                // CurrentPageNumber(1-based) - 1 = SelectedIndex(0-based)
+                var index = pdfViewer.CurrentPageNumber - 1;
+                if (index >= 0 && index < thumbnailListBox.Items.Count)
+                {
+                    thumbnailListBox.SelectedIndex = index;
+                    thumbnailListBox.ScrollIntoView(thumbnailListBox.SelectedItem);
+                }
+            }
+            finally
+            {
+                _isSyncingSelection = false;
+            }
+        }
+
+        /// <summary>
+        /// 窗口关闭事件：释放 RadPdfViewer 文档资源
+        /// Window closed event: release RadPdfViewer document resources
+        /// </summary>
+        private void OnClosed(object? sender, EventArgs e)
+        {
+            // 取消事件订阅 | Unsubscribe events
+            pdfViewer.CurrentPageChanged -= PdfViewer_CurrentPageChanged;
+
+            // RadPdfViewer 内部管理文档资源，设置 Document = null 触发释放
+            // RadPdfViewer internally manages document resources, setting Document = null triggers release
+            pdfViewer.Document = null;
+        }
+    }
+}

XP.Common/Properties/Licenses.licx

@@ -0,0 +1 @@
+Telerik.Windows.Controls.RadProgressBar, Telerik.Windows.Controls, Version=2024.1.408.310, Culture=neutral, PublicKeyToken=5803cfa389c90ce7

XP.Common/Resources/Resources.en-US.resx

@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!-- 
+    Microsoft ResX Schema 
+    
+    Version 2.0
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
+    associated with the data types.
+    
+    Example:
+    
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+                
+    There are any number of "resheader" rows that contain simple 
+    name/value pairs.
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
+    mimetype set.
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
+    extensible. For a given mimetype the value must be set accordingly:
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
+    read any of the formats listed below.
+    
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+    
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array 
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <data name="App_Title" xml:space="preserve">
+    <value>XplorePlane X-Ray Inspection System</value>
+  </data>
+  <data name="Menu_File" xml:space="preserve">
+    <value>File</value>
+  </data>
+  <data name="Menu_Settings" xml:space="preserve">
+    <value>Settings</value>
+  </data>
+  <data name="Button_OK" xml:space="preserve">
+    <value>OK</value>
+  </data>
+  <data name="Button_Cancel" xml:space="preserve">
+    <value>Cancel</value>
+  </data>
+  <data name="Language_ZhCN" xml:space="preserve">
+    <value>Simplified Chinese</value>
+  </data>
+  <data name="Language_ZhTW" xml:space="preserve">
+    <value>Traditional Chinese</value>
+  </data>
+  <data name="Language_EnUS" xml:space="preserve">
+    <value>English</value>
+  </data>
+  <data name="Settings_Language" xml:space="preserve">
+    <value>Language Settings</value>
+  </data>
+  <data name="Settings_Language_Description" xml:space="preserve">
+    <value>Select your preferred display language</value>
+  </data>
+  <data name="Settings_Language_RestartNotice" xml:space="preserve">
+    <value>Language changes will take effect on the next application startup.</value>
+  </data>
+  <data name="Button_Apply" xml:space="preserve">
+    <value>Apply</value>
+  </data>
+  <data name="Button_Close" xml:space="preserve">
+    <value>Close</value>
+  </data>
+  <data name="Button_Save" xml:space="preserve">
+    <value>Save</value>
+  </data>
+  <data name="Button_Delete" xml:space="preserve">
+    <value>Delete</value>
+  </data>
+  <data name="Button_Edit" xml:space="preserve">
+    <value>Edit</value>
+  </data>
+  <data name="Button_Add" xml:space="preserve">
+    <value>Add</value>
+  </data>
+  <data name="Button_Refresh" xml:space="preserve">
+    <value>Refresh</value>
+  </data>
+  <data name="Button_Search" xml:space="preserve">
+    <value>Search</value>
+  </data>
+  <data name="Button_Reset" xml:space="preserve">
+    <value>Reset</value>
+  </data>
+  <data name="Status_Ready" xml:space="preserve">
+    <value>Ready</value>
+  </data>
+  <data name="Status_Loading" xml:space="preserve">
+    <value>Loading...</value>
+  </data>
+  <data name="Status_Saving" xml:space="preserve">
+    <value>Saving...</value>
+  </data>
+  <data name="Status_Processing" xml:space="preserve">
+    <value>Processing...</value>
+  </data>
+  <data name="Status_Success" xml:space="preserve">
+    <value>Success</value>
+  </data>
+  <data name="Status_Failed" xml:space="preserve">
+    <value>Failed</value>
+  </data>
+  <data name="Status_Error" xml:space="preserve">
+    <value>Error</value>
+  </data>
+  <data name="Status_Warning" xml:space="preserve">
+    <value>Warning</value>
+  </data>
+  <data name="Status_Connected" xml:space="preserve">
+    <value>Connected</value>
+  </data>
+  <data name="Status_Disconnected" xml:space="preserve">
+    <value>Disconnected</value>
+  </data>
+  <data name="Welcome_Message" xml:space="preserve">
+    <value>Welcome to XplorePlane X-Ray Inspection System</value>
+  </data>
+  <data name="Message_OperationSuccess" xml:space="preserve">
+    <value>Operation completed successfully</value>
+  </data>
+  <data name="Message_OperationFailed" xml:space="preserve">
+    <value>Operation failed</value>
+  </data>
+  <data name="Message_ConfirmDelete" xml:space="preserve">
+    <value>Are you sure you want to delete?</value>
+  </data>
+  <data name="Message_UnsavedChanges" xml:space="preserve">
+    <value>There are unsaved changes. Do you want to save?</value>
+  </data>
+  <data name="Message_InvalidInput" xml:space="preserve">
+    <value>Invalid input. Please check and try again</value>
+  </data>
+  <data name="Message_ConnectionLost" xml:space="preserve">
+    <value>Connection lost</value>
+  </data>
+  <data name="Message_RestartRequired" xml:space="preserve">
+    <value>Language setting saved. Please restart the application to apply the new language.</value>
+  </data>
+  <data name="Menu_View" xml:space="preserve">
+    <value>View</value>
+  </data>
+  <data name="Menu_Tools" xml:space="preserve">
+    <value>Tools</value>
+  </data>
+  <data name="Menu_Help" xml:space="preserve">
+    <value>Help</value>
+  </data>
+  <data name="Menu_Exit" xml:space="preserve">
+    <value>Exit</value>
+  </data>
+  <data name="Menu_About" xml:space="preserve">
+    <value>About</value>
+  </data>
+  <data name="Dialog_Confirmation" xml:space="preserve">
+    <value>Confirmation</value>
+  </data>
+  <data name="Dialog_Information" xml:space="preserve">
+    <value>Information</value>
+  </data>
+  <data name="Dialog_Warning" xml:space="preserve">
+    <value>Warning</value>
+  </data>
+  <data name="Dialog_Error" xml:space="preserve">
+    <value>Error</value>
+  </data>
+  <data name="Dialog_Notice" xml:space="preserve">
+    <value>Notice</value>
+  </data>
+  <data name="Settings_Language_SavedRestartRequired" xml:space="preserve">
+    <value>Language setting saved. Please restart the application to apply the new language.</value>
+  </data>
+  <data name="Settings_Language_SwitchFailed" xml:space="preserve">
+    <value>Failed to switch language: {0}</value>
+  </data>
+  <data name="Scan_Text_ScanMode" xml:space="preserve">
+    <value>Scan Mode:</value>
+    <comment>Scan - Scan mode label</comment>
+  </data>
+  <data name="Scan_Text_FrameMerge" xml:space="preserve">
+    <value>Frame Merge:</value>
+    <comment>Scan - Frame merge label</comment>
+  </data>
+  <data name="Scan_Text_Nums" xml:space="preserve">
+    <value>Acquisition Count:</value>
+    <comment>Scan - Acquisition count label</comment>
+  </data>
+  <data name="Scan_Text_Angles" xml:space="preserve">
+    <value>Rotation Angle:</value>
+    <comment>Scan - Rotation angle label</comment>
+  </data>
+  <data name="Scan_Text_Progress" xml:space="preserve">
+    <value>Progress:</value>
+    <comment>Scan - Acquisition progress label</comment>
+  </data>
+  <data name="Scan_Button_Start" xml:space="preserve">
+    <value>Start</value>
+    <comment>Scan - Start acquisition button</comment>
+  </data>
+  <data name="Scan_Button_Stop" xml:space="preserve">
+    <value>Stop</value>
+    <comment>Scan - Stop acquisition button</comment>
+  </data>
+  <data name="LogViewer_StatusTotal" xml:space="preserve">
+    <value>Total {0} logs</value>
+    <comment>LogViewer - Status bar total count</comment>
+  </data>
+  <data name="LogViewer_StatusFiltered" xml:space="preserve">
+    <value>Total {0} logs, {1} after filtering</value>
+    <comment>LogViewer - Status bar filtered count</comment>
+  </data>
+  <data name="LogViewer_Title" xml:space="preserve">
+    <value>Real-Time Log Viewer</value>
+    <comment>LogViewer - Window title</comment>
+  </data>
+  <data name="LogViewer_AutoScroll" xml:space="preserve">
+    <value>Auto Scroll</value>
+    <comment>LogViewer - Auto-scroll button</comment>
+  </data>
+  <data name="LogViewer_ClearLog" xml:space="preserve">
+    <value>Clear Log</value>
+    <comment>LogViewer - Clear log button</comment>
+  </data>
+  <data name="LogViewer_Filter" xml:space="preserve">
+    <value>Filter:</value>
+    <comment>LogViewer - Filter label</comment>
+  </data>
+  <data name="LogViewer_FilterWatermark" xml:space="preserve">
+    <value>Enter keyword to filter logs...</value>
+    <comment>LogViewer - Filter watermark</comment>
+  </data>
+  <data name="LogViewer_LevelFilter" xml:space="preserve">
+    <value>Level Filter:</value>
+    <comment>LogViewer - Level filter label</comment>
+  </data>
+  <data name="LogViewer_ColTime" xml:space="preserve">
+    <value>Time</value>
+    <comment>LogViewer - Time column header</comment>
+  </data>
+  <data name="LogViewer_ColLevel" xml:space="preserve">
+    <value>Level</value>
+    <comment>LogViewer - Level column header</comment>
+  </data>
+  <data name="LogViewer_ColSource" xml:space="preserve">
+    <value>Source</value>
+    <comment>LogViewer - Source column header</comment>
+  </data>
+  <data name="LogViewer_ColMessage" xml:space="preserve">
+    <value>Message</value>
+    <comment>LogViewer - Message column header</comment>
+  </data>
+  <data name="LogViewer_MaxLines" xml:space="preserve">
+    <value>Max Lines:</value>
+    <comment>LogViewer - Max lines label</comment>
+  </data>
+  <data name="PdfViewer_Title" xml:space="preserve">
+    <value>PDF Viewer</value>
+    <comment>PdfViewer - Window title</comment>
+  </data>
+  <data name="PdfViewer_TitleWithFile" xml:space="preserve">
+    <value>PDF Viewer - {0}</value>
+    <comment>PdfViewer - Window title with file name</comment>
+  </data>
+  <data name="PdfViewer_LoadSuccess" xml:space="preserve">
+    <value>PDF loaded: {0} ({1} pages)</value>
+    <comment>PdfViewer - Load success log</comment>
+  </data>
+  <data name="PdfViewer_LoadFailed" xml:space="preserve">
+    <value>PDF file load failed</value>
+    <comment>PdfViewer - Load failed log</comment>
+  </data>
+  <data name="PdfViewer_PrintSuccess" xml:space="preserve">
+    <value>Print job submitted: {0} → {1}</value>
+    <comment>PdfViewer - Print success log</comment>
+  </data>
+  <data name="PdfViewer_PrintFailed" xml:space="preserve">
+    <value>Print failed</value>
+    <comment>PdfViewer - Print failed log</comment>
+  </data>
+  <data name="PdfViewer_PrinterNotFound" xml:space="preserve">
+    <value>Printer not found: {0}</value>
+    <comment>PdfViewer - Printer not found</comment>
+  </data>
+</root>

XP.Common/Resources/Resources.resx

@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!-- 
+    Microsoft ResX Schema 
+    
+    Version 2.0
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
+    associated with the data types.
+    
+    Example:
+    
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+                
+    There are any number of "resheader" rows that contain simple 
+    name/value pairs.
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
+    mimetype set.
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
+    extensible. For a given mimetype the value must be set accordingly:
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
+    read any of the formats listed below.
+    
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+    
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array 
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <data name="App_Title" xml:space="preserve">
+    <value>XplorePlane X射线检测系统</value>
+  </data>
+  <data name="Menu_File" xml:space="preserve">
+    <value>文件</value>
+  </data>
+  <data name="Menu_Settings" xml:space="preserve">
+    <value>设置</value>
+  </data>
+  <data name="Button_OK" xml:space="preserve">
+    <value>确定</value>
+  </data>
+  <data name="Button_Cancel" xml:space="preserve">
+    <value>取消</value>
+  </data>
+  <data name="Language_ZhCN" xml:space="preserve">
+    <value>简体中文</value>
+  </data>
+  <data name="Language_ZhTW" xml:space="preserve">
+    <value>繁體中文</value>
+  </data>
+  <data name="Language_EnUS" xml:space="preserve">
+    <value>English</value>
+  </data>
+  <data name="Settings_Language" xml:space="preserve">
+    <value>语言设置</value>
+  </data>
+  <data name="Settings_Language_Description" xml:space="preserve">
+    <value>选择您偏好的显示语言</value>
+  </data>
+  <data name="Settings_Language_RestartNotice" xml:space="preserve">
+    <value>语言切换将在下次启动应用程序时生效。</value>
+  </data>
+  <data name="Button_Apply" xml:space="preserve">
+    <value>应用</value>
+  </data>
+  <data name="Button_Close" xml:space="preserve">
+    <value>关闭</value>
+  </data>
+  <data name="Button_Save" xml:space="preserve">
+    <value>保存</value>
+  </data>
+  <data name="Button_Delete" xml:space="preserve">
+    <value>删除</value>
+  </data>
+  <data name="Button_Edit" xml:space="preserve">
+    <value>编辑</value>
+  </data>
+  <data name="Button_Add" xml:space="preserve">
+    <value>添加</value>
+  </data>
+  <data name="Button_Refresh" xml:space="preserve">
+    <value>刷新</value>
+  </data>
+  <data name="Button_Search" xml:space="preserve">
+    <value>搜索</value>
+  </data>
+  <data name="Button_Reset" xml:space="preserve">
+    <value>重置</value>
+  </data>
+  <data name="Status_Ready" xml:space="preserve">
+    <value>就绪</value>
+  </data>
+  <data name="Status_Loading" xml:space="preserve">
+    <value>加载中...</value>
+  </data>
+  <data name="Status_Saving" xml:space="preserve">
+    <value>保存中...</value>
+  </data>
+  <data name="Status_Processing" xml:space="preserve">
+    <value>处理中...</value>
+  </data>
+  <data name="Status_Success" xml:space="preserve">
+    <value>成功</value>
+  </data>
+  <data name="Status_Failed" xml:space="preserve">
+    <value>失败</value>
+  </data>
+  <data name="Status_Error" xml:space="preserve">
+    <value>错误</value>
+  </data>
+  <data name="Status_Warning" xml:space="preserve">
+    <value>警告</value>
+  </data>
+  <data name="Status_Connected" xml:space="preserve">
+    <value>已连接</value>
+  </data>
+  <data name="Status_Disconnected" xml:space="preserve">
+    <value>已断开</value>
+  </data>
+  <data name="Welcome_Message" xml:space="preserve">
+    <value>欢迎使用 XplorePlane X射线检测系统</value>
+  </data>
+  <data name="Message_OperationSuccess" xml:space="preserve">
+    <value>操作成功完成</value>
+  </data>
+  <data name="Message_OperationFailed" xml:space="preserve">
+    <value>操作失败</value>
+  </data>
+  <data name="Message_ConfirmDelete" xml:space="preserve">
+    <value>确定要删除吗？</value>
+  </data>
+  <data name="Message_UnsavedChanges" xml:space="preserve">
+    <value>有未保存的更改，是否保存？</value>
+  </data>
+  <data name="Message_InvalidInput" xml:space="preserve">
+    <value>输入无效，请检查后重试</value>
+  </data>
+  <data name="Message_ConnectionLost" xml:space="preserve">
+    <value>连接已断开</value>
+  </data>
+  <data name="Message_RestartRequired" xml:space="preserve">
+    <value>语言设置已保存，请重启应用程序以应用新语言。</value>
+  </data>
+  <data name="Menu_View" xml:space="preserve">
+    <value>视图</value>
+  </data>
+  <data name="Menu_Tools" xml:space="preserve">
+    <value>工具</value>
+  </data>
+  <data name="Menu_Help" xml:space="preserve">
+    <value>帮助</value>
+  </data>
+  <data name="Menu_Exit" xml:space="preserve">
+    <value>退出</value>
+  </data>
+  <data name="Menu_About" xml:space="preserve">
+    <value>关于</value>
+  </data>
+  <data name="Dialog_Confirmation" xml:space="preserve">
+    <value>确认</value>
+  </data>
+  <data name="Dialog_Information" xml:space="preserve">
+    <value>信息</value>
+  </data>
+  <data name="Dialog_Warning" xml:space="preserve">
+    <value>警告</value>
+  </data>
+  <data name="Dialog_Error" xml:space="preserve">
+    <value>错误</value>
+  </data>
+  <data name="Dialog_Notice" xml:space="preserve">
+    <value>提示</value>
+  </data>
+  <data name="Settings_Language_SavedRestartRequired" xml:space="preserve">
+    <value>语言设置已保存，请重启应用程序以应用新语言。</value>
+  </data>
+  <data name="Settings_Language_SwitchFailed" xml:space="preserve">
+    <value>语言切换失败：{0}</value>
+  </data>
+  <data name="Scan_Text_ScanMode" xml:space="preserve">
+    <value>采集模式：</value>
+    <comment>Scan - 采集模式标签 | Scan mode label</comment>
+  </data>
+  <data name="Scan_Text_FrameMerge" xml:space="preserve">
+    <value>帧合并：</value>
+    <comment>Scan - 帧合并标签 | Frame merge label</comment>
+  </data>
+  <data name="Scan_Text_Nums" xml:space="preserve">
+    <value>采集张数：</value>
+    <comment>Scan - 采集张数标签 | Acquisition count label</comment>
+  </data>
+  <data name="Scan_Text_Angles" xml:space="preserve">
+    <value>旋转角度：</value>
+    <comment>Scan - 旋转角度标签 | Rotation angle label</comment>
+  </data>
+  <data name="Scan_Text_Progress" xml:space="preserve">
+    <value>采集进度：</value>
+    <comment>Scan - 采集进度标签 | Acquisition progress label</comment>
+  </data>
+  <data name="Scan_Button_Start" xml:space="preserve">
+    <value>开始采集</value>
+    <comment>Scan - 开始采集按钮 | Start acquisition button</comment>
+  </data>
+  <data name="Scan_Button_Stop" xml:space="preserve">
+    <value>停止采集</value>
+    <comment>Scan - 停止采集按钮 | Stop acquisition button</comment>
+  </data>
+  <data name="LogViewer_StatusTotal" xml:space="preserve">
+    <value>共 {0} 条日志</value>
+    <comment>LogViewer - 状态栏总数 | Status bar total count</comment>
+  </data>
+  <data name="LogViewer_StatusFiltered" xml:space="preserve">
+    <value>共 {0} 条日志，过滤后 {1} 条</value>
+    <comment>LogViewer - 状态栏过滤后 | Status bar filtered count</comment>
+  </data>
+  <data name="LogViewer_Title" xml:space="preserve">
+    <value>实时日志查看器</value>
+    <comment>LogViewer - 窗口标题 | Window title</comment>
+  </data>
+  <data name="LogViewer_AutoScroll" xml:space="preserve">
+    <value>自动滚动</value>
+    <comment>LogViewer - 自动滚动按钮 | Auto-scroll button</comment>
+  </data>
+  <data name="LogViewer_ClearLog" xml:space="preserve">
+    <value>清空日志</value>
+    <comment>LogViewer - 清空日志按钮 | Clear log button</comment>
+  </data>
+  <data name="LogViewer_Filter" xml:space="preserve">
+    <value>过滤：</value>
+    <comment>LogViewer - 过滤标签 | Filter label</comment>
+  </data>
+  <data name="LogViewer_FilterWatermark" xml:space="preserve">
+    <value>输入关键词过滤日志...</value>
+    <comment>LogViewer - 过滤水印 | Filter watermark</comment>
+  </data>
+  <data name="LogViewer_LevelFilter" xml:space="preserve">
+    <value>级别筛选：</value>
+    <comment>LogViewer - 级别筛选标签 | Level filter label</comment>
+  </data>
+  <data name="LogViewer_ColTime" xml:space="preserve">
+    <value>时间</value>
+    <comment>LogViewer - 时间列头 | Time column header</comment>
+  </data>
+  <data name="LogViewer_ColLevel" xml:space="preserve">
+    <value>级别</value>
+    <comment>LogViewer - 级别列头 | Level column header</comment>
+  </data>
+  <data name="LogViewer_ColSource" xml:space="preserve">
+    <value>来源</value>
+    <comment>LogViewer - 来源列头 | Source column header</comment>
+  </data>
+  <data name="LogViewer_ColMessage" xml:space="preserve">
+    <value>消息</value>
+    <comment>LogViewer - 消息列头 | Message column header</comment>
+  </data>
+  <data name="LogViewer_MaxLines" xml:space="preserve">
+    <value>最大行数：</value>
+    <comment>LogViewer - 最大行数标签 | Max lines label</comment>
+  </data>
+  <data name="PdfViewer_Title" xml:space="preserve">
+    <value>PDF 阅读器</value>
+    <comment>PdfViewer - 窗口标题 | Window title</comment>
+  </data>
+  <data name="PdfViewer_TitleWithFile" xml:space="preserve">
+    <value>PDF 阅读器 - {0}</value>
+    <comment>PdfViewer - 带文件名的窗口标题 | Window title with file name</comment>
+  </data>
+  <data name="PdfViewer_LoadSuccess" xml:space="preserve">
+    <value>PDF 文件加载成功：{0}（{1} 页）</value>
+    <comment>PdfViewer - 加载成功日志 | Load success log</comment>
+  </data>
+  <data name="PdfViewer_LoadFailed" xml:space="preserve">
+    <value>PDF 文件加载失败</value>
+    <comment>PdfViewer - 加载失败日志 | Load failed log</comment>
+  </data>
+  <data name="PdfViewer_PrintSuccess" xml:space="preserve">
+    <value>打印任务已提交：{0} → {1}</value>
+    <comment>PdfViewer - 打印成功日志 | Print success log</comment>
+  </data>
+  <data name="PdfViewer_PrintFailed" xml:space="preserve">
+    <value>打印失败</value>
+    <comment>PdfViewer - 打印失败日志 | Print failed log</comment>
+  </data>
+  <data name="PdfViewer_PrinterNotFound" xml:space="preserve">
+    <value>打印机未找到：{0}</value>
+    <comment>PdfViewer - 打印机未找到 | Printer not found</comment>
+  </data>
+</root>

XP.Common/Resources/Resources.zh-CN.resx

@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!-- 
+    Microsoft ResX Schema 
+    
+    Version 2.0
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
+    associated with the data types.
+    
+    Example:
+    
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+                
+    There are any number of "resheader" rows that contain simple 
+    name/value pairs.
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
+    mimetype set.
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
+    extensible. For a given mimetype the value must be set accordingly:
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
+    read any of the formats listed below.
+    
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+    
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array 
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <data name="App_Title" xml:space="preserve">
+    <value>XplorePlane X射线检测系统</value>
+  </data>
+  <data name="Menu_File" xml:space="preserve">
+    <value>文件</value>
+  </data>
+  <data name="Menu_Settings" xml:space="preserve">
+    <value>设置</value>
+  </data>
+  <data name="Button_OK" xml:space="preserve">
+    <value>确定</value>
+  </data>
+  <data name="Button_Cancel" xml:space="preserve">
+    <value>取消</value>
+  </data>
+  <data name="Language_ZhCN" xml:space="preserve">
+    <value>简体中文</value>
+  </data>
+  <data name="Language_ZhTW" xml:space="preserve">
+    <value>繁體中文</value>
+  </data>
+  <data name="Language_EnUS" xml:space="preserve">
+    <value>English</value>
+  </data>
+  <data name="Settings_Language" xml:space="preserve">
+    <value>语言设置</value>
+  </data>
+  <data name="Settings_Language_Description" xml:space="preserve">
+    <value>选择您偏好的显示语言</value>
+  </data>
+  <data name="Settings_Language_RestartNotice" xml:space="preserve">
+    <value>语言切换将在下次启动应用程序时生效。</value>
+  </data>
+  <data name="Button_Apply" xml:space="preserve">
+    <value>应用</value>
+  </data>
+  <data name="Button_Close" xml:space="preserve">
+    <value>关闭</value>
+  </data>
+  <data name="Button_Save" xml:space="preserve">
+    <value>保存</value>
+  </data>
+  <data name="Button_Delete" xml:space="preserve">
+    <value>删除</value>
+  </data>
+  <data name="Button_Edit" xml:space="preserve">
+    <value>编辑</value>
+  </data>
+  <data name="Button_Add" xml:space="preserve">
+    <value>添加</value>
+  </data>
+  <data name="Button_Refresh" xml:space="preserve">
+    <value>刷新</value>
+  </data>
+  <data name="Button_Search" xml:space="preserve">
+    <value>搜索</value>
+  </data>
+  <data name="Button_Reset" xml:space="preserve">
+    <value>重置</value>
+  </data>
+  <data name="Status_Ready" xml:space="preserve">
+    <value>就绪</value>
+  </data>
+  <data name="Status_Loading" xml:space="preserve">
+    <value>加载中...</value>
+  </data>
+  <data name="Status_Saving" xml:space="preserve">
+    <value>保存中...</value>
+  </data>
+  <data name="Status_Processing" xml:space="preserve">
+    <value>处理中...</value>
+  </data>
+  <data name="Status_Success" xml:space="preserve">
+    <value>成功</value>
+  </data>
+  <data name="Status_Failed" xml:space="preserve">
+    <value>失败</value>
+  </data>
+  <data name="Status_Error" xml:space="preserve">
+    <value>错误</value>
+  </data>
+  <data name="Status_Warning" xml:space="preserve">
+    <value>警告</value>
+  </data>
+  <data name="Status_Connected" xml:space="preserve">
+    <value>已连接</value>
+  </data>
+  <data name="Status_Disconnected" xml:space="preserve">
+    <value>已断开</value>
+  </data>
+  <data name="Welcome_Message" xml:space="preserve">
+    <value>欢迎使用 XplorePlane X射线检测系统</value>
+  </data>
+  <data name="Message_OperationSuccess" xml:space="preserve">
+    <value>操作成功完成</value>
+  </data>
+  <data name="Message_OperationFailed" xml:space="preserve">
+    <value>操作失败</value>
+  </data>
+  <data name="Message_ConfirmDelete" xml:space="preserve">
+    <value>确定要删除吗？</value>
+  </data>
+  <data name="Message_UnsavedChanges" xml:space="preserve">
+    <value>有未保存的更改，是否保存？</value>
+  </data>
+  <data name="Message_InvalidInput" xml:space="preserve">
+    <value>输入无效，请检查后重试</value>
+  </data>
+  <data name="Message_ConnectionLost" xml:space="preserve">
+    <value>连接已断开</value>
+  </data>
+  <data name="Message_RestartRequired" xml:space="preserve">
+    <value>语言设置已保存，请重启应用程序以应用新语言。</value>
+  </data>
+  <data name="Menu_View" xml:space="preserve">
+    <value>视图</value>
+  </data>
+  <data name="Menu_Tools" xml:space="preserve">
+    <value>工具</value>
+  </data>
+  <data name="Menu_Help" xml:space="preserve">
+    <value>帮助</value>
+  </data>
+  <data name="Menu_Exit" xml:space="preserve">
+    <value>退出</value>
+  </data>
+  <data name="Menu_About" xml:space="preserve">
+    <value>关于</value>
+  </data>
+  <data name="Dialog_Confirmation" xml:space="preserve">
+    <value>确认</value>
+  </data>
+  <data name="Dialog_Information" xml:space="preserve">
+    <value>信息</value>
+  </data>
+  <data name="Dialog_Warning" xml:space="preserve">
+    <value>警告</value>
+  </data>
+  <data name="Dialog_Error" xml:space="preserve">
+    <value>错误</value>
+  </data>
+  <data name="Dialog_Notice" xml:space="preserve">
+    <value>提示</value>
+  </data>
+  <data name="Settings_Language_SavedRestartRequired" xml:space="preserve">
+    <value>语言设置已保存，请重启应用程序以应用新语言。</value>
+  </data>
+  <data name="Settings_Language_SwitchFailed" xml:space="preserve">
+    <value>语言切换失败：{0}</value>
+  </data>
+  <data name="Scan_Text_ScanMode" xml:space="preserve">
+    <value>采集模式：</value>
+    <comment>Scan - 采集模式标签 | Scan mode label</comment>
+  </data>
+  <data name="Scan_Text_FrameMerge" xml:space="preserve">
+    <value>帧合并：</value>
+    <comment>Scan - 帧合并标签 | Frame merge label</comment>
+  </data>
+  <data name="Scan_Text_Nums" xml:space="preserve">
+    <value>采集张数：</value>
+    <comment>Scan - 采集张数标签 | Acquisition count label</comment>
+  </data>
+  <data name="Scan_Text_Angles" xml:space="preserve">
+    <value>旋转角度：</value>
+    <comment>Scan - 旋转角度标签 | Rotation angle label</comment>
+  </data>
+  <data name="Scan_Text_Progress" xml:space="preserve">
+    <value>采集进度：</value>
+    <comment>Scan - 采集进度标签 | Acquisition progress label</comment>
+  </data>
+  <data name="Scan_Button_Start" xml:space="preserve">
+    <value>开始采集</value>
+    <comment>Scan - 开始采集按钮 | Start acquisition button</comment>
+  </data>
+  <data name="Scan_Button_Stop" xml:space="preserve">
+    <value>停止采集</value>
+    <comment>Scan - 停止采集按钮 | Stop acquisition button</comment>
+  </data>
+  <data name="LogViewer_StatusTotal" xml:space="preserve">
+    <value>共 {0} 条日志</value>
+    <comment>LogViewer - 状态栏总数 | Status bar total count</comment>
+  </data>
+  <data name="LogViewer_StatusFiltered" xml:space="preserve">
+    <value>共 {0} 条日志，过滤后 {1} 条</value>
+    <comment>LogViewer - 状态栏过滤后 | Status bar filtered count</comment>
+  </data>
+  <data name="LogViewer_Title" xml:space="preserve">
+    <value>实时日志查看器</value>
+    <comment>LogViewer - 窗口标题 | Window title</comment>
+  </data>
+  <data name="LogViewer_AutoScroll" xml:space="preserve">
+    <value>自动滚动</value>
+    <comment>LogViewer - 自动滚动按钮 | Auto-scroll button</comment>
+  </data>
+  <data name="LogViewer_ClearLog" xml:space="preserve">
+    <value>清空日志</value>
+    <comment>LogViewer - 清空日志按钮 | Clear log button</comment>
+  </data>
+  <data name="LogViewer_Filter" xml:space="preserve">
+    <value>过滤：</value>
+    <comment>LogViewer - 过滤标签 | Filter label</comment>
+  </data>
+  <data name="LogViewer_FilterWatermark" xml:space="preserve">
+    <value>输入关键词过滤日志...</value>
+    <comment>LogViewer - 过滤水印 | Filter watermark</comment>
+  </data>
+  <data name="LogViewer_LevelFilter" xml:space="preserve">
+    <value>级别筛选：</value>
+    <comment>LogViewer - 级别筛选标签 | Level filter label</comment>
+  </data>
+  <data name="LogViewer_ColTime" xml:space="preserve">
+    <value>时间</value>
+    <comment>LogViewer - 时间列头 | Time column header</comment>
+  </data>
+  <data name="LogViewer_ColLevel" xml:space="preserve">
+    <value>级别</value>
+    <comment>LogViewer - 级别列头 | Level column header</comment>
+  </data>
+  <data name="LogViewer_ColSource" xml:space="preserve">
+    <value>来源</value>
+    <comment>LogViewer - 来源列头 | Source column header</comment>
+  </data>
+  <data name="LogViewer_ColMessage" xml:space="preserve">
+    <value>消息</value>
+    <comment>LogViewer - 消息列头 | Message column header</comment>
+  </data>
+  <data name="LogViewer_MaxLines" xml:space="preserve">
+    <value>最大行数：</value>
+    <comment>LogViewer - 最大行数标签 | Max lines label</comment>
+  </data>
+  <data name="PdfViewer_Title" xml:space="preserve">
+    <value>PDF 阅读器</value>
+    <comment>PdfViewer - 窗口标题 | Window title</comment>
+  </data>
+  <data name="PdfViewer_TitleWithFile" xml:space="preserve">
+    <value>PDF 阅读器 - {0}</value>
+    <comment>PdfViewer - 带文件名的窗口标题 | Window title with file name</comment>
+  </data>
+  <data name="PdfViewer_LoadSuccess" xml:space="preserve">
+    <value>PDF 文件加载成功：{0}（{1} 页）</value>
+    <comment>PdfViewer - 加载成功日志 | Load success log</comment>
+  </data>
+  <data name="PdfViewer_LoadFailed" xml:space="preserve">
+    <value>PDF 文件加载失败</value>
+    <comment>PdfViewer - 加载失败日志 | Load failed log</comment>
+  </data>
+  <data name="PdfViewer_PrintSuccess" xml:space="preserve">
+    <value>打印任务已提交：{0} → {1}</value>
+    <comment>PdfViewer - 打印成功日志 | Print success log</comment>
+  </data>
+  <data name="PdfViewer_PrintFailed" xml:space="preserve">
+    <value>打印失败</value>
+    <comment>PdfViewer - 打印失败日志 | Print failed log</comment>
+  </data>
+  <data name="PdfViewer_PrinterNotFound" xml:space="preserve">
+    <value>打印机未找到：{0}</value>
+    <comment>PdfViewer - 打印机未找到 | Printer not found</comment>
+  </data>
+</root>

XP.Common/Resources/Resources.zh-TW.resx

@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!-- 
+    Microsoft ResX Schema 
+    
+    Version 2.0
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
+    associated with the data types.
+    
+    Example:
+    
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+                
+    There are any number of "resheader" rows that contain simple 
+    name/value pairs.
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
+    mimetype set.
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
+    extensible. For a given mimetype the value must be set accordingly:
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
+    read any of the formats listed below.
+    
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+    
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array 
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <data name="App_Title" xml:space="preserve">
+    <value>XplorePlane X射線檢測系統</value>
+  </data>
+  <data name="Menu_File" xml:space="preserve">
+    <value>檔案</value>
+  </data>
+  <data name="Menu_Settings" xml:space="preserve">
+    <value>設定</value>
+  </data>
+  <data name="Button_OK" xml:space="preserve">
+    <value>確定</value>
+  </data>
+  <data name="Button_Cancel" xml:space="preserve">
+    <value>取消</value>
+  </data>
+  <data name="Language_ZhCN" xml:space="preserve">
+    <value>簡體中文</value>
+  </data>
+  <data name="Language_ZhTW" xml:space="preserve">
+    <value>繁體中文</value>
+  </data>
+  <data name="Language_EnUS" xml:space="preserve">
+    <value>English</value>
+  </data>
+  <data name="Settings_Language" xml:space="preserve">
+    <value>語言設定</value>
+  </data>
+  <data name="Settings_Language_Description" xml:space="preserve">
+    <value>選擇您偏好的顯示語言</value>
+  </data>
+  <data name="Settings_Language_RestartNotice" xml:space="preserve">
+    <value>語言切換將在下次啟動應用程式時生效。</value>
+  </data>
+  <data name="Button_Apply" xml:space="preserve">
+    <value>套用</value>
+  </data>
+  <data name="Button_Close" xml:space="preserve">
+    <value>關閉</value>
+  </data>
+  <data name="Button_Save" xml:space="preserve">
+    <value>儲存</value>
+  </data>
+  <data name="Button_Delete" xml:space="preserve">
+    <value>刪除</value>
+  </data>
+  <data name="Button_Edit" xml:space="preserve">
+    <value>編輯</value>
+  </data>
+  <data name="Button_Add" xml:space="preserve">
+    <value>新增</value>
+  </data>
+  <data name="Button_Refresh" xml:space="preserve">
+    <value>重新整理</value>
+  </data>
+  <data name="Button_Search" xml:space="preserve">
+    <value>搜尋</value>
+  </data>
+  <data name="Button_Reset" xml:space="preserve">
+    <value>重設</value>
+  </data>
+  <data name="Status_Ready" xml:space="preserve">
+    <value>就緒</value>
+  </data>
+  <data name="Status_Loading" xml:space="preserve">
+    <value>載入中...</value>
+  </data>
+  <data name="Status_Saving" xml:space="preserve">
+    <value>儲存中...</value>
+  </data>
+  <data name="Status_Processing" xml:space="preserve">
+    <value>處理中...</value>
+  </data>
+  <data name="Status_Success" xml:space="preserve">
+    <value>成功</value>
+  </data>
+  <data name="Status_Failed" xml:space="preserve">
+    <value>失敗</value>
+  </data>
+  <data name="Status_Error" xml:space="preserve">
+    <value>錯誤</value>
+  </data>
+  <data name="Status_Warning" xml:space="preserve">
+    <value>警告</value>
+  </data>
+  <data name="Status_Connected" xml:space="preserve">
+    <value>已連線</value>
+  </data>
+  <data name="Status_Disconnected" xml:space="preserve">
+    <value>已中斷連線</value>
+  </data>
+  <data name="Welcome_Message" xml:space="preserve">
+    <value>歡迎使用 XplorePlane X射線檢測系統</value>
+  </data>
+  <data name="Message_OperationSuccess" xml:space="preserve">
+    <value>操作成功完成</value>
+  </data>
+  <data name="Message_OperationFailed" xml:space="preserve">
+    <value>操作失敗</value>
+  </data>
+  <data name="Message_ConfirmDelete" xml:space="preserve">
+    <value>確定要刪除嗎？</value>
+  </data>
+  <data name="Message_UnsavedChanges" xml:space="preserve">
+    <value>有未儲存的變更，是否儲存？</value>
+  </data>
+  <data name="Message_InvalidInput" xml:space="preserve">
+    <value>輸入無效，請檢查後重試</value>
+  </data>
+  <data name="Message_ConnectionLost" xml:space="preserve">
+    <value>連線已中斷</value>
+  </data>
+  <data name="Message_RestartRequired" xml:space="preserve">
+    <value>語言設定已儲存，請重新啟動應用程式以套用新語言。</value>
+  </data>
+  <data name="Menu_View" xml:space="preserve">
+    <value>檢視</value>
+  </data>
+  <data name="Menu_Tools" xml:space="preserve">
+    <value>工具</value>
+  </data>
+  <data name="Menu_Help" xml:space="preserve">
+    <value>說明</value>
+  </data>
+  <data name="Menu_Exit" xml:space="preserve">
+    <value>結束</value>
+  </data>
+  <data name="Menu_About" xml:space="preserve">
+    <value>關於</value>
+  </data>
+  <data name="Dialog_Confirmation" xml:space="preserve">
+    <value>確認</value>
+  </data>
+  <data name="Dialog_Information" xml:space="preserve">
+    <value>資訊</value>
+  </data>
+  <data name="Dialog_Warning" xml:space="preserve">
+    <value>警告</value>
+  </data>
+  <data name="Dialog_Error" xml:space="preserve">
+    <value>錯誤</value>
+  </data>
+  <data name="Dialog_Notice" xml:space="preserve">
+    <value>提示</value>
+  </data>
+  <data name="Settings_Language_SavedRestartRequired" xml:space="preserve">
+    <value>語言設定已儲存，請重新啟動應用程式以套用新語言。</value>
+  </data>
+  <data name="Settings_Language_SwitchFailed" xml:space="preserve">
+    <value>語言切換失敗：{0}</value>
+  </data>
+  <data name="Scan_Text_ScanMode" xml:space="preserve">
+    <value>採集模式：</value>
+    <comment>Scan - 採集模式標籤 | Scan mode label</comment>
+  </data>
+  <data name="Scan_Text_FrameMerge" xml:space="preserve">
+    <value>幀合併：</value>
+    <comment>Scan - 幀合併標籤 | Frame merge label</comment>
+  </data>
+  <data name="Scan_Text_Nums" xml:space="preserve">
+    <value>採集張數：</value>
+    <comment>Scan - 採集張數標籤 | Acquisition count label</comment>
+  </data>
+  <data name="Scan_Text_Angles" xml:space="preserve">
+    <value>旋轉角度：</value>
+    <comment>Scan - 旋轉角度標籤 | Rotation angle label</comment>
+  </data>
+  <data name="Scan_Text_Progress" xml:space="preserve">
+    <value>採集進度：</value>
+    <comment>Scan - 採集進度標籤 | Acquisition progress label</comment>
+  </data>
+  <data name="Scan_Button_Start" xml:space="preserve">
+    <value>開始採集</value>
+    <comment>Scan - 開始採集按鈕 | Start acquisition button</comment>
+  </data>
+  <data name="Scan_Button_Stop" xml:space="preserve">
+    <value>停止採集</value>
+    <comment>Scan - 停止採集按鈕 | Stop acquisition button</comment>
+  </data>
+  <data name="LogViewer_StatusTotal" xml:space="preserve">
+    <value>共 {0} 筆日誌</value>
+    <comment>LogViewer - 狀態列總數 | Status bar total count</comment>
+  </data>
+  <data name="LogViewer_StatusFiltered" xml:space="preserve">
+    <value>共 {0} 筆日誌，篩選後 {1} 筆</value>
+    <comment>LogViewer - 狀態列篩選後 | Status bar filtered count</comment>
+  </data>
+  <data name="LogViewer_Title" xml:space="preserve">
+    <value>即時日誌檢視器</value>
+    <comment>LogViewer - 視窗標題 | Window title</comment>
+  </data>
+  <data name="LogViewer_AutoScroll" xml:space="preserve">
+    <value>自動捲動</value>
+    <comment>LogViewer - 自動捲動按鈕 | Auto-scroll button</comment>
+  </data>
+  <data name="LogViewer_ClearLog" xml:space="preserve">
+    <value>清空日誌</value>
+    <comment>LogViewer - 清空日誌按鈕 | Clear log button</comment>
+  </data>
+  <data name="LogViewer_Filter" xml:space="preserve">
+    <value>篩選：</value>
+    <comment>LogViewer - 篩選標籤 | Filter label</comment>
+  </data>
+  <data name="LogViewer_FilterWatermark" xml:space="preserve">
+    <value>輸入關鍵詞篩選日誌...</value>
+    <comment>LogViewer - 篩選浮水印 | Filter watermark</comment>
+  </data>
+  <data name="LogViewer_LevelFilter" xml:space="preserve">
+    <value>級別篩選：</value>
+    <comment>LogViewer - 級別篩選標籤 | Level filter label</comment>
+  </data>
+  <data name="LogViewer_ColTime" xml:space="preserve">
+    <value>時間</value>
+    <comment>LogViewer - 時間欄頭 | Time column header</comment>
+  </data>
+  <data name="LogViewer_ColLevel" xml:space="preserve">
+    <value>級別</value>
+    <comment>LogViewer - 級別欄頭 | Level column header</comment>
+  </data>
+  <data name="LogViewer_ColSource" xml:space="preserve">
+    <value>來源</value>
+    <comment>LogViewer - 來源欄頭 | Source column header</comment>
+  </data>
+  <data name="LogViewer_ColMessage" xml:space="preserve">
+    <value>訊息</value>
+    <comment>LogViewer - 訊息欄頭 | Message column header</comment>
+  </data>
+  <data name="LogViewer_MaxLines" xml:space="preserve">
+    <value>最大行數：</value>
+    <comment>LogViewer - 最大行數標籤 | Max lines label</comment>
+  </data>
+  <data name="PdfViewer_Title" xml:space="preserve">
+    <value>PDF 閱讀器</value>
+    <comment>PdfViewer - 視窗標題 | Window title</comment>
+  </data>
+  <data name="PdfViewer_TitleWithFile" xml:space="preserve">
+    <value>PDF 閱讀器 - {0}</value>
+    <comment>PdfViewer - 帶檔案名稱的視窗標題 | Window title with file name</comment>
+  </data>
+  <data name="PdfViewer_LoadSuccess" xml:space="preserve">
+    <value>PDF 檔案載入成功：{0}（{1} 頁）</value>
+    <comment>PdfViewer - 載入成功日誌 | Load success log</comment>
+  </data>
+  <data name="PdfViewer_LoadFailed" xml:space="preserve">
+    <value>PDF 檔案載入失敗</value>
+    <comment>PdfViewer - 載入失敗日誌 | Load failed log</comment>
+  </data>
+  <data name="PdfViewer_PrintSuccess" xml:space="preserve">
+    <value>列印任務已提交：{0} → {1}</value>
+    <comment>PdfViewer - 列印成功日誌 | Print success log</comment>
+  </data>
+  <data name="PdfViewer_PrintFailed" xml:space="preserve">
+    <value>列印失敗</value>
+    <comment>PdfViewer - 列印失敗日誌 | Print failed log</comment>
+  </data>
+  <data name="PdfViewer_PrinterNotFound" xml:space="preserve">
+    <value>印表機未找到：{0}</value>
+    <comment>PdfViewer - 印表機未找到 | Printer not found</comment>
+  </data>
+</root>

XP.Common/XP.Common.csproj

@@ -0,0 +1,67 @@
+<Project Sdk="Microsoft.NET.Sdk">
+	<PropertyGroup>
+		<TargetFramework>net8.0-windows7.0</TargetFramework>
+		<AllowUnsafeBlocks>true</AllowUnsafeBlocks>
+		<!-- NuGet 包版本 (用于包管理) -->
+		<Version>1.0.0</Version>
+		<!-- 程序集版本 (用于代码引用) -->
+		<AssemblyVersion>1.4.16.1</AssemblyVersion>
+		<!-- 文件版本 (用于 Windows 文件属性显示) -->
+		<FileVersion>1.4.16.1</FileVersion>
+		<!-- 版权声明 -->
+		<Copyright>Copyright © 2026 Hexagon. All rights reserved.</Copyright>
+		<!-- 公司名称 -->
+		<Company>Hexagon Manufacturing Intelligence (Qingdao) Co., Ltd.</Company>
+		<!-- 产品名称  -->
+		<Product>XplorePlane XP.Common Infrastructure</Product>
+		<!-- 标题 -->
+		<AssemblyTitle>XP.Common Core Library</AssemblyTitle>
+		<UseWPF>true</UseWPF>
+		<Nullable>enable</Nullable>
+	</PropertyGroup>
+	<ItemGroup>
+		<PackageReference Include="Microsoft.Data.Sqlite" Version="10.0.3" />
+		<PackageReference Include="Emgu.CV" Version="4.10.0.5680" />
+		<PackageReference Include="Emgu.CV.runtime.windows" Version="4.10.0.5680" />
+		<PackageReference Include="Prism.Wpf" Version="9.0.537" />
+		<PackageReference Include="Serilog" Version="4.3.1" />
+		<PackageReference Include="Serilog.Settings.Configuration" Version="10.0.0" />
+		<PackageReference Include="Serilog.Sinks.Console" Version="6.1.1" />
+		<PackageReference Include="Serilog.Sinks.File" Version="7.0.0" />
+		<PackageReference Include="Telerik.UI.for.Wpf.NetCore.Xaml" Version="2024.1.408" />
+	</ItemGroup>
+	<ItemGroup>
+		<Folder Include="Controls\ViewModels\" />
+		<Folder Include="Controls\Views\" />
+		<Folder Include="Extensions\" />
+		<Folder Include="Serialization\" />
+		<Folder Include="Converters\" />
+		<Folder Include="PdfViewer\Exceptions\" />
+		<Folder Include="PdfViewer\Interfaces\" />
+		<Folder Include="PdfViewer\Implementations\" />
+		<Folder Include="PdfViewer\ViewModels\" />
+		<Folder Include="PdfViewer\Views\" />
+	</ItemGroup>
+	<ItemGroup>
+		<EmbeddedResource Update="Resources\Resources.resx">
+			<Generator>PublicResXFileCodeGenerator</Generator>
+			<LastGenOutput>Resources.Designer.cs</LastGenOutput>
+		</EmbeddedResource>
+		<EmbeddedResource Update="Resources\Resources.zh-CN.resx">
+			<DependentUpon>Resources.resx</DependentUpon>
+		</EmbeddedResource>
+		<EmbeddedResource Update="Resources\Resources.zh-TW.resx">
+			<DependentUpon>Resources.resx</DependentUpon>
+		</EmbeddedResource>
+		<EmbeddedResource Update="Resources\Resources.en-US.resx">
+			<DependentUpon>Resources.resx</DependentUpon>
+		</EmbeddedResource>
+	</ItemGroup>
+	<ItemGroup>
+		<Compile Update="Resources\Resources.Designer.cs">
+			<DesignTime>True</DesignTime>
+			<AutoGen>True</AutoGen>
+			<DependentUpon>Resources.resx</DependentUpon>
+		</Compile>
+	</ItemGroup>
+</Project>

XP.Hardware.Detector/Abstractions/AreaDetectorBase.cs

@@ -0,0 +1,533 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using Prism.Events;
+using XP.Hardware.Detector.Abstractions.Enums;
+using XP.Hardware.Detector.Abstractions.Events;
+
+namespace XP.Hardware.Detector.Abstractions
+{
+    /// <summary>
+    /// 面阵探测器抽象基类 | Area detector abstract base class
+    /// 封装通用逻辑：参数校验、状态更新、事件发布
+    /// 使用模板方法模式，子类实现具体的硬件操作
+    /// </summary>
+    public abstract class AreaDetectorBase : IAreaDetector
+    {
+        protected readonly IEventAggregator _eventAggregator;
+        protected readonly object _statusLock = new object();
+        protected DetectorStatus _status = DetectorStatus.Uninitialized;
+        protected bool _disposed = false;
+
+        /// <summary>
+        /// 探测器状态 | Detector status
+        /// </summary>
+        public DetectorStatus Status
+        {
+            get
+            {
+                lock (_statusLock)
+                {
+                    return _status;
+                }
+            }
+        }
+
+        /// <summary>
+        /// 探测器类型 | Detector type
+        /// </summary>
+        public abstract DetectorType Type { get; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="eventAggregator">事件聚合器 | Event aggregator</param>
+        protected AreaDetectorBase(IEventAggregator eventAggregator)
+        {
+            _eventAggregator = eventAggregator ?? throw new ArgumentNullException(nameof(eventAggregator));
+        }
+
+        /// <summary>
+        /// 初始化探测器 | Initialize detector
+        /// </summary>
+        public async Task<DetectorResult> InitializeAsync(CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Uninitialized)
+            {
+                return DetectorResult.Failure("探测器已初始化 | Detector already initialized");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Initializing);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await InitializeInternalAsync(cancellationToken);
+
+                if (result.IsSuccess)
+                {
+                    UpdateStatus(DetectorStatus.Ready);
+                }
+                else
+                {
+                    UpdateStatus(DetectorStatus.Error);
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"初始化异常 | Initialization exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 启动连续采集 | Start continuous acquisition
+        /// </summary>
+        public async Task<DetectorResult> StartAcquisitionAsync(CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Ready)
+            {
+                return DetectorResult.Failure($"探测器状态不正确，当前状态：{Status} | Detector status incorrect, current status: {Status}");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Acquiring);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await StartAcquisitionInternalAsync(cancellationToken);
+
+                if (!result.IsSuccess)
+                {
+                    UpdateStatus(DetectorStatus.Ready);
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"启动采集异常 | Start acquisition exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 停止采集 | Stop acquisition
+        /// </summary>
+        public async Task<DetectorResult> StopAcquisitionAsync(CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            // 未初始化时不允许停止采集操作 | Stop acquisition not allowed when uninitialized
+            if (Status == DetectorStatus.Uninitialized)
+            {
+                return DetectorResult.Failure("探测器未初始化，无法执行停止采集操作 | Detector not initialized, cannot stop acquisition");
+            }
+
+            try
+            {
+                // 调用子类实现 | Call derived class implementation
+                var result = await StopAcquisitionInternalAsync(cancellationToken);
+
+                if (result.IsSuccess)
+                {
+                    UpdateStatus(DetectorStatus.Ready);
+                }
+                else
+                {
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"停止采集异常 | Stop acquisition exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 单帧采集 | Single frame acquisition
+        /// </summary>
+        public async Task<DetectorResult> AcquireSingleFrameAsync(CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Ready)
+            {
+                return DetectorResult.Failure($"探测器状态不正确，当前状态：{Status} | Detector status incorrect, current status: {Status}");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Acquiring);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await AcquireSingleFrameInternalAsync(cancellationToken);
+
+                // 恢复状态 | Restore status
+                UpdateStatus(DetectorStatus.Ready);
+
+                if (!result.IsSuccess)
+                {
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"单帧采集异常 | Single frame acquisition exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 暗场校正 | Dark field correction
+        /// </summary>
+        public async Task<DetectorResult> DarkCorrectionAsync(int frameCount, CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Ready)
+            {
+                return DetectorResult.Failure($"探测器状态不正确，当前状态：{Status} | Detector status incorrect, current status: {Status}");
+            }
+
+            if (frameCount <= 0)
+            {
+                return DetectorResult.Failure("帧数必须大于 0 | Frame count must be greater than 0");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Correcting);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await DarkCorrectionInternalAsync(frameCount, cancellationToken);
+
+                // 恢复状态 | Restore status
+                UpdateStatus(DetectorStatus.Ready);
+
+                if (result.IsSuccess)
+                {
+                    PublishCorrectionCompleted(CorrectionType.Dark, result);
+                }
+                else
+                {
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"暗场校正异常 | Dark correction exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 增益校正 | Gain correction
+        /// </summary>
+        public async Task<DetectorResult> GainCorrectionAsync(int frameCount, CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Ready)
+            {
+                return DetectorResult.Failure($"探测器状态不正确，当前状态：{Status} | Detector status incorrect, current status: {Status}");
+            }
+
+            if (frameCount <= 0)
+            {
+                return DetectorResult.Failure("帧数必须大于 0 | Frame count must be greater than 0");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Correcting);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await GainCorrectionInternalAsync(frameCount, cancellationToken);
+
+                // 恢复状态 | Restore status
+                UpdateStatus(DetectorStatus.Ready);
+
+                if (result.IsSuccess)
+                {
+                    PublishCorrectionCompleted(CorrectionType.Gain, result);
+                }
+                else
+                {
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"增益校正异常 | Gain correction exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 自动校正 | Auto correction
+        /// </summary>
+        public async Task<DetectorResult> AutoCorrectionAsync(int frameCount, CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Ready)
+            {
+                return DetectorResult.Failure($"探测器状态不正确，当前状态：{Status} | Detector status incorrect, current status: {Status}");
+            }
+
+            if (frameCount <= 0)
+            {
+                return DetectorResult.Failure("帧数必须大于 0 | Frame count must be greater than 0");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Correcting);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await AutoCorrectionInternalAsync(frameCount, cancellationToken);
+
+                // 恢复状态 | Restore status
+                UpdateStatus(DetectorStatus.Ready);
+
+                if (result.IsSuccess)
+                {
+                    PublishCorrectionCompleted(CorrectionType.Auto, result);
+                }
+                else
+                {
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"自动校正异常 | Auto correction exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 坏像素校正 | Bad pixel correction
+        /// </summary>
+        public async Task<DetectorResult> BadPixelCorrectionAsync(CancellationToken cancellationToken = default)
+        {
+            // 参数校验 | Parameter validation
+            if (Status != DetectorStatus.Ready)
+            {
+                return DetectorResult.Failure($"探测器状态不正确，当前状态：{Status} | Detector status incorrect, current status: {Status}");
+            }
+
+            try
+            {
+                // 更新状态 | Update status
+                UpdateStatus(DetectorStatus.Correcting);
+
+                // 调用子类实现 | Call derived class implementation
+                var result = await BadPixelCorrectionInternalAsync(cancellationToken);
+
+                // 恢复状态 | Restore status
+                UpdateStatus(DetectorStatus.Ready);
+
+                if (result.IsSuccess)
+                {
+                    PublishCorrectionCompleted(CorrectionType.BadPixel, result);
+                }
+                else
+                {
+                    PublishError(result);
+                }
+
+                return result;
+            }
+            catch (Exception ex)
+            {
+                UpdateStatus(DetectorStatus.Error);
+                var errorResult = DetectorResult.Failure($"坏像素校正异常 | Bad pixel correction exception: {ex.Message}", ex);
+                PublishError(errorResult);
+                return errorResult;
+            }
+        }
+
+        /// <summary>
+        /// 获取探测器信息 | Get detector information
+        /// </summary>
+        public abstract DetectorInfo GetInfo();
+
+        // 模板方法，由子类实现 | Template methods, implemented by derived classes
+        protected abstract Task<DetectorResult> InitializeInternalAsync(CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> StartAcquisitionInternalAsync(CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> StopAcquisitionInternalAsync(CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> AcquireSingleFrameInternalAsync(CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> DarkCorrectionInternalAsync(int frameCount, CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> GainCorrectionInternalAsync(int frameCount, CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> AutoCorrectionInternalAsync(int frameCount, CancellationToken cancellationToken);
+        protected abstract Task<DetectorResult> BadPixelCorrectionInternalAsync(CancellationToken cancellationToken);
+
+        /// <summary>
+        /// 更新状态并发布事件 | Update status and publish event
+        /// </summary>
+        /// <param name="newStatus">新状态 | New status</param>
+        /// <summary>
+                /// 更新状态并发布事件 | Update status and publish event
+                /// 验证状态转换的合法性 | Validate state transition legality
+                /// </summary>
+                /// <param name="newStatus">新状态 | New status</param>
+                protected void UpdateStatus(DetectorStatus newStatus)
+                {
+                    lock (_statusLock)
+                    {
+                        // 验证状态转换的合法性 | Validate state transition legality
+                        if (!IsValidStateTransition(_status, newStatus))
+                        {
+                            var errorMsg = $"非法的状态转换：{_status} -> {newStatus} | Invalid state transition: {_status} -> {newStatus}";
+                            PublishError(DetectorResult.Failure(errorMsg));
+                            return;
+                        }
+
+                        if (_status != newStatus)
+                        {
+                            var oldStatus = _status;
+                            _status = newStatus;
+                            _eventAggregator.GetEvent<StatusChangedEvent>().Publish(newStatus);
+
+                            // 记录状态转换日志（如果需要）| Log state transition (if needed)
+                            System.Diagnostics.Debug.WriteLine($"状态转换 | State transition: {oldStatus} -> {newStatus}");
+                        }
+                    }
+                }
+
+                /// <summary>
+                /// 验证状态转换是否合法 | Validate if state transition is legal
+                /// </summary>
+                /// <param name="currentStatus">当前状态 | Current status</param>
+                /// <param name="newStatus">新状态 | New status</param>
+                /// <returns>是否合法 | Whether it's legal</returns>
+                private bool IsValidStateTransition(DetectorStatus currentStatus, DetectorStatus newStatus)
+                {
+                    // 相同状态总是允许的 | Same state is always allowed
+                    if (currentStatus == newStatus)
+                    {
+                        return true;
+                    }
+
+                    // 定义合法的状态转换规则 | Define legal state transition rules
+                    return (currentStatus, newStatus) switch
+                    {
+                        // 从未初始化状态只能转到初始化中 | From Uninitialized can only go to Initializing
+                        (DetectorStatus.Uninitialized, DetectorStatus.Initializing) => true,
+
+                        // 从初始化中可以转到就绪或错误 | From Initializing can go to Ready or Error
+                        (DetectorStatus.Initializing, DetectorStatus.Ready) => true,
+                        (DetectorStatus.Initializing, DetectorStatus.Error) => true,
+
+                        // 从就绪状态可以转到采集中、校正中 | From Ready can go to Acquiring or Correcting
+                        (DetectorStatus.Ready, DetectorStatus.Acquiring) => true,
+                        (DetectorStatus.Ready, DetectorStatus.Correcting) => true,
+
+                        // 从采集中可以转到就绪或错误 | From Acquiring can go to Ready or Error
+                        (DetectorStatus.Acquiring, DetectorStatus.Ready) => true,
+                        (DetectorStatus.Acquiring, DetectorStatus.Error) => true,
+
+                        // 从校正中可以转到就绪或错误 | From Correcting can go to Ready or Error
+                        (DetectorStatus.Correcting, DetectorStatus.Ready) => true,
+                        (DetectorStatus.Correcting, DetectorStatus.Error) => true,
+
+                        // 从错误状态可以转到初始化中（重新初始化）| From Error can go to Initializing (re-initialize)
+                        (DetectorStatus.Error, DetectorStatus.Initializing) => true,
+
+                        // 任何状态都可以转到错误状态 | Any state can go to Error
+                        (_, DetectorStatus.Error) => true,
+
+                        // 其他转换都是非法的 | All other transitions are illegal
+                        _ => false
+                    };
+                }
+
+
+        /// <summary>
+        /// 发布错误事件 | Publish error event
+        /// </summary>
+        /// <param name="result">错误结果 | Error result</param>
+        protected void PublishError(DetectorResult result)
+        {
+            _eventAggregator.GetEvent<ErrorOccurredEvent>().Publish(result);
+        }
+
+        /// <summary>
+        /// 发布图像采集事件 | Publish image captured event
+        /// </summary>
+        /// <param name="args">事件参数 | Event arguments</param>
+        protected void PublishImageCaptured(ImageCapturedEventArgs args)
+        {
+            _eventAggregator.GetEvent<ImageCapturedEvent>().Publish(args);
+        }
+
+        /// <summary>
+        /// 发布校正完成事件 | Publish correction completed event
+        /// </summary>
+        /// <param name="type">校正类型 | Correction type</param>
+        /// <param name="result">校正结果 | Correction result</param>
+        protected void PublishCorrectionCompleted(CorrectionType type, DetectorResult result)
+        {
+            _eventAggregator.GetEvent<CorrectionCompletedEvent>().Publish(
+                new CorrectionCompletedEventArgs(type, result));
+        }
+
+        // IDisposable 实现 | IDisposable implementation
+        public void Dispose()
+        {
+            Dispose(true);
+            GC.SuppressFinalize(this);
+        }
+
+        /// <summary>
+        /// 释放资源 | Dispose resources
+        /// </summary>
+        /// <param name="disposing">是否释放托管资源 | Whether to dispose managed resources</param>
+        protected virtual void Dispose(bool disposing)
+        {
+            if (!_disposed)
+            {
+                if (disposing)
+                {
+                    // 释放托管资源 | Release managed resources
+                }
+                // 释放非托管资源 | Release unmanaged resources
+                _disposed = true;
+            }
+        }
+    }
+}

XP.Hardware.Detector/Abstractions/DetectorInfo.cs

@@ -0,0 +1,51 @@
+using XP.Hardware.Detector.Abstractions.Enums;
+
+namespace XP.Hardware.Detector.Abstractions
+{
+    /// <summary>
+    /// 探测器信息 | Detector information
+    /// 包含探测器的硬件参数和配置信息
+    /// </summary>
+    public class DetectorInfo
+    {
+        /// <summary>
+        /// 探测器类型 | Detector type
+        /// </summary>
+        public DetectorType Type { get; set; }
+
+        /// <summary>
+        /// 探测器型号 | Detector model
+        /// </summary>
+        public string Model { get; set; }
+
+        /// <summary>
+        /// 序列号 | Serial number
+        /// </summary>
+        public string SerialNumber { get; set; }
+
+        /// <summary>
+        /// 固件版本 | Firmware version
+        /// </summary>
+        public string FirmwareVersion { get; set; }
+
+        /// <summary>
+        /// 最大分辨率宽度 | Maximum resolution width
+        /// </summary>
+        public uint MaxWidth { get; set; }
+
+        /// <summary>
+        /// 最大分辨率高度 | Maximum resolution height
+        /// </summary>
+        public uint MaxHeight { get; set; }
+
+        /// <summary>
+        /// 像素尺寸（微米）| Pixel size (micrometers)
+        /// </summary>
+        public double PixelSize { get; set; }
+
+        /// <summary>
+        /// 位深度 | Bit depth
+        /// </summary>
+        public int BitDepth { get; set; }
+    }
+}

XP.Hardware.Detector/Abstractions/DetectorResult.cs

@@ -0,0 +1,102 @@
+using System;
+
+namespace XP.Hardware.Detector.Abstractions
+{
+    /// <summary>
+    /// 探测器操作结果封装 | Detector operation result wrapper
+    /// 统一封装成功/失败状态、数据和错误信息
+    /// </summary>
+    public class DetectorResult
+    {
+        /// <summary>
+        /// 操作是否成功 | Whether the operation succeeded
+        /// </summary>
+        public bool IsSuccess { get; }
+
+        /// <summary>
+        /// 错误消息 | Error message
+        /// </summary>
+        public string ErrorMessage { get; }
+
+        /// <summary>
+        /// 异常对象 | Exception object
+        /// </summary>
+        public Exception Exception { get; }
+
+        /// <summary>
+        /// 错误码 | Error code
+        /// </summary>
+        public int ErrorCode { get; }
+
+        protected DetectorResult(bool isSuccess, string errorMessage = null, Exception exception = null, int errorCode = 0)
+        {
+            IsSuccess = isSuccess;
+            ErrorMessage = errorMessage;
+            Exception = exception;
+            ErrorCode = errorCode;
+        }
+
+        /// <summary>
+        /// 创建成功结果 | Create success result
+        /// </summary>
+        /// <param name="message">成功消息 | Success message</param>
+        /// <returns>成功结果 | Success result</returns>
+        public static DetectorResult Success(string message = null)
+        {
+            return new DetectorResult(true, message);
+        }
+
+        /// <summary>
+        /// 创建失败结果 | Create failure result
+        /// </summary>
+        /// <param name="errorMessage">错误消息 | Error message</param>
+        /// <param name="exception">异常对象 | Exception object</param>
+        /// <param name="errorCode">错误码 | Error code</param>
+        /// <returns>失败结果 | Failure result</returns>
+        public static DetectorResult Failure(string errorMessage, Exception exception = null, int errorCode = -1)
+        {
+            return new DetectorResult(false, errorMessage, exception, errorCode);
+        }
+    }
+
+    /// <summary>
+    /// 带数据的探测器操作结果 | Detector operation result with data
+    /// </summary>
+    /// <typeparam name="T">数据类型 | Data type</typeparam>
+    public class DetectorResult<T> : DetectorResult
+    {
+        /// <summary>
+        /// 结果数据 | Result data
+        /// </summary>
+        public T Data { get; }
+
+        private DetectorResult(bool isSuccess, T data, string errorMessage = null, Exception exception = null, int errorCode = 0)
+            : base(isSuccess, errorMessage, exception, errorCode)
+        {
+            Data = data;
+        }
+
+        /// <summary>
+        /// 创建成功结果 | Create success result
+        /// </summary>
+        /// <param name="data">结果数据 | Result data</param>
+        /// <param name="message">成功消息 | Success message</param>
+        /// <returns>成功结果 | Success result</returns>
+        public static DetectorResult<T> Success(T data, string message = null)
+        {
+            return new DetectorResult<T>(true, data, message);
+        }
+
+        /// <summary>
+        /// 创建失败结果 | Create failure result
+        /// </summary>
+        /// <param name="errorMessage">错误消息 | Error message</param>
+        /// <param name="exception">异常对象 | Exception object</param>
+        /// <param name="errorCode">错误码 | Error code</param>
+        /// <returns>失败结果 | Failure result</returns>
+        public new static DetectorResult<T> Failure(string errorMessage, Exception exception = null, int errorCode = -1)
+        {
+            return new DetectorResult<T>(false, default(T), errorMessage, exception, errorCode);
+        }
+    }
+}

XP.Hardware.Detector/Abstractions/Enums/AcquisitionMode.cs

@@ -0,0 +1,19 @@
+namespace XP.Hardware.Detector.Abstractions.Enums
+{
+    /// <summary>
+    /// 采集模式枚举 | Acquisition mode enumeration
+    /// 定义图像采集的工作模式
+    /// </summary>
+    public enum AcquisitionMode
+    {
+        /// <summary>
+        /// 连续采集模式 | Continuous acquisition mode
+        /// </summary>
+        Continuous = 0,
+
+        /// <summary>
+        /// 单帧采集模式 | Single frame acquisition mode
+        /// </summary>
+        SingleFrame = 1
+    }
+}

XP.Hardware.Detector/Abstractions/Enums/BinningMode.cs

@@ -0,0 +1,24 @@
+namespace XP.Hardware.Detector.Abstractions.Enums
+{
+    /// <summary>
+    /// Binning 模式枚举 | Binning mode enumeration
+    /// 定义像素合并模式，用于提高信噪比或采集速度
+    /// </summary>
+    public enum BinningMode
+    {
+        /// <summary>
+        /// 1x1 模式（无合并）| 1x1 mode (no binning)
+        /// </summary>
+        Bin1x1 = 0,
+
+        /// <summary>
+        /// 2x2 模式（2x2 像素合并）| 2x2 mode (2x2 pixel binning)
+        /// </summary>
+        Bin2x2 = 1,
+
+        /// <summary>
+        /// 4x4 模式（4x4 像素合并）| 4x4 mode (4x4 pixel binning)
+        /// </summary>
+        Bin4x4 = 2
+    }
+}

XP.Hardware.Detector/Abstractions/Enums/CorrectionType.cs

@@ -0,0 +1,29 @@
+namespace XP.Hardware.Detector.Abstractions.Enums
+{
+    /// <summary>
+    /// 校正类型枚举 | Correction type enumeration
+    /// 定义探测器支持的校正类型
+    /// </summary>
+    public enum CorrectionType
+    {
+        /// <summary>
+        /// 暗场校正 | Dark field correction
+        /// </summary>
+        Dark = 0,
+
+        /// <summary>
+        /// 增益校正（亮场校正）| Gain correction (bright field correction)
+        /// </summary>
+        Gain = 1,
+
+        /// <summary>
+        /// 自动校正（暗场+增益+坏像素）| Auto correction (dark + gain + bad pixel)
+        /// </summary>
+        Auto = 2,
+
+        /// <summary>
+        /// 坏像素校正 | Bad pixel correction
+        /// </summary>
+        BadPixel = 3
+    }
+}

XP.Hardware.Detector/Abstractions/Enums/DetectorStatus.cs

@@ -0,0 +1,39 @@
+namespace XP.Hardware.Detector.Abstractions.Enums
+{
+    /// <summary>
+    /// 探测器状态枚举 | Detector status enumeration
+    /// 定义探测器的运行状态
+    /// </summary>
+    public enum DetectorStatus
+    {
+        /// <summary>
+        /// 未初始化 | Uninitialized
+        /// </summary>
+        Uninitialized = 0,
+
+        /// <summary>
+        /// 初始化中 | Initializing
+        /// </summary>
+        Initializing = 1,
+
+        /// <summary>
+        /// 就绪 | Ready
+        /// </summary>
+        Ready = 2,
+
+        /// <summary>
+        /// 采集中 | Acquiring
+        /// </summary>
+        Acquiring = 3,
+
+        /// <summary>
+        /// 校正中 | Correcting
+        /// </summary>
+        Correcting = 4,
+
+        /// <summary>
+        /// 错误 | Error
+        /// </summary>
+        Error = 5
+    }
+}

XP.Hardware.Detector/Abstractions/Enums/DetectorType.cs

@@ -0,0 +1,24 @@
+namespace XP.Hardware.Detector.Abstractions.Enums
+{
+    /// <summary>
+    /// 探测器类型枚举 | Detector type enumeration
+    /// 定义支持的探测器厂商类型
+    /// </summary>
+    public enum DetectorType
+    {
+        /// <summary>
+        /// Varex 探测器 | Varex detector
+        /// </summary>
+        Varex = 0,
+
+        /// <summary>
+        /// iRay 探测器 | iRay detector （预留）
+        /// </summary>
+        IRay = 1,
+
+        /// <summary>
+        /// Hamamatsu 探测器 | Hamamatsu detector （预留）
+        /// </summary>
+        Hamamatsu = 2
+    }
+}

XP.Hardware.Detector/Abstractions/Enums/GainMode.cs

@@ -0,0 +1,19 @@
+namespace XP.Hardware.Detector.Abstractions.Enums
+{
+    /// <summary>
+    /// 增益模式枚举 | Gain mode enumeration
+    /// 定义探测器的信号放大倍数
+    /// </summary>
+    public enum GainMode
+    {
+        /// <summary>
+        /// 低增益模式 | Low gain mode
+        /// </summary>
+        Low = 0,
+
+        /// <summary>
+        /// 高增益模式 | High gain mode
+        /// </summary>
+        High = 1
+    }
+}

XP.Hardware.Detector/Abstractions/Events/CorrectionCompletedEvent.cs

@@ -0,0 +1,14 @@
+using Prism.Events;
+using XP.Hardware.Detector.Abstractions;
+
+namespace XP.Hardware.Detector.Abstractions.Events
+{
+    /// <summary>
+    /// 校正完成事件 | Correction completed event
+    /// 当探测器校正操作完成时触发
+    /// 线程安全：使用 Prism EventAggregator 确保线程安全的发布和订阅
+    /// </summary>
+    public class CorrectionCompletedEvent : PubSubEvent<CorrectionCompletedEventArgs>
+    {
+    }
+}

XP.Hardware.Detector/Abstractions/Events/CorrectionCompletedEventArgs.cs

@@ -0,0 +1,33 @@
+using System;
+using XP.Hardware.Detector.Abstractions.Enums;
+
+namespace XP.Hardware.Detector.Abstractions
+{
+    /// <summary>
+    /// 校正完成事件参数 | Correction completed event arguments
+    /// 携带校正类型和结果信息
+    /// </summary>
+    public class CorrectionCompletedEventArgs : EventArgs
+    {
+        /// <summary>
+        /// 校正类型 | Correction type
+        /// </summary>
+        public CorrectionType Type { get; set; }
+
+        /// <summary>
+        /// 校正结果 | Correction result
+        /// </summary>
+        public DetectorResult Result { get; set; }
+
+        /// <summary>
+        /// 构造函数 | Constructor
+        /// </summary>
+        /// <param name="type">校正类型 | Correction type</param>
+        /// <param name="result">校正结果 | Correction result</param>
+        public CorrectionCompletedEventArgs(CorrectionType type, DetectorResult result)
+        {
+            Type = type;
+            Result = result;
+        }
+    }
+}

XP.Hardware.Detector/Abstractions/Events/ErrorOccurredEvent.cs

@@ -0,0 +1,14 @@
+using Prism.Events;
+using XP.Hardware.Detector.Abstractions;
+
+namespace XP.Hardware.Detector.Abstractions.Events
+{
+    /// <summary>
+    /// 错误发生事件 | Error occurred event
+    /// 当探测器操作发生错误时触发
+    /// 线程安全：使用 Prism EventAggregator 确保线程安全的发布和订阅
+    /// </summary>
+    public class ErrorOccurredEvent : PubSubEvent<DetectorResult>
+    {
+    }
+}

XP.Hardware.Detector/Abstractions/Events/ImageCapturedEvent.cs

@@ -0,0 +1,14 @@
+using Prism.Events;
+using XP.Hardware.Detector.Abstractions;
+
+namespace XP.Hardware.Detector.Abstractions.Events
+{
+    /// <summary>
+    /// 图像采集事件 | Image captured event
+    /// 当探测器采集到新图像时触发
+    /// 线程安全：使用 Prism EventAggregator 确保线程安全的发布和订阅
+    /// </summary>
+    public class ImageCapturedEvent : PubSubEvent<ImageCapturedEventArgs>
+    {
+    }
+}

XP.Hardware.Detector/Abstractions/Events/ImageCapturedEventArgs.cs

@@ -0,0 +1,46 @@
+using System;
+
+namespace XP.Hardware.Detector.Abstractions
+{
+    /// <summary>
+    /// 图像采集事件参数 | Image captured event arguments
+    /// 携带图像数据和元信息
+    /// </summary>
+    public class ImageCapturedEventArgs : EventArgs
+    {
+        /// <summary>
+        /// 16 位图像原始数据（无符号）| 16-bit raw image data (unsigned)
+        /// </summary>
+        public ushort[] ImageData { get; set; }
+
+        /// <summary>
+        /// 图像宽度 | Image width
+        /// </summary>
+        public uint Width { get; set; }
+
+        /// <summary>
+        /// 图像高度 | Image height
+        /// </summary>
+        public uint Height { get; set; }
+
+        /// <summary>
+        /// 帧号 | Frame number
+        /// </summary>
+        public int FrameNumber { get; set; }
+
+        /// <summary>
+        /// 存储路径 | Save path
+        /// </summary>
+        public string SavePath { get; set; }
+
+        /// <summary>
+        /// 曝光时间（毫秒）| Exposure time (milliseconds)
+        /// </summary>
+        public uint ExposureTime { get; set; }
+
+        /// <summary>
+        /// 采集时间戳 | Capture timestamp
+        /// </summary>
+        public DateTime CaptureTime { get; set; }
+    }
+}

XP.Hardware.Detector/Abstractions/Events/StatusChangedEvent.cs

@@ -0,0 +1,14 @@
+using Prism.Events;
+using XP.Hardware.Detector.Abstractions.Enums;
+
+namespace XP.Hardware.Detector.Abstractions.Events
+{
+    /// <summary>
+    /// 状态变更事件 | Status changed event
+    /// 当探测器状态发生变化时触发
+    /// 线程安全：使用 Prism EventAggregator 确保线程安全的发布和订阅
+    /// </summary>
+    public class StatusChangedEvent : PubSubEvent<DetectorStatus>
+    {
+    }
+}