# windows-file-update-packager

**Repository Path**: dbt2012/windows-file-update-packager

## Basic Information

- **Project Name**: windows-file-update-packager
- **Description**: 一个用于检测 Windows 系统目录文件变化并进行打包的本地化桌面应用工具。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-14
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Windows, Electron

## README

# Windows File Change Packager

一个用于检测 Windows 系统目录文件变化并进行打包的本地化桌面应用工具。

## 功能特性

- **文件系统扫描** - 扫描指定目录，生成文件快照（包含文件路径、大小、修改时间、哈希值）
- **实时文件监控** - 使用 Chokidar 实时监听目录变化，记录文件创建、修改、删除事件
- **快照对比** - 支持快照与目录对比、快照与快照对比，清晰展示新增/修改/删除的文件
- **智能打包** - 对变化的文件进行 ZIP 压缩打包，包含更新信息清单
- **路径记忆** - 自动保存用户选择的目录和快照路径，重启后自动恢复
- **完全本地化** - 无需联网，所有功能在本地完成，保护数据隐私

## 技术栈

- **框架**: Electron 28
- **UI**: 原生 HTML/CSS/JavaScript（无第三方框架依赖）
- **文件监控**: Chokidar
- **ZIP 打包**: Archiver
- **图标**: 内嵌 SVG 图标

## 快速开始

### 环境要求

- Node.js 18+
- npm 或 yarn

### 安装依赖

```bash
cd windows-update-packager
npm install
```

### 开发模式

```bash
npm start
```

### 构建安装包

```bash
# 生成 NSIS 安装包
npm run build

# 生成便携版
npm run build:portable
```

## 使用说明

### 1. 扫描目录

在「扫描目录」标签页中：

- 点击「选择目录」按钮选择要扫描的文件夹
- 设置扫描选项（是否包含隐藏文件、哈希算法）
- 点击「开始扫描」生成文件快照
- 点击「保存快照」将快照保存为 JSON 文件

### 2. 实时监控

在「实时监控」标签页中：

- 选择要监控的目录
- 点击「开始监控」启动实时监听
- 实时查看文件变化日志
- 支持暂停/停止监控

### 3. 对比变更

在「对比更新」标签页中：

- 选择基准快照文件
- 选择对比对象（目录或另一个快照）
- 点击「开始对比」查看文件变化
- 支持搜索过滤和排序

### 4. 打包更新

在「打包更新」标签页中：

- 确认要打包的变化文件列表
- 设置打包选项（压缩级别、是否包含日志）
- 选择输出目录
- 点击「开始打包」生成 ZIP 文件

## 项目结构

```
windows-update-packager/
├── main.js              # Electron 主进程
├── preload.js           # 安全 IPC 桥接
├── index.html           # 主界面
├── styles.css           # 样式文件
├── renderer.js          # 渲染进程逻辑
├── package.json         # 项目配置
└── assets/              # 资源文件
```

## 配置说明

应用配置文件存储在 `%AppData%\windows-update-packager\app-config.json`，包含：

- 用户选择的目录路径
- 快照文件路径
- 对比方式偏好

## 许可证

MIT License