NetworkTool/windows/NetworkTool.Client/DeviceDetailsWindow.xaml.cs

using System.Globalization;
using System.Collections.ObjectModel;
using System.ComponentModel;
using System.Runtime.CompilerServices;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Animation;
using NetworkTool.Client.Models;
using NetworkTool.Client.Services;

namespace NetworkTool.Client;

public partial class DeviceDetailsWindow : Window
{
    private const int ApplyConfirmationTimeoutSeconds = 20;
    private readonly ServerApiService _serverApiService = new();
    private readonly ObservableCollection<EditableAddress> _addresses = [];
    private readonly ObservableCollection<EditableRoute> _routes = [];
    private readonly ObservableCollection<EditableDns> _dns = [];
    private readonly string _baseAddress;
    private readonly string _localIPv4;
    private readonly string _password;
    private bool _configValidated;
    private bool _configDirty;
    private bool _isBusy;
    private bool _isRestoringInterfaceSelection;
    private bool _suppressConfigChangeHandling;
    private RemoteInterfaceInfo? _currentSelectedInterface;
    private CancellationTokenSource? _statusMessageCts;

    public DeviceDetailsWindow(string baseAddress, string localIPv4, string password)
    {
        InitializeComponent();
        AddressesDataGrid.ItemsSource = _addresses;
        RoutesDataGrid.ItemsSource = _routes;
        DnsDataGrid.ItemsSource = _dns;
        _baseAddress = baseAddress;
        _localIPv4 = localIPv4;
        _password = password;
        Loaded += DeviceDetailsWindow_OnLoaded;
    }

    private async void DeviceDetailsWindow_OnLoaded(object sender, RoutedEventArgs e)
    {
        try
        {
            await LoadRemoteDetailsAsync();
            UpdateButtonStates();
        }
        catch (Exception ex)
        {
            ShowStatusMessage($"读取设备信息失败：{ex.Message}");
            SetBusyState(false);
        }
    }

    private async Task LoadRemoteDetailsAsync()
    {
        ClearDetails();
        var device = await _serverApiService.GetDeviceInfoAsync(_baseAddress, _password, _localIPv4);
        if (device is not null)
        {
            RemoteDeviceIdTextBlock.Text = device.DeviceId;
            RemoteHostnameTextBlock.Text = device.Hostname;
            RemoteOsVersionTextBlock.Text = device.OSVersion;
            RemoteServerVersionTextBlock.Text = device.ServerVersion;
        }

        var interfaces = await _serverApiService.GetInterfacesAsync(_baseAddress, _password, _localIPv4);
        if (interfaces is null)
        {
            ShowStatusMessage("设备已连接，但暂时无法读取 Linux 接口列表。");
            return;
        }

        ShowStatusMessage($"当前管理接口：{interfaces.ManagementInterface}。请选择需要配置的目标接口。");
        var suggested = interfaces.Interfaces.FirstOrDefault(item => item.SystemName == interfaces.SuggestedTargetInterface)
            ?? interfaces.Interfaces.FirstOrDefault(item => item.IsSuggestedTarget)
            ?? interfaces.Interfaces.FirstOrDefault(item => !item.IsManagementInterface);
        RemoteTargetInterfaceTabControl.ItemsSource = interfaces.Interfaces;
        if (suggested is not null)
        {
            RemoteTargetInterfaceTabControl.SelectedItem = suggested;
            await LoadRemoteInterfaceConfigAsync(suggested.SystemName);
            _currentSelectedInterface = suggested;
        }
    }

    private void ClearDetails()
    {
        RemoteDeviceIdTextBlock.Text = "-";
        RemoteHostnameTextBlock.Text = "-";
        RemoteOsVersionTextBlock.Text = "-";
        RemoteServerVersionTextBlock.Text = "-";
        RemoteTargetInterfaceTabControl.ItemsSource = null;
        _addresses.Clear();
        _routes.Clear();
        _dns.Clear();
        DefaultGatewayCheckBox.IsChecked = false;
        DefaultGatewayTextBox.Text = string.Empty;
        CustomRoutesCheckBox.IsChecked = false;
        _configValidated = false;
        _configDirty = false;
        _currentSelectedInterface = null;
    }

