ConfigForm.cs

using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Drawing;
using System.IO;
using System.Runtime.InteropServices;
using System.Text;
using System.Windows.Forms;
using MoviePilot_V3.Services;

namespace MoviePilot_V3
{
    /// 配置参数对话框：优雅退出超时、Nginx 端口、后端端口、启动开关。
    /// 确定后直接写入 AppSettings.Current 并持久化到 config\app.ini。
    public class ConfigForm : Form
    {
        private NumericUpDown numTimeout;
        private NumericUpDown numNginxPort;
        private NumericUpDown numBackendPort;
        private NumericUpDown numMonitorSec;
        private ComboBox cmbRunVersion;
        private TextBox txtToken;
        private ComboBox cmbProxyType;
        private TextBox txtProxyHost;
        private NumericUpDown numProxyPort;
        private CheckBox chkPreventSleep;
        private CheckBox chkDebugLog;
        private CheckBox chkAutoUpdate;
        private CheckBox chkForceUpdate;
        private CheckBox chkAutoStart;
        private CheckBox chkTrayStart;
        private Button btnOK;
        private Button btnCancel;
        private Button btnCheckUpdate;
        private Button btnFixConflict;
        private Icon windowIcon; // 窗口图标：Form.Icon 不会自动释放，Dispose 时显式释放（防 GDI 句柄泄漏）

        /// 点击"检查MP更新"时为 true（配置已保存，调用方据此执行检查更新与确认升级流程）
        public bool CheckUpdateRequested { get; private set; }

        /// 点击"修复运行环境"时为 true（配置已保存，调用方据此触发运行环境修复流程）
        public bool FixConflictRequested { get; private set; }

        public ConfigForm()
        {
            InitializeForm();
            LoadCurrentSettings();
        }

        /// 释放窗口图标：配置窗口每次打开都会新建图标（AppConfig.GetAppIcon），
        /// Form.Icon 属性不会自动释放，不显式释放会随开关配置窗口反复泄漏 GDI 句柄。
        protected override void Dispose(bool disposing)
        {
            if (disposing && windowIcon != null)
            {
                windowIcon.Dispose();
                windowIcon = null;
            }
            base.Dispose(disposing);
        }

        /// 兜底修正：居中已由 CreateParams 在窗口创建时完成（窗口由 CreateWindowEx 直接创建在最终位置），
        /// 这里只在位置偏离目标时修正（例如 AutoScale 改变了窗体尺寸）。
        /// 偏差 ≤2px 时不做任何移动——无谓的 SetWindowPos 会让合成层（WS_EX_COMPOSITED）窗口
        /// 重新出现一次位置跳变。
        protected override void OnLoad(EventArgs e)
        {
            base.OnLoad(e);
            Rectangle area = Owner != null ? Owner.Bounds : Screen.PrimaryScreen.WorkingArea;
            Point want = new Point(
                area.Left + Math.Max(0, (area.Width - Width) / 2),
                area.Top + Math.Max(0, (area.Height - Height) / 2));
            if (Math.Abs(Location.X - want.X) > 2 || Math.Abs(Location.Y - want.Y) > 2)
            {
                Location = want;
            }
        }

        /// <summary>
        /// 首帧补绘：窗口"已可见、客户区却还没画"的中间态。
        /// 实测（原生消息时序，去掉截屏干扰）：ShowWindow 使窗口可见后，首个 WM_PAINT 原本要等
        /// 消息泵下一轮才被投递（本机实测"可见→首绘"空窗约 7ms）；这段时间里 DWM 可能先把未绘制
        /// 的客户区合成上屏，表现为"闪一下只有边框 / 空白的窗口"。
        /// 显示后立刻同步整窗重绘：RDW_UPDATENOW 让 WM_PAINT 在当前消息内同步完成，
        /// 实测首个 WM_PAINT 由"落在 ShowDialog 返回之后"变为"落在其返回之前"。
        /// </summary>
        [DllImport("user32.dll")]
        private static extern bool RedrawWindow(IntPtr hWnd, IntPtr lprcUpdate, IntPtr hrgnUpdate, uint flags);
        private const uint RDW_INVALIDATE = 0x0001;
        private const uint RDW_ERASE = 0x0004;
        private const uint RDW_FRAME = 0x0400;
        private const uint RDW_ALLCHILDREN = 0x0080;
        private const uint RDW_UPDATENOW = 0x0100;

