无忧启动论坛

标题: WimPatch - WIM增量更新工具 (WinPE) [打印本页]
作者: 834772509    时间: 昨天 14:15
标题: WimPatch - WIM增量更新工具 (WinPE)
本帖最后由 834772509 于 2025-11-19 14:23 编辑

WimPatch 是一个高效的 Windows 映像文件 (WIM) 补丁工具，用于创建和应用 WIM 文件的增量补丁，高效且安全地管理 WIM 文件的增量更新。

功能特性
使用说明
WimPatch 是一个命令行工具，提供以下子命令：

创建补丁
创建增量补丁文件，用于将更新后的 WIM 文件应用到基础 WIM 文件。
  1. WimPatch.exe create --base <基础WIM文件> --target <更新后的WIM文件> --out <输出补丁文件> --version <版本号> [选项]
复制代码
参数说明:

参数
短参数
描述
默认值
  --base
  -b
  基础 WIM 文件路径，指定用于创建增量补丁的基础 WIM 文件，通常是未更新的 WIM 文件。
  必需
  --target
  -t
  更新后的 WIM 文件路径，指定包含更新内容的 WIM 文件，用于与基础 WIM 文件进行比较，生成增量补丁。
  必需
  
  --out
  -o
  输出补丁文件路径，指定生成的增量补丁文件的存储位置。
  必需
  --version
  -v
  补丁文件版本，必须是有效的 SemVer 格式（如 1.0.0）。
  		  必需
  --author
  -a
  补丁文件作者，用于标识创建该补丁的用户或团队。
  		  unknown
  --name
  -n
  补丁文件名称，用于标识补丁文件，默认自动生成（格式：基础镜像文件名-patch-v版本号）。
  		  自动生成
  --description
  -d
  补丁文件描述，用于说明补丁的作用和影响。
  无
  --index
  -i
  WIM 文件中的镜像索引（指定此参数时，会同时应用于基础和目标文件，此参数与单独指定基础/目标索引的参数互斥）。
  -
  --base-index
  无
  基础 WIM 文件中的镜像索引（必须与--target-index同时指定，与--index互斥）。
  -
  --target-index
  无
  更新后的 WIM 文件中的镜像索引（必须与--base-index同时指定，与--index互斥）。
  		  -
  --compress
  -c
  补丁WIM文件压缩算法: None, Xpress, Lzx 。
  Lzx
  --storage
  -s
  补丁文件的存储类型：• Full：完整存储，速度快但文件大；
   •  Zstd：Zstd算法差异存储，平衡大小和速度；
   •  Bsdiff：Bsdiff算法差异存储，文件最小但速度慢。
  		  Zstd
  --preset
  -p
  压缩预设级别：
   •  Fast：快速压缩，处理速度快但压缩率较低；
  • Medium：中等压缩，平衡速度和压缩率；
  • Best：最佳压缩，高压缩率但处理速度较慢；
  • Extreme：极限压缩，最高压缩率但处理速度最慢。
  		  Medium
  --exclude
  -e
  从补丁文件中排除的文件路径，可多次指定参数。
  		  无
示例:
  1. WimPatch.exe create -b "D:\base-v1.0.0.wim" -t "D:\base-v1.1.0.wim" -o "D:\base-patch-v1.1.0.wim" -v 1.1.0 -a "FirTech" -n "1.0.0(patch01)" -d "更新系统默认配置文件和壁纸资源。调整了休眠模式的默认计时器设置。"
复制代码

应用补丁
应用补丁到基础 WIM 文件，生成更新后的 WIM 文件。
  1. WimPatch.exe apply --base <基础WIM文件> --patch <补丁文件> --target <目标WIM文件> [选项]
复制代码
参数说明:
参数
短参数
描述
默认值
  --base
  -b
  原始WIM镜像文件路径
必需
  --patch
  -p
  补丁文件路径
必需
  --target
  -t
  应用补丁后的输出镜像路径
必需
  --index
  -i
  基础 WIM 文件中的目标镜像索引（仅对该索引应用补丁。若不指定，将尝试匹配补丁包内所有卷）
  		匹配
  --exclude
  -e
  从补丁文件中排除的文件路径 (可以指定多个)
  		无
  --force
  -f
  强制应用补丁，跳过基础卷的内容校验。警告：可能导致映像损坏。
  		无
