Krokiet 安装指南：10 分钟离线跑通重复文件清理
【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka
Krokiet 是 Czkawka 的新前端，离线扫描重复文件、空文件夹与相似图片。本文覆盖预构建包的下载、启动、依赖补齐与跑通验证，完成后你的机器上会有一套可用的重复文件清理工具。
项目速览：为什么值得装
单一可执行文件，静态链接。解压即用，不装运行时环境。
不联网、无遥测、无更新检查。扫描全程在本地完成。
左侧边栏共 14 个工具入口，覆盖重复文件、空文件夹、大文件、相似图片等。
缓存只存哈希与元数据，二次扫描明显提速，重复内容不占额外空间。
从零到跑通
前置要求只有一条：Windows 10 及以上、Ubuntu 22.04 及以上，或较新的 macOS。
拿到可执行文件
打开项目发布页，按系统选预构建包：Windows 选windows_krokiet，Linux 选linux_krokiet_x86_64（ARM 机器选_arm64），macOS 选mac_krokiet_arm64（Intel 机器选_x86_64）。解压到固定目录，例如D:\krokiet，保持包内文件结构原样。
Windows 双击**krokiet.exe**，Linux 先执行chmod +x再运行二进制文件，主窗口随即弹出，左侧边栏列出全部工具入口。
单独移动或改名包内文件会让程序丢失依赖，出现异常先恢复原始结构。
补齐可选依赖
如果你需要相似视频或相同音乐这类工具，必须补装 FFmpeg：Windows 执行winget install Gyan.FFmpeg，Linux 执行sudo apt install ffmpeg，macOS 执行brew install ffmpeg。
装完重启程序，选相似视频工具扫描，不再提示找不到ffmpeg，其余工具行为不受影响。
只用重复文件、空文件夹功能可直接跳过，不必为不用的功能装依赖。
完整功能分支：有 Rust 环境时，cargo install krokiet --locked可得到最新构建；追加--features "heif,libraw,libavif"可启用 HEIF、RAW、AVIF 格式支持，Linux 需先安装libheif-dev、libraw-dev、libavif-dev、libdav1d-dev，macOS 用brew install libheif libraw libavif dav1d一次装齐。预构建包不含这些特性，这是两者唯一的功能差异。
跑通验证
- 左侧边栏显示重复文件、空文件夹、相似图片等 14 个工具入口
- 选一个小目录扫描重复文件，结果按组正常显示
- 配置文件已生成：Windows 在
%APPDATA%\Qarmin\Krokiet\config\，Linux 在~/.config/krokiet/，内含config_general.json - 设置里切换界面语言即时生效，多语言均已内置
- 第二次扫描同一目录明显快于第一次，说明缓存已生效 ✅
卡住了怎么办
| 现象 | 处置 |
|---|---|
| 窗口全黑或空白 | 设置环境变量SLINT_BACKEND=software后重启 |
| 相似视频不工作 | 安装 FFmpeg，确认ffmpeg在 PATH 中 |
| 双击没反应 | 确认下载的是 Krokiet 预构建包，检查安全软件 |
| 首次扫描很慢 | 首扫需计算哈希，二扫走缓存会快 |
| HEIF / AVIF 打不开 | 预构建未含该特性，自行编译启用 |
再进一步
- 先拿小范围目录试扫，熟悉各工具行为后再扫全盘，避免误删
- 缓存目录可直接删除释放空间，不影响配置，下次扫描自动重建
- 备份或迁移时整体复制配置目录即可，配置与预设一并带走
- 各工具的完整用法与更多疑难问题，见 instructions/FAQ.md 与 krokiet/README.md
【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
