FAST-UUPD

Windows UUP 转换器配置优化与下载管理工具

概述

FAST-UUPD 是一套用于提升 UUP (Unified Update Platform) 转换器套件性能的 Python 工具集。它能自动优化 ConvertConfig.ini 配置、加速 WIM 合成、替换高性能 aria2 下载引擎，并提供远程 RPC 下载模式，显著加快 Windows ISO 的组装速度。

功能

• 一键性能优化 — 自动应用 RefESD=1、LCUmsuExpand=1、vUseDism=0 三项核心优化，提升 WIM 合成速度 30-50%
• 外部更新模式 — 可选启用 AddUpdates=2，将更新集成延迟到安装阶段，4 倍提速
• wimlib 多线程加速 — 自动检测 CPU 核心数，注入 --threads 参数，充分利用多核性能
• aria2-next 替换 — 将旧版 aria2c.exe 替换为 aria2-next 2.5.1，支持中/高/极速三档下载参数预设
• 远程 RPC 下载模式 — 支持连接远程 aria2 RPC 服务器下载，不依赖本地 aria2c
• 自定义下载阶段 — 黑名单/白名单模式，可跳过或仅下载指定阶段（转换器/Store 应用/UUP 文件集）
• 交互式菜单 + CLI — 既可用交互式菜单操作，也支持命令行参数一键执行
• 备份与恢复 — 自动备份原始配置，可随时恢复或对比差异

环境要求

• 操作系统: Windows 10 1803+
• Python: 3.10+
• 依赖库: 无（标准库即可），可选 psutil（更准确的 CPU 检测）

安装

# 克隆仓库
git clone https://github.com/DHA404/FAST_UUPD.git
cd FAST_UUPD

# （可选）安装 psutil 以获得更准确的 CPU 核心检测
pip install psutil

aria2-next 二进制已包含在 aria2-next/aria2c.exe 中，无需额外下载。

使用方法

交互菜单模式

在 UUPD 套件目录（包含 ConvertConfig.ini 的目录）中运行：

python uup_optimizer.py

交互菜单提供以下功能选项：

菜单	功能
[1]	应用推荐优化
[2]	应用 wimlib 多线程加速
[3]	替换 aria2 + 下载档位配置
[4]	查看 CPU 信息与建议
[5]	查看当前配置
[6]	对比当前与备份
[7]	手动备份
[8]	从备份恢复
[A]	远程 aria2 RPC 模式
[B]	下载参数预设
[C]	自定义下载阶段（跳过/仅下载）
[0]	退出

命令行模式

# 一键应用所有推荐优化
python uup_optimizer.py --apply

# 应用优化 + 外部更新模式 (AddUpdates=2)
python uup_optimizer.py --apply --ext-update

# 启用 wimlib 多线程 (物理核心数)
python uup_optimizer.py --threads

# 替换 aria2 并设置高速档位
python uup_optimizer.py --replace-aria2 --aria2-preset high

# 启用远程 RPC 下载模式
python uup_optimizer.py --aria2-rpc

# 启用 RPC + 跳过 Store 应用下载
python uup_optimizer.py --aria2-rpc --skip-apps

# 启用 RPC + 仅下载 UUP 文件集
python uup_optimizer.py --aria2-rpc --only-uups

# 指定目标目录（UUPD 套件目录）
python uup_optimizer.py --apply --path "D:\UUPD\26200.8968_amd64_zh-cn"

完整 CLI 参数

--apply                  应用推荐优化 (RefESD/LCUmsuExpand/vUseDism)
--ext-update             额外启用 AddUpdates=2 (外部更新模式)
--threads                启用 wimlib 多线程加速
--threads-n N            指定 wimlib 线程数
--threads-mode {phys,half,logi}  线程模式
--replace-aria2          替换 aria2c.exe 为 aria2-next
--aria2-preset {medium,high,max}  下载档位
--aria2-rpc              启用远程 aria2 RPC 模式
--no-rpc                 关闭 RPC 模式
--rpc-host HOST:PORT     RPC 服务器地址 (默认: 127.0.0.1:29100)
--rpc-secret TOKEN       RPC 密钥
--skip-apps              跳过 Store 应用下载
--skip-uups              跳过 UUP 文件集下载
--skip-download          跳过全部下载 (直接封装)
--skip-converter         跳过转换器下载
--only-apps              仅下载 Store 应用
--only-uups              仅下载 UUP 文件集
--only-download          仅下载不封装
--only-converter         仅下载转换器
--info                   显示 CPU 信息与建议
--restore                从最新备份恢复
--diff                   对比当前与备份
--backup                 仅创建备份
--show                   显示当前配置
--path PATH              ConvertConfig.ini 路径或所在目录

文件说明

文件	用途
uup_optimizer.py	主优化工具，交互菜单 + CLI
download_config.py	共享配置模块（档位预设、INI 读写、目录检测）
aria2-next/aria2c.exe	aria2-next 2.5.1 高性能下载引擎

RPC 模式

RPC 模式允许你通过远程 aria2 守护进程下载文件。默认配置：

• 主机: 127.0.0.1:29100
• 密钥: 由用户通过 --rpc-secret 或交互菜单指定

启用后，uup_download_windows.cmd 中的 aria2 调用会被替换为 PowerShell RPC 客户端，所有下载任务由远程 aria2 服务端执行。这对于需要在多台机器间共享下载任务或使用专用下载服务器的场景非常有用。

友情链接

• UUP Dump — 下载 Windows UUP 文件集并生成转换脚本
• UUP Assistant — UUP 下载辅助工具
• UUPdumpWinISO — UUP 转 ISO 封装工具

许可

MIT