[自行打包] 傻瓜式批量解压工具 [1+1.14 MB][老王自建盘]

2636566173

个人习惯一段时间下载一批资源，由于密码不同且需要一个个解压（特别在机械硬盘下等半天），为了解决这个痛点，使用ai开发了一个批量解压工具来解放自己（使用了一段时间，个人使用暂无问题，如果有问题可以回复，到时候统一解决）。

一些话：经常找资源的时候看到有人不会解压+注册好久没发言过，然后就发了这个帖子。如果软件有不趁手的地方可以让ai帮忙修改。第一次发帖如果有不对请指正。

简单说明：
1、需要安装.NET 10运行库。下载地址：https://dotnet.microsoft.com/zh-cn/download/dotnet/10.0
2、强烈建议安装7-Zip，解压速度超级加倍（没有则使用SharpCompress，速度会很慢）。下载地址：https://www.7-zip.org/
将要解压的文件选中拖入文件中就会自动读取（将想尝试的密码一行一个填入解压密码框内，点击保存会保存密码，下次打开软件时就不用再次输入了）点击【开始解压】就可以解放双手了~


以下内容为ai整理的文档。
════════════════════════════════════════════════════════════════
                    批量解压工具 使用文档
════════════════════════════════════════════════════════════════
适用程序：批量解压工具.exe（BatchUnzip，Windows 桌面程序）
文档日期：2026-09-28


────────────────────────────────────────────────────────────────
一、软件简介
────────────────────────────────────────────────────────────────
本工具用于在 Windows 上批量解压压缩文件，把文件或文件夹拖进窗口
即可开始处理。核心功能：

  1. 拖拽操作：整个窗口都支持拖入；拖入文件夹会自动递归遍历所
     有子目录中的文件。
  2. 格式自动识别：按文件头（魔数）判断格式，不依赖扩展名。压
     缩包即使被改名为 .psd、.png、.exe、.mmm 等也能识别解压。
  3. 多密码逐个尝试：预先填好一批密码（每行一个），程序对每个
     压缩包按顺序逐个尝试，并且总是先试"无密码"。
  4. 嵌套解压：解压出的文件里若还有压缩包（包括藏在子文件夹里
     的、分卷集合），会继续解压，直到全部解完。
  5. 分卷合并：支持 X.7z.001/.002/.003 与 X.z01 + X.zip 两类分
     卷命名，自动识别首卷、跳过其余成员；终卷被改名的（如
     X.zip【SHAN】）也能自动兜底处理。
  6. 特殊载体：支持自解压 exe（SFX），以及"图片尾部拼接压缩包"
     的图片载体文件（游戏资源常见）。

源码文件：Form1.cs（界面）、ArchiveUtil.cs（识别与解压核心）、
Program.cs（入口）、BatchUnzip.csproj（工程文件）。


────────────────────────────────────────────────────────────────
二、运行环境（需要的软件与运行库）
────────────────────────────────────────────────────────────────
1. 操作系统
   Windows 10 / Windows 11（x64）。程序界面基于 WinForms，
   仅支持 Windows 系统。

2. .NET 桌面运行库（必需）
   本程序基于 .NET 10 编译（目标框架 net10.0-windows），运行
   必须安装：
       .NET Desktop Runtime 10.0（.NET 桌面运行时 10.0，x64）
   下载地址：
       https://dotnet.microsoft.com/zh-cn/download/dotnet/10.0
   在该页面找到".NET 桌面运行时 10.0.x"，选择 Windows x64 安装
   包下载安装。
   验证方法：命令行执行  dotnet --list-runtimes  ，输出中能看到
   "Microsoft.WindowsDesktop.App 10.x.x" 即安装成功。
   注意：本程序是"框架依赖"发布，发布目录里不包含 .NET 运行库。
   缺少它时双击 exe 会弹出系统提示框要求安装 .NET Desktop
   Runtime，按上面地址装好即可。

3. 7-Zip（可选，但强烈推荐安装）
   程序启动后自动在以下位置查找 7z.exe：
       C:\Program Files\7-Zip\7z.exe
       C:\Program Files (x86)\7-Zip\7z.exe
   - 已安装：所有格式全部交给 7-Zip 解压，速度更快、兼容格式更
     全；分卷由 7-Zip 原生直接处理，无需拼接临时文件。
   - 未安装：自动改用程序内置解压引擎（随附的 SharpCompress
     0.50.4），zip/rar/7z/gzip 等常见格式仍可解压，但速度较慢，
     且 WIM/ESD 等个别格式无法解压。
   7-Zip 官网：https://www.7-zip.org/  使用默认安装路径即可，
   程序无需任何配置。

4. 发布目录自带的文件（必须放在同一目录）
       批量解压工具.exe                    主程序入口
       批量解压工具.dll                    程序主体
       批量解压工具.runtimeconfig.json     运行时配置
       批量解压工具.deps.json              依赖清单
       SharpCompress.dll                   内置解压引擎
       解压密码.txt                        密码文件（可选，见第六节）

