关于 Czkawka 的常见问题
这里汇总了用户最常问的问题。如果没有找到你的疑问，欢迎在 GitHub Issues 中反馈。
Czkawka 是免费的吗？会有付费版吗？
Czkawka 完全免费，遵循 MIT/GPL 双协议开源。所有功能对所有用户一视同仁，未来也不会推出付费版、Pro 版或订阅版。软件不内置任何广告、推广或诱导付费内容。源代码托管于 GitHub，任何人都可以自由审计、修改、二次分发。
Czkawka 会上传我的数据吗？隐私安全吗？
不会。Czkawka 是完全离线的软件，不联网、不上传任何用户数据、不收集任何统计信息或使用遥测。所有扫描和清理操作都在本地完成，你的文件内容永远不会离开你的设备。这一点是项目从第一天就确立的硬性原则，源代码完全开源可审计。
如果不小心删除了重要文件怎么办？
建议在设置中将删除方式改为"移动到回收站"而非永久删除，这样误删的文件可以从系统回收站恢复。Czkawka 默认就采用回收站方式，提供一层安全保护。如果已经永久删除且无法从回收站恢复，可以尝试使用专业的数据恢复工具（如 PhotoRec、TestDisk）进行抢救，但成功率取决于磁盘写入活动。
为什么我的扫描速度比宣传的慢？
扫描速度受多种因素影响：磁盘类型（机械硬盘慢于 SSD）、文件总数、是否首次扫描（无缓存）、CPU 核心数、文件平均大小等。机械硬盘扫描百万级文件可能需要数分钟，而 NVMe SSD 通常在 30 秒内完成。建议：（1）将常用目录的扫描添加到缓存；（2）关闭不必要的清理工具；（3）扫描时减少其他高 IO 操作。
Krokiet 和 Czkawka GTK 有什么区别？应该用哪个？
Krokiet 是基于 Slint 框架的新一代 GUI，是未来的主推版本，提供更现代的视觉与更流畅的交互。Czkawka GTK 是基于 GTK 4 的经典版本，已发布 v12.0 最终版本，不再提供新功能更新。新用户推荐直接使用 Krokiet；老用户也建议迁移到 Krokiet 以获得持续更新。功能层面两者完全一致，因为底层都使用同一个 czkawka_core 核心库。
相似图片的相似度阈值应该怎么设置？
默认阈值为 80%，适合大多数场景。如果需要更严格的匹配（只找出几乎相同的图片），可以调高到 90% 以上；如果想找出更多潜在相似（包括轻微编辑、加水印的版本），可以降低到 60-70%。建议初次使用先用小目录试扫，根据预览结果调整阈值，找到最适合自己需求的平衡点。
macOS 提示"无法打开，因为无法验证开发者"怎么办？
这是 macOS 的安全机制 Gatekeeper。解决方法：（1）右键点击应用图标，选择"打开"，在弹窗中再次确认"打开"即可；（2）或在"系统设置 > 隐私与安全性"中，找到提示"Czkawka 已被阻止"的条目，点击"仍要打开"。两种方法只需执行一次，之后即可正常启动。也可以通过命令 xattr -d com.apple.quarantine /Applications/Czkawka.app 移除隔离属性。
Windows Defender 误报病毒怎么办？
Czkawka 是完全开源的软件，源代码可审计，不含任何恶意代码。Windows Defender 偶尔会因为 Rust 编译产物的特征而误报。解决方法：（1）从 GitHub Releases 官方页面下载，并核对 SHA256 校验和；（2）在 Windows 安全中心将 Czkawka 添加到排除列表；（3）将误报情况反馈给 Microsoft 以改进检测规则。我们绝不在软件中植入任何病毒、木马或间谍代码。
支持哪些文件格式？
Czkawka 的文件格式支持非常广泛：图片支持 JPEG/PNG/HEIC/WebP/GIF/BMP/TIFF/RAW 等 20+ 格式；视频支持 MP4/MKV/MOV/AVI/WebM/FLV 等主流容器与 H.264/H.265/AV1/VP9 等编码；音频支持 MP3/FLAC/AAC/OGG/WAV 等格式；文档支持 PDF/DOCX/XLSX/PPTX 等；归档支持 ZIP/7Z/RAR/TAR/GZ 等。损坏文件检测能验证上述所有格式的完整性。
CLI 版本如何集成到自动化脚本？
CLI 版本支持输出 JSON 格式结果，便于 jq / Python / Shell 处理。典型用法：czkawka cli dup --directories /home/user --output-format json > result.json。配合 cron 或 systemd timer 即可实现定时清理。完整参数请运行 czkawka cli --help 查看。
能否扫描网络驱动器或云盘挂载点？
可以扫描任何被操作系统识别为本地路径的目录，包括 SMB/CIFS 挂载、NFS 挂载、WebDAV 挂载、rclone 挂载等。但网络驱动器的扫描速度受网络带宽与延迟影响，通常远慢于本地磁盘。建议先在小目录上测试，确认网络性能可接受后再进行全盘扫描。
扫描结果中"重复"的判定标准是什么？
Czkawka 采用三级渐进式判定：（1）首先按文件大小筛选，只有大小完全相同的文件才进入下一阶段；（2）然后计算文件首尾各 1MB 的部分哈希进行比对，剔除大部分非重复；（3）最后对仍存疑的文件计算完整 SHA256 哈希，哈希值完全相同才判定为重复。这种策略在保证准确性的同时极大提升了扫描速度。
如何为项目贡献代码或翻译？
代码贡献：Fork 仓库，创建 feature 分支，提交 PR 即可。复杂功能建议先在 Issue 中讨论方案。翻译贡献：访问项目在 Crowdin 的翻译页面，选择你的语言即可在线编辑翻译，无需任何技术背景。我们特别欢迎中文、英文、日文、法文等主流语言的翻译完善。
商用环境可以使用吗？需要授权吗？
可以商用，无需任何授权。Czkawka 遵循 MIT 协议（Czkawka GUI/CLI）和 GPL-3.0 协议（Krokiet/Cedinia）。MIT 协议允许在闭源商业项目中自由使用；GPL-3.0 协议要求如果你的项目分发包含 Krokiet 代码，则整个项目也需开源。绝大多数企业内部使用（不对外分发）均不受 GPL 限制，可放心使用。
支持中文界面吗？
支持。Czkawka 内置多语言支持，包含中文（简体）、中文（繁体）、英语、波兰语、意大利语、德语、法语、俄语等十多种语言。首次启动会自动检测系统语言并切换。如需手动切换，在设置中选择"语言"即可。翻译由社区维护，欢迎在 Crowdin 上帮助完善中文翻译质量。
遇到 Bug 或有功能建议如何反馈？
请在 GitHub Issues 中提交反馈。Bug 报告请包含：操作系统与版本、Czkawka 版本号、复现步骤、预期与实际行为截图。功能建议请描述具体使用场景与期望效果。我们会定期审阅所有 Issue，并在每个版本发布说明中列出已解决的问题。也可以加入 GitHub Discussions 与社区其他用户交流。