    private async void RemoteTargetInterfaceTabControl_OnSelectionChanged(object sender, SelectionChangedEventArgs e)
    {
        try
        {
            if (RemoteTargetInterfaceTabControl.SelectedItem is not RemoteInterfaceInfo selected)
            {
                UpdateButtonStates();
                return;
            }

            if (_isRestoringInterfaceSelection)
            {
                return;
            }

            if (_configDirty && _currentSelectedInterface is not null && selected.SystemName != _currentSelectedInterface.SystemName)
            {
                var result = MessageBox.Show(
                    this,
                    "当前配置已修改，切换接口会丢失未应用内容。是否继续？",
                    "确认切换接口",
                    MessageBoxButton.OKCancel,
                    MessageBoxImage.Warning);
                if (result != MessageBoxResult.OK)
                {
                    _isRestoringInterfaceSelection = true;
                    RemoteTargetInterfaceTabControl.SelectedItem = _currentSelectedInterface;
                    _isRestoringInterfaceSelection = false;
                    return;
                }
            }

            await LoadRemoteInterfaceConfigAsync(selected.SystemName, useBusyState: true);
            _currentSelectedInterface = selected;
        }
        catch (Exception ex)
        {
            ShowStatusMessage($"读取目标接口配置失败：{ex.Message}");
            SetBusyState(false);
        }
    }

    private async Task LoadRemoteInterfaceConfigAsync(string interfaceName, bool useBusyState = false)
    {
        if (useBusyState)
        {
            SetBusyState(true, "正在读取 Linux 端 IP 配置...");
        }

        try
        {
            var result = await _serverApiService.GetInterfaceConfigAsync(_baseAddress, _password, _localIPv4, interfaceName);
            if (!result.Success || result.Data is null)
            {
                ShowStatusMessage($"读取目标接口 {interfaceName} 配置失败：{result.Message}");
                return;
            }

            var config = result.Data;
            _suppressConfigChangeHandling = true;
            Dhcp4CheckBox.IsChecked = false;
            _addresses.Clear();
            foreach (var address in config.EffectiveAddresses)
            {
                _addresses.Add(new EditableAddress { IP = address.IP, Mask = PrefixToMask(address.Prefix) });
            }
            _routes.Clear();
            DefaultGatewayCheckBox.IsChecked = false;
            DefaultGatewayTextBox.Text = string.Empty;
            foreach (var route in config.EffectiveRoutes)
            {
                if (route.To.Equals("default", StringComparison.OrdinalIgnoreCase))
                {
                    DefaultGatewayCheckBox.IsChecked = true;
                    DefaultGatewayTextBox.Text = route.Via;
                }
                else
                {
                    _routes.Add(new EditableRoute { To = route.To, Via = route.Via });
                }
            }
            CustomRoutesCheckBox.IsChecked = _routes.Count > 0;
            _dns.Clear();
            if (config.Dns is not null)
            {
                foreach (var dns in config.Dns)
                {
                    _dns.Add(new EditableDns { Address = dns });
                }
            }
            _suppressConfigChangeHandling = false;
            _configValidated = false;
            _configDirty = false;
            ShowStatusMessage("已读取Linux端IP配置。");
            UpdateButtonStates();
        }
        finally
        {
            if (useBusyState)
            {
                SetBusyState(false);
            }
        }
    }

    private async void ReloadInterfaceConfigButton_OnClick(object sender, RoutedEventArgs e)
    {
        if (RemoteTargetInterfaceTabControl.SelectedItem is RemoteInterfaceInfo selected)
        {
            await LoadRemoteInterfaceConfigAsync(selected.SystemName);
        }
    }

    private async void ValidateConfigButton_OnClick(object sender, RoutedEventArgs e)
    {
        if (RemoteTargetInterfaceTabControl.SelectedItem is not RemoteInterfaceInfo selected)
        {
            return;
        }

        var request = BuildConfigRequest(selected.SystemName);
        if (request is null)
        {
            return;
        }

        SetBusyState(true, "正在校验配置，请稍候...");
        try
        {
            var result = await _serverApiService.ValidateInterfaceConfigAsync(_baseAddress, _password, _localIPv4, request);
            _configValidated = result.Success && result.Data?.Valid == true;
            if (result.Data is not null)
            {
                var warnings = result.Data.Warnings.Count > 0 ? $" 警告：{string.Join("；", result.Data.Warnings)}" : string.Empty;
                var errors = result.Data.Errors.Count > 0 ? $" 错误：{string.Join("；", result.Data.Errors)}" : string.Empty;
                ShowStatusMessage(_configValidated ? $"校验通过，可应用配置。{warnings}" : $"校验失败。{errors}{warnings}");
            }
            else
            {
                ShowStatusMessage($"校验失败：{result.Message}");
            }

            UpdateButtonStates();
        }
        finally
        {
            SetBusyState(false);
        }
    }

