# Windows补丁批量安装工具

**Repository Path**: Evil_Pig/windows-patch-batch-installer

## Basic Information

- **Project Name**: Windows补丁批量安装工具
- **Description**: Windows补丁批量安装工具​：面向运维/桌面支持的轻量工具，支持按顺序批量安装 ​.msu / .cab / .exe​（静默参数），提供图形界面与命令行双模式。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-31
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Windows, Python

## README

# Windows补丁批量安装工具

## 项目介绍

Windows补丁批量安装工具是一款用于批量安装Windows系统补丁的工具，支持MSU、CAB和EXE格式的补丁文件。该工具提供了GUI和CLI两种操作模式，方便用户根据需要选择使用。

## 功能特性

### 核心功能
- 支持批量安装MSU、CAB和EXE格式的Windows补丁
- 提供GUI和CLI两种操作模式
- 自动检测补丁与系统的兼容性
- 实时显示安装进度和日志
- 支持安装后自动重启系统
- 自动收集失败补丁的日志信息

### 增强功能
- 补丁信息展示：显示补丁的详细信息，如KB编号、文件大小、目标版本等
- 智能补丁排序：支持按名称、大小、KB编号等排序
- 系统状态检查：安装前检查系统状态
- 补丁安装历史记录：记录已安装的补丁信息
- 友好的用户界面：支持调整窗口大小和分割比例

## 系统要求

- Windows 7 及以上版本
- 需要管理员权限运行
- .NET Framework 4.0 及以上（仅在运行EXE格式补丁时需要）

## 安装说明

1. 下载最新版本的工具压缩包
2. 解压到任意目录
3. 双击运行 `Windows补丁批量安装工具.exe`（GUI模式）
4. 或在命令行中运行 `Windows补丁批量安装工具.exe --help`（查看CLI模式帮助）

## 使用说明

### GUI模式

1. 运行工具后，系统会自动检测当前目录下的补丁文件
2. 点击"选择目录"按钮可以选择其他目录下的补丁文件
3. 在补丁列表中选择要安装的补丁（支持多选）
4. 点击"开始安装"按钮开始安装补丁
5. 安装过程中可以查看实时日志和进度
6. 安装完成后，工具会显示安装结果
7. 如果需要重启，点击"重启系统"按钮可以重启计算机

### CLI模式

```
Windows补丁批量安装工具.exe [选项]

选项：
  --dir, -d     指定补丁目录路径，默认使用当前目录
  --norestart   安装完成后不提示重启（默认会提示）
  --logfile, -l 指定日志文件路径，默认在补丁目录下生成
  --help        显示帮助信息
  --version     显示版本信息
```

#### 示例

1. 在当前目录安装补丁：
   ```
   Windows补丁批量安装工具.exe
   ```

2. 在指定目录安装补丁：
   ```
   Windows补丁批量安装工具.exe --dir D:\Patches
   ```

3. 安装补丁后不提示重启：
   ```
   Windows补丁批量安装工具.exe --norestart
   ```

4. 指定日志文件路径：
   ```
   Windows补丁批量安装工具.exe --logfile D:\PatchInstall.log
   ```

## 补丁文件命名建议

为了确保补丁能够正确安装，建议按照以下格式命名补丁文件：

```
[序号]-[KB编号].[扩展名]
```

例如：
- `001-KB5003637.msu`
- `002-KB5003638.cab`
- `003-KB5003639.exe`

## 常见问题

### 1. 安装补丁时提示权限不足

**解决方案**：请以管理员身份运行工具。右键点击工具图标，选择"以管理员身份运行"。

### 2. 部分补丁安装失败

**解决方案**：
- 检查补丁文件是否完整，尝试重新下载
- 检查补丁与当前系统的兼容性
- 查看失败日志文件，了解具体失败原因
- 确保系统更新服务（wuauserv）正在运行

### 3. 安装完成后系统没有自动重启

**解决方案**：
- 检查是否勾选了"安装完成后不提示重启"选项
- 手动重启系统以确保补丁生效

### 4. 工具无法识别某些补丁文件

**解决方案**：
- 确保补丁文件格式为MSU、CAB或EXE
- 检查补丁文件名是否包含特殊字符
- 尝试将补丁文件移动到不含中文和空格的目录

## 日志文件

工具会在以下位置生成日志文件：

- GUI模式：`[当前目录]\[时间戳]_PatchInstall_GUI.log`
- CLI模式：`[补丁目录]\[时间戳]_PatchInstall_CLI.log`

失败补丁的日志会保存在：
- `[当前目录]\[日期]_失败日志\`

## 开发说明

### 项目结构

```
windows-patch-batch-installer/
├── src/
│   ├── main.py          # 主程序入口
│   ├── gui.py           # GUI界面实现
│   ├── cli.py           # CLI模式实现
│   ├── constants.py     # 常量定义
│   ├── utils.py         # 工具函数
│   ├── patch_manager.py # 补丁管理模块
│   └── Windows补丁批量安装工具.py # 打包入口
├── .gitignore           # Git忽略文件
├── README.md            # 项目说明文档
└── requirements.txt     # 依赖列表
```

### 开发环境

- Python 3.8+
- tkinter（Python标准库）
- 无其他第三方依赖

### 打包说明

使用PyInstaller打包：

```
pip install pyinstaller
pyinstaller --onefile --windowed --icon=favicon.ico --name="Windows补丁批量安装工具" src/Windows补丁批量安装工具.py
```

## 版本历史

### v1.2.0
- 实现了模块化设计，将补丁管理功能分离到独立模块
- 添加了补丁信息展示功能
- 改进了日志管理，统一了日志文件命名格式
- 优化了错误处理，增强了错误信息详细程度
- 改进了GUI界面布局，支持水平分割

### v1.1.0
- 支持EXE格式补丁
- 增强了错误处理和日志记录
- 改进了GUI界面
- 添加了CLI模式

### v1.0.0
- 初始版本
- 支持MSU和CAB格式补丁
- 提供基本的GUI界面

## 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 贡献

欢迎提交Issue和Pull Request，共同改进这个工具。

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- GitHub Issues：[项目GitHub地址]
- 邮箱：[联系邮箱]

## 致谢

感谢所有为这个项目做出贡献的开发者和用户！