示例:
  1. WimPatch.exe apply -b "D:\base-v1.0.0.wim" -p "D:\base-patch-v1.1.0.wim" -t "D:\target-v1.1.0.wim"
复制代码

合并补丁
合并多个增量补丁文件为一个综合补丁文件。
  1. WimPatch.exe merge <补丁文件1> <补丁文件2> ... --out <输出补丁文件>
复制代码
参数说明:
参数
短参数
描述
默认值
--out
-o
输出合并后的补丁文件路径
必需
示例:
  1. WimPatch.exe merge "D:\base-patch-v1.1.0.wim" "D:\base-patch-v1.2.0.wim" -o "D:\base-patch-v1.2.0-merge.wim"
复制代码

查看补丁信息
显示补丁文件的详细信息。
●       显示补丁文件的版本、作者、名称、描述等信息
●       可选以 XML 格式输出详细信息
  1. WimPatch.exe info <补丁文件> [选项]
复制代码
参数说明:

参数
短参数
描述
默认值
--xml
-x
以XML格式输出补丁信息
 无
示例:
  1. WimPatch.exe info "D:\base-patch-v1.1.0.wim"
复制代码
清理挂载点
清理无效的 WIM 挂载点。
  1. WimPatch.exe clean
复制代码
全局选项
参数
短参数
描述
默认值
--buffer-size
无
指定缓冲区大小（单位：字节）
65536
--debug
无
调试模式，输出调试信息到控制台
无
--language
无
设置程序语言 (en, zh-cn, zh-tw, ja-jp)
自动识别
--scratchdir
无
指定临时目录路径，用于存储中间文件和挂载点
系统临时目录
技术说明补丁
创建/应用工作原理
WimPatch 使用 Windows 映像 API (WIMGAPI) 来处理 WIM 文件。
创建补丁 (Create) 流程：
1. 挂载基础镜像： 挂载基础 WIM 文件中的指定镜像卷（只读）。
2. 挂载目标镜像： 挂载更新后的 WIM 文件中的指定镜像卷（只读）。
3. 对比文件差异： 遍历两个挂载点，对比文件内容、属性和元数据，并调用 Zstd/BSDiff 算法计算文件级的二进制差异（Delta）。
4. 生成补丁数据： 将步骤 3 生成的所有差异数据和元信息压缩，写入到输出补丁文件 (`.wim`) 中。
5. 卸载清理： 卸载并清理基础镜像和目标镜像的挂载点。

应用补丁 (Apply) 流程：
1. 准备可写基线： 将原始基础 WIM 文件中的目标镜像复制到临时目录，并以读写（ReadWrite）模式挂载。
2. 挂载补丁： 挂载待应用的补丁文件（只读）。
3. 应用差异： 遍历补丁文件中的数据，将补丁差异数据应用到步骤 1 中挂载的可写基础镜像上。
4. 提交更改： 将所有已应用的更改和文件差异提交（Commit）到挂载点对应的临时 WIM 文件中。
5. 卸载清理： 卸载基础镜像的临时副本和补丁文件的挂载点。
6. 导出目标 WIM：将步骤 4 提交后的临时 WIM 文件（即已打好补丁的镜像）导出到用户指定的目标 WIM 文件位置。

注意事项
1. 操作 WIM 文件可能需要管理员权限
2. 处理大型 WIM 文件时，建议确保有足够的磁盘空间和内存
3. 命令行环境：请通过命令行（CMD/PowerShell）启动程序。从资源管理器直接双击运行时，程序将自动退出。

许可证
Apache License 2.0

下载
WimPatch-V1.0.0.zip (1.52 MB, 下载次数: 28)
作者: 834772509    时间: 昨天 14:15
本帖最后由 834772509 于 2025-11-15 18:39 编辑

占楼备用，说下应用场景：假设WinPE更新了部分配置和软件，无需全量更新PE发布，可使用本工具创建增量更新补丁，然后对PE的wim文件打补丁即可。
作者: 肉仔    时间: 昨天 14:49
感谢分享！
作者: 2267981144    时间: 昨天 18:43
感谢楼主辛苦提供分享！
作者: 红毛樱木    时间: 昨天 19:33
这想法以前有过，本地处理更新，可能环境更复杂，比直接整体下载可能更容易失败。点赞
作者: wdh200211    时间: 昨天 20:06
下回来学习试用下



欢迎光临 无忧启动论坛 (http://wuyou.net/) Powered by Discuz! X3.3