    private async void ApplyConfigButton_OnClick(object sender, RoutedEventArgs e)
    {
        if (RemoteTargetInterfaceTabControl.SelectedItem is not RemoteInterfaceInfo selected)
        {
            return;
        }

        var request = BuildConfigRequest(selected.SystemName);
        if (request is null)
        {
            return;
        }

        var confirmMessage = $"将要把以下配置应用到接口 {selected.SystemName}：\n\n" +
                             $"模式：{(request.Dhcp4 ? "DHCP 自动获取" : "静态 IPv4")}\n" +
                              $"IP：{(request.Dhcp4 ? "自动获取" : FormatAddresses(request.Addresses))}\n" +
                              $"路由：{(request.Dhcp4 ? "自动获取" : FormatRoutes(request.Routes))}\n" +
                             $"DNS：{(request.Dns.Count == 0 ? "无" : string.Join(", ", request.Dns))}\n\n" +
                             "请确认是否继续。";
        if (MessageBox.Show(this, confirmMessage, "确认应用配置", MessageBoxButton.OKCancel, MessageBoxImage.Question) != MessageBoxResult.OK)
        {
            return;
        }

        SetBusyState(true, "正在提交并应用配置，请稍候...");
        try
        {
            var applyResult = await _serverApiService.ApplyInterfaceConfigAsync(_baseAddress, _password, _localIPv4, request);
            if (!applyResult.Success || applyResult.Data is null)
            {
                ShowStatusMessage($"提交配置任务失败：{applyResult.Message}");
                return;
            }

            ShowStatusMessage("配置任务已提交，正在应用并等待连通确认...");
            await PollTaskAsync(applyResult.Data.TaskId);
        }
        finally
        {
            SetBusyState(false);
        }
    }

    private async Task PollTaskAsync(string taskId)
    {
        var transientFailureCount = 0;
        var confirmationRequested = false;
        for (var i = 0; i < 20; i++)
        {
            await Task.Delay(1000);
            var result = await _serverApiService.GetTaskAsync(_baseAddress, _password, _localIPv4, taskId);
            if (!result.Success || result.Data is null)
            {
                if (result.StatusCode is null)
                {
                    transientFailureCount++;
                    ShowStatusMessage($"设备连接短暂中断，正在重试（{transientFailureCount}）。");
                    continue;
                }

                ShowStatusMessage($"读取任务状态失败：{result.Message}");
                return;
            }

            transientFailureCount = 0;
            var task = result.Data;
            ShowStatusMessage(FormatTaskStatusMessage(task));
            if (task.Status == "running" && task.Step == "confirming" && !confirmationRequested)
            {
                confirmationRequested = true;
                var confirm = ShowApplyConfirmationDialog(ApplyConfirmationTimeoutSeconds);
                if (confirm)
                {
                    var confirmResult = await _serverApiService.ConfirmApplyTaskAsync(_baseAddress, _password, _localIPv4, taskId);
                    ShowStatusMessage(confirmResult.Success ? "已发送保留配置确认。" : $"发送确认失败：{confirmResult.Message}");
                }
                else
                {
                    var cancelResult = await _serverApiService.CancelApplyTaskAsync(_baseAddress, _password, _localIPv4, taskId);
                    ShowStatusMessage(cancelResult.Success ? "已取消保留配置，正在回滚。" : $"发送取消失败：{cancelResult.Message}");
                }
            }

            if (task.Status is "success" or "failed" or "rolled_back")
            {
                ShowTaskCompletionDialog(task);
                if (RemoteTargetInterfaceTabControl.SelectedItem is RemoteInterfaceInfo selected)
                {
                    await LoadRemoteInterfaceConfigAsync(selected.SystemName);
                }

                return;
            }
        }

        ShowStatusMessage($"任务 {taskId} 轮询超时，请稍后手动刷新。");
    }

