跳过主要内容
L

dsh-zip-verify

lee2277-t/dsh-zip-verify

交付包打出来之后,先验证它真能原样还原。`zip_verify` 逐条解压、核对 CRC32、按哈希与源目录逐文件对账,并报出只能按 GBK 解码的条目名和未打 UTF-8 标记的中文名;`zip_list` 只列条目的大小与压缩方式,不做校验。它自己读中央目录而不依赖外部解压工具,因此不会把一份完全正常的 Compress-Archive 输出看成乱码。

安装

dsh plugin --profile web add github:lee2277-t/dsh-zip-verify

README

dsh-zip-verify

交付包打出来之后,验证它真的能原样还原。

为什么

一个很正常的问题:用 Compress-Archive 打了个包,用 Git Bash 的 unzip 一看, 中文文件名全是乱码,还一堆告警。于是你以为包坏了,重新打一遍,还是一样。

包没坏,是解压工具解错了。 Compress-Archive 写的是 UTF-8 文件名,但经常不设 「UTF-8 标志位」,老工具就按系统代码页去解,于是乱码。

这个工具直接读 zip 的中央目录,按文件里的标志位判断该用什么编码,不给中间工具歪曲的机会。

两个工具

zip_verify

zip_verify D:\build\delivery.zip
4 entries · 599 B 解压后 · verdict: PASS
源目录 : D:\build\dist(4 个文件)

## 校验
  逐条目解压 : 全部成功
  CRC32      : 全部相符
  压缩方式   : deflate

## 编码
  3 个条目名是 UTF-8 内容但没打 UTF-8 标志位(兼容大部分解压工具,个别老工具会乱码)

## 问题
  无 ✅

给 sourceDir 就逐文件对账:

## 问题
  1 个文件内容不一致(sha256):
    ≠ js/app.js

四类问题分别报:缺文件、多文件、内容不一致、CRC 不符。

zip_list

只列条目,不校验。适合先看一眼包里到底装了什么。

几个实现细节

顶层目录自动剥离。 Compress-Archive 会把内容整包进一个与源目录同名的文件夹里, 于是包内路径是 dist/index.html 而源目录是 index.html。逐文件对账会全部失败。 这里会识别这种情况并提示「已剥离」,不是静默改路径。

Zip64。 超过 4 GB 或条目数超过 65535 时,32 位字段会溢出到 Zip64 扩展里。 解析器会读这些扩展,不会对着大包报「字段无效」。

不落盘解压。 条目在内存里 inflate,算完 CRC 和哈希就丢掉。不会在临时目录留一堆文件。

编码三级判定。 标志位说是 UTF-8 就按 UTF-8;没标志位但能按 UTF-8 解通,标成 utf-8 (recovered);解不通再试 GBK,都不行才退回 latin1。

安装

dsh plugin add github:Lee2277-t/dsh-zip-verify

配置

hash: sha256        # 对账哈希,也可用 md5

限制

  • 只读:不创建、不修改 zip。
  • 不支持分卷压缩包。
  • 加密条目无法校验(会报解压失败,不会误判为通过)。

许可

AGPL-3.0-only。

相关插件