5. 从源码编译（开发者）
   前提：Windows 系统 + .NET SDK 10.0 或更高版本。
   步骤：在源码目录（含 BatchUnzip.csproj）打开命令行，执行：
       dotnet build -c Release
   产物输出在  bin\Release\net10.0-windows\  目录。


────────────────────────────────────────────────────────────────
三、安装与启动
────────────────────────────────────────────────────────────────
1. 按第二节装好 .NET 桌面运行时 10.0（推荐再装 7-Zip）。
2. 把整个发布目录（bin\Release\net10.0-windows\）复制到任意位
   置使用。建议放在有写入权限的目录（如 D:\Tools），因为"保存
   密码"功能要在 exe 同目录创建/更新 解压密码.txt；放在
   Program Files 下会因权限不足保存失败。
3. 双击 批量解压工具.exe 即可运行，绿色免安装。
4. 程序窗口标题为"批量解压工具 - 自动识别格式 / 多密码测试 /
   嵌套解压 / 分卷合并"，默认大小 940x600，可自由缩放。


────────────────────────────────────────────────────────────────
四、使用方法（步骤说明）
────────────────────────────────────────────────────────────────
1. 界面布局
   顶部：功能提示文字。
   中部：解压密码输入框（多行文本，每行一个密码）。
   按钮区：[开始解压] [清空列表] [保存密码]
           [√] 快速判断(解出>10个时只检查最大的10个)
   底部：文件列表，四列为 文件 / 状态 / 密码 / 说明；
   右下角为状态栏文字（读入密码数、处理进度、完成统计等）。

2. 添加待处理文件
   把文件或文件夹直接拖到窗口任意位置：
   - 拖入文件夹：自动递归加入所有子目录中的文件；
   - 重复路径自动去重，不会重复处理；
   - 加入后每行状态显示"待处理"，状态栏显示已加入数量。
   不是压缩包的文件也可以一起拖入，处理时会被标记"跳过"。

3. 填写解压密码（可选）
   在密码框中每行填写一个密码。程序对每个压缩包的尝试顺序：
       先试"无密码" → 再按填写顺序逐个尝试（自动去重去空行）。
   点 [保存密码] 可把密码框内容保存到 exe 同目录的
   "解压密码.txt"，下次启动自动读入，不必重复输入。

4. 开始解压
   点 [开始解压]。处理过程中按钮变灰防重复点击，状态栏实时显示
   "处理中 i/N: 文件名"。每个文件处理完后列表立即更新：
   - 状态列：✓ 完成 / ✗ 失败 / ⏭ 跳过；
   - 密码列：该包实际使用的密码（"无"表示原本就没有密码）；
   - 说明列：解压过程摘要（每层解出文件数、继续解压数、失败原因）；
   - 行颜色：绿色=成功，红色=失败，灰色=跳过。
   全部处理完状态栏显示"全部完成: 成功 x,失败 y"。

5. 解压结果的位置
   每个压缩包解压到它旁边同名目录（原完整文件名 + "_解压"）：
       例：D:\download\game.psd
       解压到 D:\download\game.psd_解压\
   分卷集合按集合基础名建目录；嵌套的内层压缩包也在各自旁边生成
   "xxx_解压"子目录。
   注意：
   - 重新处理同一文件时，其专属输出目录会先被清空，保证结果干净；
   - 原始压缩包不会被删除或修改；
   - 合并分卷产生的临时文件用完即自动删除。


────────────────────────────────────────────────────────────────
五、功能详解
────────────────────────────────────────────────────────────────
1. 支持的压缩格式（按文件头自动识别，与后缀无关）
   ZIP、RAR（RAR4/RAR5）、7z、gzip、bzip2、xz、zstd、WIM/ESD、
   tar（含无魔数的老式 V7 tar，靠校验和识别）。
   ※ WIM/ESD 等格式必须安装 7-Zip 才能实际解压，内置引擎不支持。

2. 改后缀 / 伪装文件的识别
   - 压缩包被改成 .psd/.png/.exe/.mmm 等任意后缀 → 照样识别；
   - 自解压 exe（SFX）：自动在文件前 2MB 内扫描内嵌压缩包签名；
   - 图片载体（完整图片后面拼接压缩包）：大于 5MB 的
     PNG/JPG/GIF/BMP/WebP 会做深度检查（带三重结构校验，不会把
     普通大图误判）；小于 5MB 的图片不检查，避免批量扫图变慢。

3. 多密码尝试
   - 每行一个密码，按顺序尝试，自动去重、去空行；
   - 某个密码错误自动换下一个，全部失败才标记"失败"；
   - 总耗时 ≈ 包数 × 密码数，密码很多时建议把最可能的放前面；
   - 无密码的包不受密码列表影响（总是先试无密码）。

4. 嵌套解压
   解压出的文件里如果还有压缩包（含子文件夹里的、分卷集合），
   会自动入队继续解压，直到没有可解压文件，或达到 20 层深度上限
   （防止自我包含的压缩包死循环）。
   示例：a.zip → 里面是 b.rar → 里面是 c.7z.001 三卷分卷 →
   自动合并解压，一路解到最内层普通文件为止。