    private bool ShowApplyConfirmationDialog(int timeoutSeconds)
    {
        var remaining = timeoutSeconds;
        var result = false;
        var messageTextBlock = new TextBlock
        {
            Width = 420,
            TextWrapping = TextWrapping.Wrap,
            FontSize = 13,
            Foreground = Brushes.Black,
        };
        var confirmButton = new Button
        {
            MinWidth = 88,
            MinHeight = 32,
            Margin = new Thickness(0, 0, 10, 0),
            Content = "确认保留",
            IsDefault = true,
        };
        var cancelButton = new Button
        {
            MinWidth = 88,
            MinHeight = 32,
            Content = "取消回滚",
            IsCancel = true,
        };
        var dialog = new Window
        {
            Title = "确认保留网络配置",
            Owner = this,
            WindowStartupLocation = WindowStartupLocation.CenterOwner,
            ResizeMode = ResizeMode.NoResize,
            SizeToContent = SizeToContent.WidthAndHeight,
            Content = new StackPanel
            {
                Margin = new Thickness(18),
                Children =
                {
                    messageTextBlock,
                    new StackPanel
                    {
                        Margin = new Thickness(0, 18, 0, 0),
                        HorizontalAlignment = HorizontalAlignment.Right,
                        Orientation = Orientation.Horizontal,
                        Children = { confirmButton, cancelButton },
                    },
                },
            },
        };

        void UpdateMessage()
        {
            messageTextBlock.Text = $"当前客户端仍可连接到设备。是否确认保留这次网络配置？\n\n剩余 {remaining} 秒；超时或取消时，Linux 端会自动回滚。";
        }

        var timer = new System.Windows.Threading.DispatcherTimer { Interval = TimeSpan.FromSeconds(1) };
        timer.Tick += (_, _) =>
        {
            remaining--;
            if (remaining <= 0)
            {
                timer.Stop();
                dialog.DialogResult = false;
                dialog.Close();
                return;
            }
            UpdateMessage();
        };
        confirmButton.Click += (_, _) =>
        {
            result = true;
            dialog.DialogResult = true;
            dialog.Close();
        };
        cancelButton.Click += (_, _) =>
        {
            dialog.DialogResult = false;
            dialog.Close();
        };
        dialog.Closed += (_, _) => timer.Stop();

        UpdateMessage();
        timer.Start();
        dialog.ShowDialog();
        return result;
    }

    private async void RebootButton_OnClick(object sender, RoutedEventArgs e)
    {
        await ExecuteSystemActionAsync(
            "重启设备",
            "设备将立即重启，当前窗口和连接可能马上中断。是否继续？",
            () => _serverApiService.RebootAsync(_baseAddress, _password, _localIPv4));
    }

    private async void ShutdownButton_OnClick(object sender, RoutedEventArgs e)
    {
        await ExecuteSystemActionAsync(
            "关闭设备",
            "设备将立即关机，当前窗口和连接可能马上中断。是否继续？",
            () => _serverApiService.ShutdownAsync(_baseAddress, _password, _localIPv4));
    }

    private async Task ExecuteSystemActionAsync(string title, string confirmMessage, Func<Task<ApiCallResult<RemoteSystemActionResponse>>> action)
    {
        if (MessageBox.Show(this, confirmMessage, title, MessageBoxButton.OKCancel, MessageBoxImage.Warning) != MessageBoxResult.OK)
        {
            return;
        }

        var result = await action();
        if (!result.Success || result.Data is null)
        {
            ShowStatusMessage($"{title}失败：{result.Message}");
            return;
        }

        ShowStatusMessage($"{title}任务已提交：{result.Data.TaskId}。命令已发出，设备可能立即断开。");
    }

    private RemoteInterfaceConfig? BuildConfigRequest(string interfaceName)
    {
        CommitConfigEdits();
        var dhcp4 = Dhcp4CheckBox.IsChecked == true;
        var addresses = Array.Empty<RemoteInterfaceAddressConfig>();
        var routes = Array.Empty<RemoteInterfaceRouteConfig>();
        if (!dhcp4)
        {
            if (_addresses.All(item => string.IsNullOrWhiteSpace(item.IP) && string.IsNullOrWhiteSpace(item.Mask)))
            {
                ShowStatusMessage("IP 地址不能为空，至少需要填写一行地址。");
                return null;
            }

            if (!TryBuildAddresses(out addresses, out var addressError))
            {
                ShowStatusMessage(addressError);
                return null;
            }

            if (!TryBuildRoutes(out routes, out var routeError))
            {
                ShowStatusMessage(routeError);
                return null;
            }
        }

        var dns = _dns.Select(item => item.Address.Trim()).Where(item => item != string.Empty).ToArray();
        return new RemoteInterfaceConfig
        {
            Interface = interfaceName,
            Dhcp4 = dhcp4,
            Addresses = dhcp4 ? Array.Empty<RemoteInterfaceAddressConfig>() : addresses,
            Routes = dhcp4 ? Array.Empty<RemoteInterfaceRouteConfig>() : routes,
            Dns = dhcp4 ? Array.Empty<string>() : dns,
        };
    }