        protected override void SetVisibleCore(bool value)
        {
            base.SetVisibleCore(value);

            // 显示后同步补一次整窗重绘，避免"只有边框"的首帧被合成上屏
            if (value && IsHandleCreated)
            {
                try
                {
                    RedrawWindow(Handle, IntPtr.Zero, IntPtr.Zero,
                        RDW_INVALIDATE | RDW_ERASE | RDW_UPDATENOW | RDW_ALLCHILDREN | RDW_FRAME);
                }
                catch { }
            }
        }

        /// 构建深色主题对话框（纯代码布局，与主窗口风格一致）。
        private void InitializeForm()
        {
            // 防白屏闪烁：绘制并入 WM_PAINT；背景由 OnPaintBackground 深色填充；
            // 子控件重绘的区域白屏由 CreateParams 的 WS_EX_COMPOSITED 整窗合成消除
            SetStyle(ControlStyles.AllPaintingInWmPaint, true);

            Font uiFont = new Font("微软雅黑", 10F);
            Color bg = Color.FromArgb(30, 30, 30);
            Color fg = Color.White;
            Color labelGray = Color.FromArgb(170, 170, 170);

            Text = "配置参数";
            FormBorderStyle = FormBorderStyle.FixedDialog;
            MaximizeBox = false;
            MinimizeBox = false;
            // Manual：居中坐标由 CreateParams 在窗口创建前算好并交给 CreateWindowEx（详见 CreateParams），
            // 窗口直接出现在最终位置。
            // 不能用 CenterParent：实测它把本对话框创建在 (76,76)（并非主窗口中心）。
            // 也不能用 Manual + OnLoad 改 Location：实测窗口会先以 (0,0) 创建、之后才被移动，
            // 合成层窗口（WS_EX_COMPOSITED）会先在桌面左上角闪一帧"只有边框"的窗口再跳到目标位置。
            StartPosition = FormStartPosition.Manual;
            // 窗口图标与主窗口一致（exe 内嵌清单图标优先，app.ico 文件回退）；
            // 存字段而非局部变量：Dispose 时显式释放
            windowIcon = AppConfig.GetAppIcon();
            if (windowIcon != null)
            {
                Icon = windowIcon;
            }
            // 尺寸 580x660：运行版本 + 四行数值配置 + GitHub Token + 代理（类型/地址/端口，端口独立成行）+
            // 六个开关 + 操作按钮行 + 确定/取消行；输入控件列从 x=280 起（最宽输入右边界 510，右侧留 70px）
            ClientSize = new Size(580, 660);
            BackColor = bg;
            ForeColor = fg;
            Font = uiFont;

            // 运行版本：标准版 MoviePilot-V3（默认）/ freethreaded 版 MoviePilot-V3-T；
            // 决定启动服务时使用哪套 Python / venv / 后端代码目录（共用端口与前端，一次只运行一个版本）
            Label lblRunVersion = new Label
            {
                Text = "运行版本",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 20)
            };
            cmbRunVersion = new ComboBox
            {
                Location = new Point(280, 16),
                Width = 200,
                DropDownStyle = ComboBoxStyle.DropDownList
            };
            cmbRunVersion.Items.AddRange(new object[] { "MoviePilot-V3", "MoviePilot-V3-T" });

            // 优雅退出超时
            Label lblTimeout = new Label
            {
                Text = "优雅退出超时（秒）",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 60)
            };
            numTimeout = new NumericUpDown
            {
                Location = new Point(280, 60),
                Width = 120,
                Minimum = 1,
                Maximum = 600,
                TextAlign = HorizontalAlignment.Right
            };