5. 分卷压缩包
   支持两种命名风格：
   - X.7z.001 / X.7z.002 / ...（入口=首卷 .001）
   - X.z01 / X.z02 / ... + X.zip（入口=终卷 .zip）
   使用要点：
   - 整组分卷必须放在同一目录、文件名保持配套；
   - 把整组一起拖入即可：只有首卷（或终卷 .zip）触发解压，其余
     成员自动标记"跳过"，属正常现象；
   - 终卷被下载站改名的（如 X.zip【SHAN】）会自动复制规范命名后
     再解压；
   - 已安装 7-Zip 时分卷由 7-Zip 原生处理；未装 7-Zip 时程序自
     动拼接成临时文件再解压。

6. 快速判断选项（默认勾选）
   控制"解压结果里是否还有压缩包"的检查范围：
   - 勾选：本层解出的顶层条目（文件+文件夹）超过 10 个时，视为
     已是最终的大目录结构，只对顶层最大的 10 个文件做压缩包判
     断，不进入子文件夹。速度快，但极少数"藏在子文件夹里的小压
     缩包"不会被继续解出；
   - 不勾选：每层对所有文件（含全部子文件夹）做完整判断，最彻
     底，但文件很多时明显变慢。
   建议：日常保持勾选；怀疑结果里还有未解出的压缩包时，取消勾
   选重新处理。


────────────────────────────────────────────────────────────────
六、密码文件（解压密码.txt）
────────────────────────────────────────────────────────────────
- 位置：必须与 批量解压工具.exe 在同一目录；
- 格式：UTF-8 纯文本，每行一个密码，空行自动忽略；
- 启动时自动读入密码框，状态栏提示"已从 解压密码.txt 读入 N 个
  密码"；文件不存在不影响使用，只是密码框为空；
- 点 [保存密码] 会把当前密码框内容写回该文件；
- 密码可含中文、特殊字符，按整行读取（自动去掉首尾空格）。


────────────────────────────────────────────────────────────────
七、命令行自检（可选）
────────────────────────────────────────────────────────────────
在命令行执行：
    批量解压工具.exe --selftest
程序以无界面方式自动构造各类测试压缩包做全流程自检（魔数识别、
嵌套解压、分卷合并、快速判断、图片载体等 16 个场景）。全部通过
输出 SELFTEST OK 且退出码为 0；任一失败输出 SELFTEST FAIL 且退
出码为 1。可用于验证运行环境与核心功能是否正常。


────────────────────────────────────────────────────────────────
八、常见问题（FAQ）
────────────────────────────────────────────────────────────────
Q1 双击 exe 提示"必须安装 .NET Desktop Runtime"？
   A：缺少 .NET 桌面运行时 10.0（x64），按第二节第 2 条下载安装。

Q2 解压速度慢？
   A：安装 7-Zip 后重新启动本程序，所有格式自动改用 7-Zip 解压，
      速度明显更快；密码太多也会拖慢速度，按可能性排序、删掉没
      用的密码。

Q3 为什么很多文件显示"⏭ 跳过"？
   A：两种情况均正常：① 文件本身不是压缩包（按文件头判断）；
      ② 它是分卷压缩包的非首卷成员，已由首卷统一处理。

Q4 提示"解压失败(所有密码均不对或文件损坏)"？
   A：核对密码是否正确、是否每行只有一个；无需密码的包也失败时，
      可能文件已损坏，或该格式（如 WIM/ESD）只有 7-Zip 支持而本
      机未装 7-Zip。

Q5 解压出的文件夹里还有压缩包没被继续解压？
   A：可能被"快速判断"跳过了（见第五节第 6 条）。取消勾选后重
      新拖入处理即可。

Q6 极大的压缩包处理会不会卡死？
   A：每个包（每次密码尝试）有 10 分钟解压时限，超时会终止并标
      记失败；特别大的包请耐心等待或分批处理。

Q7 密码含中文/特殊字符可以吗？
   A：可以，按整行读取。注意一个密码必须独占一行。

Q8 保存密码提示失败？
   A：程序目录没有写入权限（如放在 Program Files）。把程序移动
      到普通目录（如 D:\Tools）再保存。

Q9 想从头重跑某个包？
   A：直接再次点"开始解压"即可；该包的专属输出目录会先清空再解，
      结果可复现。


────────────────────────────────────────────────────────────────
九、注意事项
────────────────────────────────────────────────────────────────
1. 请确保对所处理的文件拥有合法使用权。
2. 解压会在源文件旁生成"_解压"目录，注意磁盘剩余空间；大批量
   处理前建议先用少量文件试跑，确认密码与效果无误后再全量跑。
3. 程序逐个文件串行处理，不并发；处理过程中请勿移动、重命名或
   删除正在处理的文件及其所在目录。
4. 程序不会删除、修改原始压缩包；分卷合并的临时文件用后即删，
   但解压中途强制关闭程序时可能残留临时文件（系统临时目录下的
   GUID 命名文件），可定期清理 %TEMP%。

════════════════════════════════════════════════════════════════
                          文档结束
════════════════════════════════════════════════════════════════