Skip to content

Releases: gentrydeng/vzip-cli

Release list

vzip-cli v0.1.0

Choose a tag to compare

@github-actions github-actions released this 24 Oct 21:56
9165f09

更新日志 / Changelog

初始发布。
Initial release.

  • 识别、列出、测试和解压 VZip(VZa)及 VZstd(VSZa);暂不支持 VZd 或创建/修改压缩包。
    Recognize, list, test and extract VZip (VZa) and VZstd (VSZa); VZd and archive creation/update are not supported.

  • 提供独立 vzip.exe CLI 和 7-Zip Formats 插件,分别打包 Windows x64、x86、ARM64,面向 Windows 10/11。
    Provide a standalone vzip.exe CLI and a 7-Zip Formats plugin, packaged separately for Windows x64, x86 and ARM64, targeting Windows 10/11.

  • 验证帧边界、解压大小和 CRC-32;采用 LZMA SDK 和 Zstandard 解码,原创代码以 MIT 许可发布。
    Validate framing, decoded size and CRC-32; decode with the LZMA SDK and Zstandard, with original code under the MIT license.

  • 通过 GitHub Actions 构建、测试并生成制品证明;发布流程复用构建所得 ZIP,提供一份 SHA256SUMS。
    Build, test and attest artifacts with GitHub Actions; the release workflow reuses built ZIPs and provides one SHA256SUMS file.

下载与使用 / Download and usage

本版本读取 VZa 和 VSZa,暂不支持 VZd 或创建/修改压缩包。
This version reads VZa and VSZa; VZd and archive creation/update are not supported.

完整说明与限制请参考仓库中文 README。
See the repository README for full instructions and limitations.

按用途选择组件,再选择架构;源码归档由 GitHub 自动提供。
Choose a component by purpose, then its architecture; GitHub provides source archives separately.

独立命令行工具 / Standalone CLI (vzip.exe)

x64 · x86 · ARM64

7-Zip 格式插件 / 7-Zip Formats plugin (VZip.dll)

x64 · x86 · ARM64

CLI 选择与 Windows 匹配的架构;Formats 必须匹配 7-Zip 进程的架构,即使操作系统是 64 位。
Match CLI architecture to Windows; match Formats to the 7-Zip process, even on a 64-bit OS.

源码下载 / Source downloads

ZIP · tar.gz

使用 CLI:完整解压 CLI 包,在包根目录打开 PowerShell,按下列示例运行。
Use the CLI: extract the entire CLI package and run these examples in PowerShell from its root.

.\vzip.exe test 'example.zip.vz'
.\vzip.exe extract 'example.zip.vz' 'payload.zip'

安装 Formats:完整解压对应包,把 Formats 文件夹复制/合并到 7-Zip 安装目录,关闭旧 7-Zip 进程后重新打开。Program Files 下的复制可能需要管理员权限;替换已有插件前先检查旧版本。
Install Formats: extract the matching package and copy/merge its Formats folder into the 7-Zip installation. Close existing 7-Zip processes and reopen it. Copying under Program Files may require administrator rights; review an installed plugin before replacing it.

包内 README 文件夹提供对应组件的中英文用法,LICENSES 文件夹保留许可和版权通知。
Each package's README folder contains component-specific English/Chinese usage, and LICENSES retains licenses and copyright notices.

SHA256SUMS 只包含上述六个二进制 ZIP 的 SHA-256,不包含 GitHub 自动生成的源码归档。
SHA256SUMS covers only the six binary ZIPs above, excluding GitHub-generated source archives.

以 x64 CLI 为例:下载 vzip-cli-x64.zip 和 SHA256SUMS,保存到同一文件夹,在该文件夹打开 PowerShell。
For the x64 CLI, download vzip-cli-x64.zip and SHA256SUMS into the same folder and open PowerShell there.

Get-FileHash .\vzip-cli-x64.zip -Algorithm SHA256
Select-String -LiteralPath .\SHA256SUMS -SimpleMatch 'vzip-cli-x64.zip'

比较计算结果与清单中的 SHA-256 值,忽略字母大小写;两者应完全一致。
Compare the computed SHA-256 with the value in the list, ignoring letter case; they must match exactly.