FAQ

FAQ / 常见问题

English

Does Squallz upload my archives?

No. Current product functionality is local-first and does not upload archive contents, file names, paths, passwords, recovery data, or operation history.

Can Squallz create RAR files?

No. Squallz has a read-only RAR bridge path when a compatible external backend is available. It does not create RAR, does not implement RAR recovery records, and does not claim damaged RAR repair.

What should I do with a damaged archive?

Start with:

sqz test archive.zip --json
sqz list archive.zip --json

If you have PAR2 data:

sqz verify archive.zip --use-recovery --json
sqz repair archive.zip --use-recovery -o repaired.zip --json

If it is .sqz:

sqz test archive.sqz --json
sqz repair archive.sqz -o repaired.sqz --json
sqz export repaired.sqz -o repaired.zip --json

How do I handle garbled filenames?

Try an explicit encoding:

sqz list archive.zip --encoding gbk
sqz extract archive.zip -d output --encoding gbk
sqz test archive.zip --encoding shift_jis

Encoding changes affect display and extracted names. They do not modify the original archive.

Why does a format require an external tool?

Some formats are safer or more realistic through packageable external tools such as 7zz/7z, wimlib-imagex, or par2. Squallz reports those dependencies through sqz info --json and sqz doctor.

中文

Squallz 会上传我的压缩包吗？

不会。当前产品功能按本地优先设计，不上传压缩包内容、文件名、路径、密码、恢复数据或操作历史。

Squallz 能创建 RAR 吗？

不能。安装兼容外部后端时，Squallz 可以走只读 RAR 桥接路径。它不创建 RAR，不实现 RAR recovery record，也不承诺修复损坏 RAR。

压缩包损坏怎么办？

先测试和列出：

sqz test archive.zip --json
sqz list archive.zip --json

如果提前生成过 PAR2：

sqz verify archive.zip --use-recovery --json
sqz repair archive.zip --use-recovery -o repaired.zip --json

如果是 .sqz：

sqz test archive.sqz --json
sqz repair archive.sqz -o repaired.sqz --json
sqz export repaired.sqz -o repaired.zip --json

文件名乱码怎么办？

尝试指定编码：

sqz list archive.zip --encoding gbk
sqz extract archive.zip -d output --encoding gbk
sqz test archive.zip --encoding shift_jis

编码切换只影响显示和解压写出的文件名，不会修改原压缩包。

为什么有些格式需要外部工具？

部分格式通过 7zz/7z、wimlib-imagex 或 par2 这类可安装外部工具更现实、更安全。Squallz 会通过 sqz info --json 和 sqz doctor 报告这些依赖状态。