    private void CommitConfigEdits()
    {
        AddressesDataGrid.CommitEdit(DataGridEditingUnit.Cell, true);
        AddressesDataGrid.CommitEdit(DataGridEditingUnit.Row, true);
        RoutesDataGrid.CommitEdit(DataGridEditingUnit.Cell, true);
        RoutesDataGrid.CommitEdit(DataGridEditingUnit.Row, true);
        DnsDataGrid.CommitEdit(DataGridEditingUnit.Cell, true);
        DnsDataGrid.CommitEdit(DataGridEditingUnit.Row, true);
    }

    private static string FormatCurrentIp(RemoteInterfaceConfig config)
    {
        if (config.EffectiveAddresses.Count == 0)
        {
            return config.Dhcp4 ? "DHCP 自动获取，暂无 IPv4" : "无";
        }

        var text = FormatAddresses(config.EffectiveAddresses);
        return config.Dhcp4 ? $"{text} (DHCP)" : text;
    }

    private static string FormatAddresses(IReadOnlyList<RemoteInterfaceAddressConfig> addresses)
    {
        return addresses.Count == 0 ? "无" : string.Join(Environment.NewLine, addresses.Select(item => $"{item.IP}/{item.Prefix}"));
    }

    private static string FormatRoutes(IReadOnlyList<RemoteInterfaceRouteConfig> routes)
    {
        return routes.Count == 0 ? "无" : string.Join(Environment.NewLine, routes.Select(item => $"{item.To} via {item.Via}"));
    }

    private bool TryBuildAddresses(out RemoteInterfaceAddressConfig[] addresses, out string error)
    {
        var result = new List<RemoteInterfaceAddressConfig>();
        foreach (var row in _addresses)
        {
            var ip = row.IP.Trim();
            var maskText = row.Mask.Trim();
            if (ip == string.Empty && maskText == string.Empty)
            {
                continue;
            }
            if (ip.Contains('/'))
            {
                var parts = ip.Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
                if (parts.Length != 2 || !int.TryParse(parts[1], out var cidrPrefix) || cidrPrefix < 0 || cidrPrefix > 32)
                {
                    addresses = [];
                    error = $"地址格式不正确：{ip}";
                    return false;
                }
                row.IP = parts[0];
                row.Mask = PrefixToMask(cidrPrefix);
                result.Add(new RemoteInterfaceAddressConfig { IP = parts[0], Prefix = cidrPrefix });
                continue;
            }
            if (ip == string.Empty || maskText == string.Empty)
            {
                addresses = [];
                error = "IP 地址和子网掩码都需要填写。";
                return false;
            }
            if (!TryMaskOrPrefixToPrefix(maskText, out var prefix))
            {
                addresses = [];
                error = $"子网掩码格式不正确：{ip} {maskText}";
                return false;
            }
            row.Mask = PrefixToMask(prefix);
            result.Add(new RemoteInterfaceAddressConfig { IP = ip, Prefix = prefix });
        }

        addresses = result.ToArray();
        error = string.Empty;
        return addresses.Length > 0;
    }

    private bool TryBuildRoutes(out RemoteInterfaceRouteConfig[] routes, out string error)
    {
        var result = new List<RemoteInterfaceRouteConfig>();
        if (DefaultGatewayCheckBox.IsChecked == true)
        {
            var gateway = DefaultGatewayTextBox.Text.Trim();
            if (gateway == string.Empty)
            {
                routes = [];
                error = "启用默认网关时，网关地址不能为空。";
                return false;
            }
            result.Add(new RemoteInterfaceRouteConfig { To = "default", Via = gateway });
        }
        if (CustomRoutesCheckBox.IsChecked == true)
        {
            foreach (var row in _routes)
            {
                var to = row.To.Trim();
                var via = row.Via.Trim();
                if (to == string.Empty && via == string.Empty)
                {
                    continue;
                }
                if (to == string.Empty || via == string.Empty)
                {
                    routes = [];
                    error = "自定义路由的目标网段和网关地址都需要填写。";
                    return false;
                }
                result.Add(new RemoteInterfaceRouteConfig { To = to, Via = via });
            }
        }

        routes = result.ToArray();
        error = string.Empty;
        return true;
    }

