双文件夹备份还原工具

# 备份还原工具 — 使用说明

## 软件作用

这是一款本地文件夹一键备份还原工具，专门用于工作项目、开发工程、文档资料做版本备份。

>
> 日常手动复制文件夹做备份，需要手动新建文件夹、改时间名字，还原时又要手动删除旧文件再拷贝，操作繁琐还容易出错。
> 本软件自动化完成备份、版本还原管理，帮你保存多个历史版本，需要的时候一键回退到任意备份时刻的状态。

**核心能力：**

1. 选择你的【源工作文件夹】（你正在编辑、修改的项目 / 文档目录）
2. 选择【备份存储文件夹】（专门用来存放所有历史备份版本的位置）
3. 一键新建备份：自动复制全部文件，弹窗填写备注，标记这个版本是做什么修改
4. 备份列表直观查看：`备份时间版本 | 自定义备注`，方便区分每一个备份内容
5. 选中历史备份，一键还原：直接把源文件夹恢复到该备份当时的全部文件状态
6. 不需要的备份版本可以直接删除
7. 软件会记忆你设置的两个文件夹路径，重启电脑、重启软件不用重复选择目录
8. **首次打开软件，自动在桌面生成快捷启动图标，方便快速打开工具**

## ✨软件优势（对比手动复制粘贴）

1. **速度更快**
不会无脑全盘重复拷贝，内部做文件遍历统计，复制逻辑经过优化；大量小文件场景，比 Windows 手动复制粘贴更快，减少等待时间。手动复制大文件夹经常卡顿、卡死资源管理器，本工具后台线程执行，界面不会卡死。
2. **版本带备注，方便辨认历史备份**
手动复制只能靠文件夹名字区分；本工具每一次备份可以写备注，例如 “修改 UI 前版本”、“上线前稳定版”，列表直接看到备注，不会搞混哪个备份是哪个状态。
3. **一键还原，不用手动删文件、手动粘贴**
手动还原：要手动把源目录全部删掉，再找到旧备份复制过来，步骤多，容易误删重要文件。
工具只需要选中备份点，点击一键还原，自动清空源目录并恢复备份版本。
4. **路径自动记忆，不用每次重复配置**
手动每次都要找两个文件夹位置；软件把配置保存在本地 ini 文件，电脑重启后打开直接沿用上次设置。
5. **自动跳过无用文件**
备份自动跳过 node_modules、.git、**pycache**、系统缩略图缓存等无用文件夹，**减少备份体积、节省磁盘空间，加快备份速度**，不用自己手动排除。
6. **安全提示，高危操作弹窗确认**
还原、删除备份都会弹出确认框，防止手滑误操作。
7. **纯本地离线工具，不上传任何文件到网络**
所有备份全部保存在你自己电脑硬盘，没有云端，你的项目、文档数据完全留在本机，不用担心泄露。

---

## 📋使用步骤

1. 第一次运行程序：会自动在桌面生成【备份还原工具】快捷方式。
2. 设置【源工作文件夹】：选择你要做备份的项目 / 文档文件夹（正在修改的目录）。
3. 设置【备份存储文件夹】：找一个空余磁盘位置，用来存放所有历史备份版本。

>
> ⚠️注意：源文件夹 和 备份存储文件夹**不能是同一个文件夹**！

4. **新建备份**
点击【一键新建备份】，弹出输入框填写本次备份备注（例如：功能迭代 v1.2），确认后开始备份，等待进度条走完即备份完成。
备份完成会出现在下方列表：`backup_20260922_172010 | 功能迭代v1.2`。
5. **还原历史版本**
① 在列表选中需要回退的那一条备份；
② 点击【一键还原】；
③ 弹出高危确认窗口，确认后软件自动把源文件夹恢复成这个备份当时的全部文件。

>
> ⚠️警告：还原操作会**清空源文件夹现有全部内容**，务必确认再点确认！

6. **删除旧备份**
选中不需要的备份记录，点【删除选中备份】，确认后磁盘上该版本备份会被删除，不可恢复。
7. **刷新列表**
如果手动往备份存储文件夹新增 / 删除过备份文件夹，点【刷新列表】刷新 UI 显示。

## ⚠️重要注意事项

1. 不要移动 exe 程序本体，exe 在哪，配置文件`backup_config.ini`就生成在哪。移动 exe 会丢失旧配置，重新生成配置。
2. 桌面只是快捷方式，删除桌面图标不会删除软件本体，只是不能从桌面启动。
3. 还原会覆盖源目录全部现有文件，重要资料建议除了本工具备份外，额外做一份独立备份作为双重保险。
4. 备份存储文件夹建议放在剩余空间充足的磁盘，备份多了会占用磁盘容量，及时删除无用旧版本释放空间。
5. 程序自动跳过：`node_modules`、`.git`、`__pycache__`、`build`、`dist`、系统缓存文件。如果你的业务需要备份这些目录，需要修改源码内 skip_dirs 列表。

## 📁文件说明

- `备份还原工具.exe`：主程序
- `backup_config.ini`：配置文件，保存你设置的源文件夹、备份存储文件夹路径，请勿手动修改。
- `first_run.tag`：标记文件，标记已经生成过桌面快捷方式，不会重复创建图标。
- 备份存储文件夹内部：每个`backup_时间戳_xxx`文件夹是你的一个历史版本，内部`_backup_note.txt`保存这条备份的备注信息。

## ❓常见问题

Q：重启电脑，配置怎么不见了？
A：你把 exe 剪切移动到别的文件夹了。ini 配置跟随 exe，exe 移动后会重新生成空白配置。

Q：备份完看不到备注？
A：备份完成会自动刷新列表，如果没显示，手动点【刷新列表】按钮。

Q：备份的时候界面卡住不动？
A：大文件数量多的时候进度条会慢慢跑，后台正在复制，等待进度走完，界面不会假死。

Q：可以把备份拷贝到别的电脑吗？
A：可以，把整个`backup_xxxxxx`备份文件夹复制到另一台电脑的【备份存储文件夹】，打开软件点刷新列表，即可识别该备份版本。