            // Nginx 端口
            Label lblNginx = new Label
            {
                Text = "Nginx 监听端口",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 100)
            };
            numNginxPort = new NumericUpDown
            {
                Location = new Point(280, 100),
                Width = 120,
                Minimum = 1,
                Maximum = 65535,
                TextAlign = HorizontalAlignment.Right
            };

            // 后端端口
            Label lblBackend = new Label
            {
                Text = "后端监听端口",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 140)
            };
            numBackendPort = new NumericUpDown
            {
                Location = new Point(280, 140),
                Width = 120,
                Minimum = 1,
                Maximum = 65535,
                TextAlign = HorizontalAlignment.Right
            };

            // 服务状态监控间隔（面板定时刷新 nginx / python 存活状态，默认 5 秒）
            Label lblMonitor = new Label
            {
                Text = "状态监控间隔（秒）",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 180)
            };
            numMonitorSec = new NumericUpDown
            {
                Location = new Point(280, 180),
                Width = 120,
                // 最小 3 秒：状态查询实时拉取 PowerShell，低于 3 秒会使查询开销占比过高
                Minimum = 3,
                Maximum = 600,
                TextAlign = HorizontalAlignment.Right
            };

            // 阻止 Windows 休眠和睡眠：面板运行期间阻止系统空闲进入睡眠/休眠
            // （SetThreadExecutionState ES_SYSTEM_REQUIRED），退出面板时自动恢复，默认关闭
            chkPreventSleep = new CheckBox
            {
                Text = "阻止Windows休眠和睡眠",
                AutoSize = true,
                ForeColor = fg,
                Location = new Point(20, 380)
            };

            // 打印 Debug 日志：勾选后 uv / pip / git 等子进程命令输出以 DEBUG 级别
            // 实时显示到面板日志（未勾选时只显示 INFO / ERROR 级别的主流程日志）
            chkDebugLog = new CheckBox
            {
                Text = "打印Debug日志（显示 uv / pip / git 命令输出）",
                AutoSize = true,
                ForeColor = fg,
                Location = new Point(20, 410)
            };

            // GitHub Token（下载 GitHub 资源文件时携带 Authorization 请求头）
            Label lblToken = new Label
            {
                Text = "GitHub Token",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 224)
            };
            txtToken = new TextBox
            {
                Location = new Point(280, 220),
                Width = 290,
                BackColor = Color.White,
                ForeColor = Color.Black,
                BorderStyle = BorderStyle.FixedSingle
            };

            // 代理类型（系统代理 / http / 关闭）：socks5 已移除，统一走 Windows 系统代理或手动 http 代理；
            // 系统代理模式不需要填写地址/端口（读取系统 Internet 设置，自动随代理软件切换）
            Label lblProxyType = new Label
            {
                Text = "代理类型",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 264)
            };
            cmbProxyType = new ComboBox
            {
                Location = new Point(280, 260),
                Width = 100,
                DropDownStyle = ComboBoxStyle.DropDownList
            };
            cmbProxyType.Items.AddRange(new object[] { "系统代理", "http", "关闭" });
            // 类型切换时联动地址/端口可用性：仅手动 http 需要填写，系统代理/关闭时置灰
            cmbProxyType.SelectedIndexChanged += (s, e) => UpdateProxyControls();

            // 代理地址
            Label lblProxyHost = new Label
            {
                Text = "代理地址",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 304)
            };
            txtProxyHost = new TextBox
            {
                Location = new Point(280, 300),
                Width = 230,
                BackColor = Color.White,
                ForeColor = Color.Black,
                BorderStyle = BorderStyle.FixedSingle
            };

            // 代理端口（独立一行，输入框与上方数值行对齐）
            Label lblProxyPort = new Label
            {
                Text = "代理端口",
                AutoSize = true,
                ForeColor = labelGray,
                Location = new Point(20, 344)
            };
            numProxyPort = new NumericUpDown
            {
                Location = new Point(280, 340),
                Width = 120,
                Minimum = 0,
                Maximum = 65535,
                TextAlign = HorizontalAlignment.Right
            };

            // 启动时更新版本（对比官方最新标签，发现新版本自动更新 v3 分支）
            chkAutoUpdate = new CheckBox
            {
                Text = "启动时更新版本（对比官方最新标签，重建 v3 分支）",
                AutoSize = true,
                ForeColor = fg,
                Location = new Point(20, 440)
            };

            // 更新时强制更新前端资源与后端认证 / 站点资源（默认勾选）：
            // 官方前端可能对同一版本号重新发布不同内容的 dist.zip（版本号不变、内容更新），
            // 仅按版本号比较会漏更；勾选后手动升级 / 源码运行时即使版本相同也重新下载覆盖
            chkForceUpdate = new CheckBox
            {
                Text = "更新时强制更新前端资源和后端认证和站点资源",
                AutoSize = true,
                ForeColor = fg,
                Location = new Point(20, 470)
            };

            // 启动时自动启动 Nginx 和 Python
            chkAutoStart = new CheckBox
            {
                Text = "打开应用自动启动 Nginx 和 Python",
                AutoSize = true,
                ForeColor = fg,
                Location = new Point(20, 500)
            };

            // 启动时驻留系统托盘（不显示主窗口）
            chkTrayStart = new CheckBox
            {
                Text = "启动时驻留托盘（不显示主窗口）",
                AutoSize = true,
                ForeColor = fg,
                Location = new Point(20, 530)
            };

            // 检查MP更新（保存配置后触发 git 检查，发现新版本时询问确认再走升级流程）
            btnCheckUpdate = new Button
            {
                Text = "检查MP更新",
                BackColor = Color.FromArgb(60, 60, 60),
                FlatStyle = FlatStyle.Flat,
                ForeColor = fg,
                Location = new Point(20, 564),
                Size = new Size(140, 38)
            };
            btnCheckUpdate.Click += BtnCheckUpdate_Click;

            // 修复运行环境：靠右对齐窗口右边框（环境异常 / 补丁 cherry-pick 冲突时：
            // 强制重建官方最新 v3 基线并重新安装依赖、同步资源、重启服务）
            btnFixConflict = new Button
            {
                Text = "修复运行环境",
                BackColor = Color.FromArgb(60, 60, 60),
                FlatStyle = FlatStyle.Flat,
                ForeColor = fg,
                Location = new Point(ClientSize.Width - 160 - 20, 564),
                Size = new Size(160, 38)
            };
            btnFixConflict.Click += BtnFixConflict_Click;

            // 确定 / 取消：最底部水平居中（按窗口实际宽度动态计算，窗口加宽后仍保持居中）
            int btnGroupWidth = 215; // 整组宽度：确定 100 + 间距 15 + 取消 100
            int btnOKLeft = (ClientSize.Width - btnGroupWidth) / 2;
            btnOK = new Button
            {
                Text = "确定",
                DialogResult = DialogResult.OK,
                BackColor = Color.FromArgb(60, 60, 60),
                FlatStyle = FlatStyle.Flat,
                ForeColor = fg,
                Location = new Point(btnOKLeft, 610),
                Size = new Size(100, 38)
            };
            btnOK.Click += BtnOK_Click;

            btnCancel = new Button
            {
                Text = "取消",
                DialogResult = DialogResult.Cancel,
                BackColor = Color.FromArgb(60, 60, 60),
                FlatStyle = FlatStyle.Flat,
                ForeColor = fg,
                Location = new Point(btnOKLeft + 115, 610), // 115 = 100 + 15 间距
                Size = new Size(100, 38)
            };
            CancelButton = btnCancel;

            Controls.Add(lblRunVersion);
            Controls.Add(cmbRunVersion);
            Controls.Add(lblTimeout);
            Controls.Add(numTimeout);
            Controls.Add(lblNginx);
            Controls.Add(numNginxPort);
            Controls.Add(lblBackend);
            Controls.Add(numBackendPort);
            Controls.Add(lblMonitor);
            Controls.Add(numMonitorSec);
            Controls.Add(lblToken);
            Controls.Add(txtToken);
            Controls.Add(lblProxyType);
            Controls.Add(cmbProxyType);
            Controls.Add(lblProxyHost);
            Controls.Add(txtProxyHost);
            Controls.Add(lblProxyPort);
            Controls.Add(numProxyPort);
            Controls.Add(chkPreventSleep);
            Controls.Add(chkDebugLog);
            Controls.Add(chkAutoUpdate);
            Controls.Add(chkForceUpdate);
            Controls.Add(chkAutoStart);
            Controls.Add(chkTrayStart);
            Controls.Add(btnCheckUpdate);
            Controls.Add(btnFixConflict);
            Controls.Add(btnOK);
            Controls.Add(btnCancel);
        }

        /// <summary>
        /// 1) WS_EX_COMPOSITED：子控件与窗体统一合成，消除深色对话框子控件重绘瞬间的区域白屏。
        ///    注意：本对话框含文本输入框，若发现输入光标（caret）显示异常，可移除本重写。
        /// 2) 在窗口创建前就把"居中于主窗口"的坐标写进 CreateParams：窗口被 CreateWindowEx 直接
        ///    创建在最终位置，全生命周期内不存在 (0,0) 这个中间位置。
        ///    实测依据：用 StartPosition=Manual + OnLoad 改 Location 时，窗口先以 (0,0) 创建、
        ///    之后才被位移，合成层窗口（WS_EX_COMPOSITED）会先在桌面左上角闪一帧"只有边框"的窗口；
        ///    CenterParent 则会创建在 (76,76)。只有把坐标交给 CreateParams 才能一出生就在目标位置。
        /// </summary>
        protected override CreateParams CreateParams
        {
            get
            {
                CreateParams cp = base.CreateParams;
                cp.ExStyle |= 0x02000000; // WS_EX_COMPOSITED
                // Owner 尚未设置时（非 ShowDialog(owner) 方式打开）退回屏幕居中，避免又落到 (0,0)
                Rectangle area = Owner != null ? Owner.Bounds : Screen.PrimaryScreen.WorkingArea;
                cp.X = area.Left + Math.Max(0, (area.Width - Width) / 2);
                cp.Y = area.Top + Math.Max(0, (area.Height - Height) / 2);
                return cp;
            }
        }

        /// 背景绘制：直接用窗体背景色填充，避免模态对话框首次显示时的白屏闪烁。
        /// 注意必须填充整个 ClientRectangle 而非 e.ClipRectangle：双缓冲位图中子控件
        /// 区域不在无效区域内，只填 ClipRectangle 会使位图中子控件区域呈白色块。
        protected override void OnPaintBackground(PaintEventArgs e)
        {
            using (SolidBrush brush = new SolidBrush(BackColor))
            {
                e.Graphics.FillRectangle(brush, ClientRectangle);
            }
        }

        /// 将当前配置值回填到控件。
        private void LoadCurrentSettings()
        {
            AppSettings s = AppSettings.Current;

            numTimeout.Value = Clamp(s.ShutdownTimeoutSec, (int)numTimeout.Minimum, (int)numTimeout.Maximum);
            numNginxPort.Value = Clamp(s.NginxPort, (int)numNginxPort.Minimum, (int)numNginxPort.Maximum);
            numBackendPort.Value = Clamp(s.BackendPort, (int)numBackendPort.Minimum, (int)numBackendPort.Maximum);
            numMonitorSec.Value = Clamp(s.StatusMonitorSec, (int)numMonitorSec.Minimum, (int)numMonitorSec.Maximum);
            cmbRunVersion.SelectedItem = s.RunVersion;
            chkPreventSleep.Checked = s.PreventSleep;
            chkDebugLog.Checked = s.DebugLog;
            chkAutoUpdate.Checked = s.AutoUpdateOnStart;
            chkForceUpdate.Checked = s.ForceUpdateResources;
            chkAutoStart.Checked = s.AutoStartServices;
            chkTrayStart.Checked = s.StartMinimizedToTray;
            txtToken.Text = s.GitHubToken;
            // 下拉顺序：0=系统代理 / 1=http / 2=关闭；空值（显式关闭）选最后一项
            cmbProxyType.SelectedIndex = s.ProxyType == "system" ? 0 : (s.ProxyType == "http" ? 1 : 2);
            txtProxyHost.Text = s.ProxyHost;
            numProxyPort.Value = Clamp(s.ProxyPort, (int)numProxyPort.Minimum, (int)numProxyPort.Maximum);
            UpdateProxyControls();
        }

        /// 代理类型不是手动 http 时禁用地址/端口输入（系统代理读系统设置，关闭时无需填写）。
        private void UpdateProxyControls()
        {
            bool manual = cmbProxyType != null && cmbProxyType.SelectedIndex == 1;
            txtProxyHost.Enabled = manual;
            numProxyPort.Enabled = manual;
        }

        private static decimal Clamp(int value, int min, int max)
        {
            if (value < min) return min;
            if (value > max) return max;
            return value;
        }

        /// 代理地址格式校验：IPv4（四段各 0-255）或主机名（localhost / 域名，段内字母数字与连字符）；
        /// 纯数字但不是合法 IPv4（如把端口误填进地址框）拒绝。
        private static bool IsValidProxyHost(string host)
        {
            string[] parts = host.Split('.');
            bool allNumeric = true;
            foreach (string part in parts)
            {
                if (part.Length == 0 || !IsDigits(part))
                {
                    allNumeric = false;
                    break;
                }
            }
            // IPv4：四段全数字，每段 0-255（byte.TryParse 天然拒绝 256 等越界值）
            if (parts.Length == 4 && allNumeric)
            {
                foreach (string part in parts)
                {
                    byte b;
                    if (!byte.TryParse(part, out b)) return false;
                }
                return true;
            }
            // 纯数字但不是合法 IPv4（如 10828）：判定为端口误填，拒绝
            if (allNumeric) return false;
            // 主机名（localhost / 域名）：段内仅字母数字与连字符，不以连字符开头或结尾
            foreach (string part in parts)
            {
                if (part.Length == 0 || part[0] == '-' || part[part.Length - 1] == '-') return false;
                foreach (char c in part)
                {
                    if (!(char.IsLetterOrDigit(c) || c == '-')) return false;
                }
            }
            return true;
        }

        /// 字符串是否全为数字。
        private static bool IsDigits(string s)
        {
            foreach (char c in s)
            {
                if (!char.IsDigit(c)) return false;
            }
            return true;
        }

        /// 检查MP更新：先保存当前配置，再标记检查请求（对话框以 OK 关闭，
        /// 调用方基于刚保存的运行版本执行 git 检查，检测到新版本时询问确认后升级）。
        private void BtnCheckUpdate_Click(object sender, EventArgs e)
        {
            BtnOK_Click(sender, e);
            if (DialogResult == DialogResult.OK)
            {
                CheckUpdateRequested = true;
            }
        }

        /// 修复运行环境：先保存当前配置，再标记修复请求（对话框以 OK 关闭）。
        private void BtnFixConflict_Click(object sender, EventArgs e)
        {
            BtnOK_Click(sender, e);
            if (DialogResult == DialogResult.OK)
            {
                FixConflictRequested = true;
            }
        }

        /// 确定：校验后写回配置并持久化。
        private void BtnOK_Click(object sender, EventArgs e)
        {
            try
            {
                AppSettings s = AppSettings.Current;
                // 本次保存的目标运行版本：先取下拉框选择值，供切换 T 版前的环境预检与写回配置共用
                string selectedVersion = (string)cmbRunVersion.SelectedItem;

                // 代理完整性校验：仅手动 http 代理需要填写地址/端口（系统代理/关闭由系统或留空决定），
                // 避免静默保存无效配置（BuildProxyUrl 返回 null，表现为日志“已清空 git 全局代理”且下载不走代理）
                if (cmbProxyType.SelectedIndex == 1)
                {
                    string proxyHost = txtProxyHost.Text.Trim();
                    int proxyPort = (int)numProxyPort.Value;
                    if (proxyHost.Length == 0 || proxyPort <= 0)
                    {
                        MessageBox.Show(this, "已选择 http 代理，请填写完整的代理地址与端口。", "配置提示",
                            MessageBoxButtons.OK, MessageBoxIcon.Warning);
                        return;
                    }
                    if (!IsValidProxyHost(proxyHost))
                    {
                        MessageBox.Show(this, "代理地址格式无效，请填写 IPv4 地址（如 127.0.0.1）或主机名（如 localhost）。", "配置提示",
                            MessageBoxButtons.OK, MessageBoxIcon.Warning);
                        return;
                    }
                }

                // freethreaded 版（MoviePilot-V3-T）环境预检：仅当本次保存将运行版本切换为 T 版时触发
                // （当前生效版本已是 T 版时不重复打扰）。T 版后端依赖无官方预编译二进制，首次安装时由 uv
                // 在本机实时编译源码（psycopg 需 PostgreSQL libpq，其余需 MSVC / Rust 工具链），
                // 环境缺失必然编译失败，故保存前读取系统环境探测并提示
                if (selectedVersion == "MoviePilot-V3-T" && s.RunVersion != "MoviePilot-V3-T")
                {
                    List<string> missing = ProbeTEnvironment();
                    if (missing.Count > 0)
                    {
                        DialogResult dr = MessageBox.Show(this,
                            "切换到 freethreaded 版（MoviePilot-V3-T）需要本机编译环境，首次安装依赖时 uv 会实时编译源码，\n" +
                            "以下环境未就绪将导致依赖编译失败：\n\n" +
                            "• " + string.Join("\n• ", missing.ToArray()) +
                            "\n\n请参照 README-freethreaded.md 补齐（新装工具或修改 PATH 后需重启本面板生效）。\n" +
                            "是否仍要切换到 MoviePilot-V3-T？",
                            "T 版编译环境检测",
                            MessageBoxButtons.YesNo, MessageBoxIcon.Warning);
                        if (dr != DialogResult.Yes)
                        {
                            return; // 用户放弃切换：不保存，运行版本保持原值
                        }
                    }
                }

                s.ShutdownTimeoutSec = (int)numTimeout.Value;
                s.NginxPort = (int)numNginxPort.Value;
                s.BackendPort = (int)numBackendPort.Value;
                s.StatusMonitorSec = (int)numMonitorSec.Value;
                s.RunVersion = selectedVersion;
                s.PreventSleep = chkPreventSleep.Checked;
                s.DebugLog = chkDebugLog.Checked;
                s.AutoUpdateOnStart = chkAutoUpdate.Checked;
                s.ForceUpdateResources = chkForceUpdate.Checked;
                s.AutoStartServices = chkAutoStart.Checked;
                s.StartMinimizedToTray = chkTrayStart.Checked;
                s.GitHubToken = txtToken.Text.Trim();
                // 下拉顺序：0=系统代理 / 1=http / 2=关闭；socks5 已移除
                s.ProxyType = cmbProxyType.SelectedIndex == 0 ? "system" : (cmbProxyType.SelectedIndex == 1 ? "http" : "");
                s.ProxyHost = txtProxyHost.Text.Trim();
                s.ProxyPort = (int)numProxyPort.Value;
                s.Save();
                DialogResult = DialogResult.OK;
            }
            catch (Exception ex)
            {
                MessageBox.Show(this, "配置参数无效:\n" + ex.Message, "错误",
                    MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }

        /// 检测 freethreaded 版（MoviePilot-V3-T）所需的本机编译环境（读取系统 PATH 与 VS Installer 注册状态）：
        /// ① Microsoft Visual Studio（vswhere 查询带 MSVC x64 工具链的实例）；
        /// ② Rust（rustc 在 PATH）；③ PostgreSQL（pg_config 在 PATH）；④ MSBuild 或 dotnet（任一可用）。
        /// 返回未就绪项的提示文案列表，全部就绪时为空。
        private static List<string> ProbeTEnvironment()
        {
            List<string> missing = new List<string>();

            // Visual Studio：vswhere 是 VS Installer 官方自带的实例查询工具（路径固定）；
            // 只装 VS 而未装“使用 C++ 的桌面开发”工作负载时同样查不到匹配实例，一并提示。
            // vswhere 无匹配实例时退出码仍为 0（实测，不能靠退出码判断），带 -property installationPath
            // 查询时只有匹配实例才输出安装路径，故以输出非空为准
            string vswhere = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ProgramFilesX86),
                "Microsoft Visual Studio", "Installer", "vswhere.exe");
            if (string.IsNullOrEmpty(ProbeCommandOutput(vswhere,
                "-latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath")))
            {
                missing.Add("Microsoft Visual Studio：未安装，或缺少“使用 C++ 的桌面开发”工作负载（依赖 MSVC 工具链 cl.exe / link.exe）");
            }

            // Rust：rustup 安装后其 bin（含 rustc）已加入用户 PATH，编译 Rust 扩展必需
            if (ProbeCommandOutput("rustc", "--version") == null)
            {
                missing.Add("Rust：rustc 不在环境变量 PATH 中（编译 Rust 扩展必需，见 README-freethreaded.md 步骤 2）");
            }

            // PostgreSQL：psycopg 源码编译需按 libpq 位置，须把 PostgreSQL 安装目录的 bin（含 pg_config）加入 PATH
            if (ProbeCommandOutput("pg_config", "--version") == null)
            {
                missing.Add("PostgreSQL：pg_config 不在环境变量 PATH 中（编译 psycopg 需要 libpq，见 README-freethreaded.md 步骤 4）");
            }

            // MSBuild / dotnet：命令行构建工具链，两者任一可用即可
            if (ProbeCommandOutput("dotnet", "--version") == null && ProbeCommandOutput("msbuild", "-version") == null)
            {
                missing.Add("MSBuild / dotnet：两者均不可用（命令行构建需要 msbuild 或 dotnet msbuild 其中之一）");
            }

            return missing;
        }

        /// 探测外部命令可用性：返回命令的标准输出（去首尾空白）；
        /// 找不到可执行文件（不在 PATH）、启动失败、3 秒内未退出或退出码非 0 时返回 null。
        /// 先限时等待退出再读输出（输出量远小于管道缓冲 4KB，不会因缓冲写满而阻塞）；
        /// 返回 null 与空字符串的区分：null=命令不可用，空串=命令可用但无输出（如 vswhere 无匹配实例）
        private static string ProbeCommandOutput(string fileName, string arguments)
        {
            try
            {
                ProcessStartInfo psi = new ProcessStartInfo
                {
                    FileName = fileName,
                    Arguments = arguments,
                    UseShellExecute = false,
                    CreateNoWindow = true,
                    RedirectStandardOutput = true,
                    RedirectStandardError = true,
                    // 子进程输出为 UTF-8：强制按 UTF-8 解码（项目统一约定），
                    // 避免中文系统（GBK 代码页）下默认按 ANSI 解码导致乱码
                    StandardOutputEncoding = Encoding.UTF8,
                    StandardErrorEncoding = Encoding.UTF8
                };
                Process p = Process.Start(psi);
                try
                {
                    if (!p.WaitForExit(3000))
                    {
                        try { p.Kill(); }
                        catch { }
                        return null;
                    }
                    if (p.ExitCode != 0)
                    {
                        return null;
                    }
                    // 进程已退出，读端仍可读完管道中残留输出（写端已关闭，读到 EOF 即结束）
                    return p.StandardOutput.ReadToEnd().Trim();
                }
                finally
                {
                    // 释放进程对象并抹除本地引用后立即回收重定向管道句柄：
                    // 置 null 防 Debug 构建下 JIT 延长局部变量生存期导致回收不彻底，原因详见 ReclaimProcessHandles
                    try { p.Dispose(); } catch { }
                    p = null;
                    EnvironmentSetup.ReclaimProcessHandles();
                }
            }
            catch
            {
                // 启动失败（如命令不在 PATH 时抛 Win32Exception）一律视为不可用
                return null;
            }
        }
    }
}