轻压 · QZip

一款本地优先、Windows 优先的轻量桌面压缩工具。

拖入文件，即刻完成压缩、解压与压缩包浏览；将复杂选项留给需要它们的人。

Windows 10 / 11 x64 · v1.0.0-rc.2 · Apache-2.0

QZip 目前处于 Windows x64 的 v1.0.0-rc.2 功能收口阶段，重点完善拖放、批量解压、大包浏览和任务诊断体验；macOS 与 Linux 发行计划于 V1.1 提供。详见已知问题与产品路线。

为什么是 QZip

简单开始	安心处理	一目了然
拖放文件或选择压缩包即可进入流程；常用场景使用合理默认值。	压缩采用临时文件提交，解压使用暂存目录合并，降低中断后留下损坏结果的风险。	从任务中心查看实时进度、完成结果与失败原因，并支持取消或重试。

• 本地优先：文件在本机处理，不上传至服务端。
• 格式覆盖：V1.0 目标支持创建 7Z、ZIP、TAR、TAR.GZ、TAR.XZ，并读取、浏览和解压 7Z、ZIP、RAR、TAR、GZ、XZ、BZ2。
• 安全处理：支持密码压缩/解压、7Z 文件名加密、完整性测试与安全写入。
• Windows 集成：面向 Windows 10/11 x64，提供文件关联、Explorer 高频右键菜单与安装/卸载链路。

界面一览

创建压缩包 · 格式、压缩方式与密码按需配置	解压压缩包 · 选择目标目录并处理同名文件
浏览内容 · 在解压前先查看归档内的文件	任务中心 · 集中追踪进行中、已完成与失败任务

快速开始

开发环境

工具	版本
Node.js	24.x
pnpm	11.9.0
Rust	1.96（MSVC 工具链）

pnpm install
pnpm dev

仅启动前端：

pnpm dev:web

常用命令

目标	命令
检查代码质量、测试与 Web 构建	pnpm check
拉取 7-Zip Sidecar（Windows x64）	pnpm sidecar:fetch
校验 Sidecar 的文件与 SHA-256	pnpm sidecar:verify
验证 7Z 创建、列表、测试、解压与 Unicode 路径	pnpm sidecar:test
查看开发者能力入口	cargo run -p qzip-cli -- capabilities
构建 Windows 安装包	pnpm tauri:bundle:windows

Windows 打包前须先执行 pnpm sidecar:fetch。普通开发和 CI 构建不会启用该二进制资源映射，因此无需下载 Sidecar。

项目结构

apps/                 桌面端与开发者 CLI
crates/               压缩后端、安全写入、任务运行时与平台集成
packages/             前端 UI 与共享代码
native/windows/       Windows Shell 与系统集成
scripts/              Sidecar、打包与发布校验脚本
PIC/                  产品界面设计图
docs/                 补充文档

质量与发布

• pnpm check 会依次运行 ESLint、TypeScript、前端测试、Web 构建、Rust 格式检查、Clippy 与 Rust 测试。
• 普通提交只运行 Windows CI。NSIS 安装包通过 GitHub Actions 手动构建；build-only 仅上传内测产物，publish 必须验证受信任签名后才会创建公开 Release。
• 取得代码签名 PFX 后，可在本机运行 powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/configure-github-signing.ps1 -PfxPath <PFX 路径> 配置 GitHub Secrets。自签名证书仅用于内测，不可用于公开可信发布。
• RC 阶段的功能缺口与平台范围请以已知问题为准；需求、验收与后续里程碑以产品需求文档为唯一权威来源。

文档

• 产品需求与验收
• 开发计划与完成状态
• 变更记录
• 已知问题
• 隐私说明
• 卸载说明
• 依赖策略
• 第三方许可证

许可证

本项目采用 Apache License 2.0 许可证。