    private static bool TryParseAddresses(string text, out RemoteInterfaceAddressConfig[] addresses, out string error)
    {
        var result = new List<RemoteInterfaceAddressConfig>();
        foreach (var line in ParseListText(text))
        {
            var parts = line.Split(' ', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
            if (parts.Length == 1 && line.Contains('/'))
            {
                var cidrParts = line.Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
                if (cidrParts.Length != 2 || !int.TryParse(cidrParts[1], out var prefix) || prefix < 0 || prefix > 32)
                {
                    addresses = [];
                    error = $"地址格式不正确：{line}";
                    return false;
                }
                result.Add(new RemoteInterfaceAddressConfig { IP = cidrParts[0], Prefix = prefix });
                continue;
            }

            if (parts.Length != 2)
            {
                addresses = [];
                error = $"地址格式不正确：{line}";
                return false;
            }
            if (!TryMaskOrPrefixToPrefix(parts[1], out var parsedPrefix))
            {
                addresses = [];
                error = $"子网掩码或前缀格式不正确：{line}";
                return false;
            }
            result.Add(new RemoteInterfaceAddressConfig { IP = parts[0], Prefix = parsedPrefix });
        }

        addresses = result.ToArray();
        error = string.Empty;
        return addresses.Length > 0;
    }

    private static bool TryParseRoutes(string text, out RemoteInterfaceRouteConfig[] routes, out string error)
    {
        var result = new List<RemoteInterfaceRouteConfig>();
        foreach (var line in ParseListText(text))
        {
            var parts = line.Split(' ', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
            if (parts.Length == 1)
            {
                result.Add(new RemoteInterfaceRouteConfig { To = "default", Via = parts[0] });
                continue;
            }
            if (parts.Length == 3 && parts[1].Equals("via", StringComparison.OrdinalIgnoreCase))
            {
                result.Add(new RemoteInterfaceRouteConfig { To = parts[0], Via = parts[2] });
                continue;
            }

            routes = [];
            error = $"路由格式不正确：{line}";
            return false;
        }

        routes = result.ToArray();
        error = string.Empty;
        return true;
    }

    private static string[] ParseListText(string text)
    {
        return text.Split(['\r', '\n', ',', ';'], StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
    }

    private static bool TryMaskOrPrefixToPrefix(string text, out int prefix)
    {
        if (int.TryParse(text, out prefix) && prefix >= 0 && prefix <= 32)
        {
            return true;
        }
        return TryMaskToPrefix(text, out prefix);
    }

    private static string PrefixToMask(int prefix)
    {
        if (prefix < 0 || prefix > 32)
        {
            return string.Empty;
        }

        var mask = prefix == 0 ? 0u : uint.MaxValue << (32 - prefix);
        return string.Join('.', new[] { (mask >> 24) & 255, (mask >> 16) & 255, (mask >> 8) & 255, mask & 255 });
    }

    private static bool TryMaskToPrefix(string maskText, out int prefix)
    {
        prefix = 0;
        if (string.IsNullOrWhiteSpace(maskText))
        {
            return false;
        }

        var parts = maskText.Trim().Split('.');
        if (parts.Length != 4)
        {
            return false;
        }

        uint mask = 0;
        foreach (var part in parts)
        {
            if (!byte.TryParse(part, out var octet))
            {
                return false;
            }

            mask = (mask << 8) | octet;
        }

        var seenZero = false;
        for (var i = 31; i >= 0; i--)
        {
            var bit = (mask & (1u << i)) != 0;
            if (bit && seenZero)
            {
                return false;
            }

            if (bit)
            {
                prefix++;
            }
            else
            {
                seenZero = true;
            }
        }

        return true;
    }

    private void ConfigInputChanged_OnChanged(object sender, TextChangedEventArgs e)
    {
        if (_suppressConfigChangeHandling)
        {
            return;
        }

        _configValidated = false;
        ShowStatusMessage("配置内容已变更，请重新点击“2. 校验配置”。");
        UpdateButtonStates();
    }

    private void ConfigModeChanged_OnChanged(object sender, RoutedEventArgs e)
    {
        if (_suppressConfigChangeHandling)
        {
            UpdateButtonStates();
            return;
        }

        _configValidated = false;
        _configDirty = true;
        ShowStatusMessage("配置模式已变更，请重新点击“2. 校验配置”。");
        UpdateButtonStates();
    }

    private void GatewayOrRouteModeChanged_OnChanged(object sender, RoutedEventArgs e)
    {
        if (_suppressConfigChangeHandling)
        {
            UpdateButtonStates();
            return;
        }

        _configValidated = false;
        _configDirty = true;
        ShowStatusMessage("配置内容已变更，请重新点击“2. 校验配置”。");
        UpdateButtonStates();
    }

    private void ConfigGrid_OnCellEditEnding(object sender, DataGridCellEditEndingEventArgs e)
    {
        if (e.Row.Item is EditableAddress address)
        {
            NormalizeAddressRow(address);
        }
        MarkConfigChanged("配置内容已变更，请重新点击“2. 校验配置”。");
    }

    private void AddAddressButton_OnClick(object sender, RoutedEventArgs e)
    {
        _addresses.Add(new EditableAddress { Mask = "255.255.255.0" });
        MarkConfigChanged("已添加 IP 地址，请填写后重新校验配置。");
    }

    private void AddRouteButton_OnClick(object sender, RoutedEventArgs e)
    {
        _routes.Add(new EditableRoute());
        MarkConfigChanged("已添加路由，请填写后重新校验配置。");
    }

    private void AddDnsButton_OnClick(object sender, RoutedEventArgs e)
    {
        _dns.Add(new EditableDns());
        MarkConfigChanged("已添加 DNS，请填写后重新校验配置。");
    }

    private void DeleteAddressButton_OnClick(object sender, RoutedEventArgs e)
    {
        if ((sender as FrameworkElement)?.DataContext is not EditableAddress address)
        {
            return;
        }
        _addresses.Remove(address);
        MarkConfigChanged("已删除 IP 地址，请重新校验配置。");
    }

    private void DeleteRouteButton_OnClick(object sender, RoutedEventArgs e)
    {
        if ((sender as FrameworkElement)?.DataContext is EditableRoute route)
        {
            _routes.Remove(route);
            MarkConfigChanged("已删除路由，请重新校验配置。");
        }
    }

    private void DeleteDnsButton_OnClick(object sender, RoutedEventArgs e)
    {
        if ((sender as FrameworkElement)?.DataContext is EditableDns dns)
        {
            _dns.Remove(dns);
            MarkConfigChanged("已删除 DNS，请重新校验配置。");
        }
    }

    private void MarkConfigChanged(string message)
    {
        if (_suppressConfigChangeHandling)
        {
            return;
        }

        _configValidated = false;
        _configDirty = true;
        ShowStatusMessage(message);
        UpdateButtonStates();
    }

    private static void NormalizeAddressRow(EditableAddress row)
    {
        var ip = row.IP.Trim();
        if (!ip.Contains('/'))
        {
            return;
        }
        var parts = ip.Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
        if (parts.Length == 2 && int.TryParse(parts[1], out var prefix) && prefix >= 0 && prefix <= 32)
        {
            row.IP = parts[0];
            row.Mask = PrefixToMask(prefix);
        }
    }

    private void ShowStatusMessage(string message)
    {
        ApplyStatusMessageStyle(message);
        StatusMessageTextBlock.Text = message;
        StatusMessageBorder.Opacity = 0;
        StatusMessageBorder.Visibility = Visibility.Visible;
        StatusMessageBorder.BeginAnimation(OpacityProperty, new DoubleAnimation(1, TimeSpan.FromMilliseconds(160)));
        _statusMessageCts?.Cancel();
        _statusMessageCts = new CancellationTokenSource();
        _ = HideStatusMessageAsync(_statusMessageCts.Token);
    }

    private async Task HideStatusMessageAsync(CancellationToken cancellationToken)
    {
        try
        {
            await Task.Delay(3000, cancellationToken);
            await Dispatcher.InvokeAsync(() =>
            {
                var animation = new DoubleAnimation(0, TimeSpan.FromMilliseconds(200));
                animation.Completed += (_, _) =>
                {
                    if (!cancellationToken.IsCancellationRequested)
                    {
                        StatusMessageBorder.Visibility = Visibility.Collapsed;
                    }
                };
                StatusMessageBorder.BeginAnimation(OpacityProperty, animation);
            });
        }
        catch (TaskCanceledException)
        {
        }
    }

    private void ApplyStatusMessageStyle(string message)
    {
        var (background, foreground) = GetStatusMessageBrushes(message);
        StatusMessageBorder.Background = background;
        StatusMessageTextBlock.Foreground = foreground;
    }

    private static (Brush Background, Brush Foreground) GetStatusMessageBrushes(string message)
    {
        if (ContainsAny(message, "失败", "错误", "拒绝", "超时", "不能为空", "不正确", "无法"))
        {
            return (new SolidColorBrush((Color)ColorConverter.ConvertFromString("#B91C1C")), Brushes.White);
        }

        if (ContainsAny(message, "未发现", "请", "重试", "警告", "需要"))
        {
            return (new SolidColorBrush((Color)ColorConverter.ConvertFromString("#C2410C")), Brushes.White);
        }

        if (ContainsAny(message, "成功", "已切换", "已刷新", "已读取", "已加载", "已发现", "已提交", "已回填"))
        {
            return (new SolidColorBrush((Color)ColorConverter.ConvertFromString("#047857")), Brushes.White);
        }

        return (new SolidColorBrush((Color)ColorConverter.ConvertFromString("#111827")), Brushes.White);
    }

    private static bool ContainsAny(string message, params string[] markers)
    {
        return markers.Any(marker => message.Contains(marker, StringComparison.Ordinal));
    }

    private static string FormatTaskStatusMessage(RemoteTaskResult task)
    {
        return task.Status switch
        {
            "success" => string.IsNullOrWhiteSpace(task.Detail) ? "配置已成功应用。" : task.Detail,
            "failed" => string.IsNullOrWhiteSpace(task.Detail) ? "配置应用失败。" : task.Detail,
            "rolled_back" => string.IsNullOrWhiteSpace(task.Detail) ? "配置应用失败，已自动回滚。" : task.Detail,
            _ => task.Step switch
            {
                "validating" => "正在校验配置...",
                "writing_netplan" => "正在写入 Linux 网络配置...",
                "applying" => "正在应用 Linux 网络配置...",
                "confirming" => string.IsNullOrWhiteSpace(task.Detail) ? "等待确认保留配置..." : task.Detail,
                "rolling_back" => "配置应用失败，正在自动回滚...",
                _ => string.IsNullOrWhiteSpace(task.Detail) ? "正在处理，请稍候..." : task.Detail,
            }
        };
    }

    private void ShowTaskCompletionDialog(RemoteTaskResult task)
    {
        var message = FormatTaskStatusMessage(task);
        var title = task.Status == "success" ? "应用配置成功" : "应用配置失败";
        var image = task.Status == "success" ? MessageBoxImage.Information : MessageBoxImage.Warning;
        MessageBox.Show(this, message, title, MessageBoxButton.OK, image);
    }

    private void UpdateButtonStates()
    {
        var hasSelectedInterface = RemoteTargetInterfaceTabControl.SelectedItem is RemoteInterfaceInfo;
        var canEdit = !_isBusy && hasSelectedInterface;
        var canEditStatic = canEdit && Dhcp4CheckBox.IsChecked != true;
        var canEditGateway = canEditStatic && DefaultGatewayCheckBox.IsChecked == true;
        var canEditCustomRoutes = canEditStatic && CustomRoutesCheckBox.IsChecked == true;

        RemoteTargetInterfaceTabControl.IsEnabled = !_isBusy && RemoteTargetInterfaceTabControl.Items.Count > 0;
        ReloadInterfaceConfigButton.IsEnabled = canEdit;
        ValidateConfigButton.IsEnabled = canEdit;
        ApplyConfigButton.IsEnabled = !_isBusy && _configValidated && hasSelectedInterface;
        Dhcp4CheckBox.IsEnabled = canEdit;
        AddressesDataGrid.IsEnabled = canEditStatic;
        DefaultGatewayCheckBox.IsEnabled = canEditStatic;
        DefaultGatewayTextBox.IsEnabled = canEditGateway;
        CustomRoutesCheckBox.IsEnabled = canEditStatic;
        RoutesDataGrid.IsEnabled = canEditCustomRoutes;
        DnsDataGrid.IsEnabled = canEditStatic;
        AddAddressButton.IsEnabled = canEditStatic;
        AddRouteButton.IsEnabled = canEditCustomRoutes;
        AddDnsButton.IsEnabled = canEditStatic;
        RebootButton.IsEnabled = !_isBusy;
        ShutdownButton.IsEnabled = !_isBusy;
    }

    private void SetBusyState(bool isBusy, string? message = null)
    {
        _isBusy = isBusy;
        BusyOverlay.Visibility = isBusy ? Visibility.Visible : Visibility.Collapsed;
        BusyMessageTextBlock.Text = string.IsNullOrWhiteSpace(message) ? "正在处理，请稍候..." : message;
        UpdateButtonStates();
    }

    private sealed class EditableAddress : INotifyPropertyChanged
    {
        private string _ip = string.Empty;
        private string _mask = string.Empty;

        public string IP
        {
            get => _ip;
            set => SetField(ref _ip, value);
        }

        public string Mask
        {
            get => _mask;
            set => SetField(ref _mask, value);
        }

        public event PropertyChangedEventHandler? PropertyChanged;

        private void SetField<T>(ref T field, T value, [CallerMemberName] string propertyName = "")
        {
            if (EqualityComparer<T>.Default.Equals(field, value))
            {
                return;
            }
            field = value;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
        }
    }

    private sealed class EditableRoute
    {
        public string To { get; set; } = string.Empty;
        public string Via { get; set; } = string.Empty;
    }

    private sealed class EditableDns
    {
        public string Address { get; set; } = string.Empty;
    }
}