桌面应用【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址https://gitcode.com/GitHub_Trending/cz/czkawka点击查看免费下载Czkawka 是一个多功能的重复文件、空目录、相似图片等清理工具而czkawka_gui是它基于 GTK4 的官方图形前端负责把 czkawka_core 的扫描引擎以可视化的方式呈现给用户。本文以仓库内 czkawka_gui/CLAUDE.md 架构指南为主线结合src/下的真实实现逐层拆解其源码布局、中央数据结构GuiData、扫描线程模型、结果填充管线、语言切换与配置持久化机制读完即可对如何给 GTK4 应用接入 Rust 扫描引擎这一经典模式形成完整的实战认知。项目定位与维护状态czkawka_gui是 Czkawka 项目三大程序之一其余为 CLI 工具 czkawka_cli 与新一代 Slint 前端 krokiet当前版本为12.0.1见 Cargo.toml。需要特别注意的是它的维护状态Status: Maintenance mode only——不再开发新功能仅接受与czkawka_coreAPI 变更保持兼容的 Bug 修复。这意味着它的架构相对稳定非常适合作为GTK4 Rust 扫描引擎的参考实现来阅读而新功能开发的工作重心已经转移到 Krokiet 前端仓库中 krokiet 目录czkawka_gui甚至会在首次启动时弹出一则 Krokiet 迁移提示对话框见下文 main.rs 的启动流程。整体架构概览从 CLAUDE.md 的 Overview 可以提炼出三条架构主线GTK4 前端UI 使用 XML 描述XML 文件由CambalacheGTK UI 设计器编辑工程源文件是 ui/czkawka.cmb编译时通过include_str!直接嵌入二进制。Notebook标签页接口czkawka_core中所有扫描工具都通过一个 11 个标签页的 notebook 暴露给用户——每个标签页对应一个工具重复文件、空文件夹、大文件、空文件、临时文件、相似图片、相似视频、同音乐、失效符号链接、损坏文件、错误扩展名。核心/前端分离扫描逻辑完全位于czkawka_core前端只负责参数收集、线程调度、进度展示与结果渲染。值得注意的是czkawka_core的工具总数与 GUI 标签数并不相等。在 main.rs 中有这样一行常量pub const CZKAWKA_GTK_TOOL_NUMBER: usize TOOLS_NUMBER - 3; // Missing exif, video optimizer, bad names tools即 GTK 前端故意少暴露了 3 个工具EXIF 移除、视频优化、坏文件名——它们只在 CLIczkawka_cli和 Krokiet 前端中提供。这是阅读源码时容易踩坑的一个细节。源码布局逐层解读src/顶层应用生命周期文件职责关键实现main.rsGTK Application 搭建、GuiData构造入口与回调接线initialize_gui.rs初始控件状态启动时复位各开关compute_results.rs扫描结果 → GTK ListStore 行结果填充管线saving_loading.rsJSON 设置读写SettingsJson serdelanguage_functions.rs语言常量LANGUAGES_ALLlocalizer_gui.rsflg!宏、Fluent 加载国际化notebook_enums.rs标签页索引枚举NotebookMainEnumnotebook_info.rs每个标签页的列/按钮定义NOTEBOOKS_INFOhelp_combo_box.rs下拉框选项数组哈希算法、检查方式等help_functions.rs行颜色常量、按钮管理HEADER_ROW_COLOR等opening_selecting_records.rs双击打开文件/文件夹行选择辅助taskbar_progress.rsWindows 任务栏进度真实实现taskbar_progress_dummy.rs非 Windows 平台的空实现no-optaskbar_progress_win.rsWindows 任务栏 API 调用WinAPIgtk_traits.rs自定义 GTK trait 扩展便捷方法应用启动流程main.rsmain.rs 的启动顺序很有参考价值注册图片解码钩子register_image_decoding_hooks()调用set_config_cache_path(Czkawka, Czkawka)确定配置/缓存目录Krokiet 提示逻辑检查缓存目录下是否存在krokiet_info_dialog_seen2.txt标记文件不存在则创建若配置/缓存路径未通过环境变量覆盖、标记文件不存在且未设置CZKAWKA_DONT_ANNOY_ME环境变量则在 UI 构建完成后弹出 Krokiet 迁移提示对话框注册connect_command_line处理 CLI 参数由czkawka_core的process_cli_args解析支持--included-directories等参数直接指定扫描范围build_ui()中依次完成构建GuiData→ 初始化控件 → 复位配置 → 读取系统语言 → 从 JSON 加载配置 → 设置线程数 → 逐一接线全部回调。启动时先加载系统语言、再加载配置文件的顺序load_system_language在load_configuration之前在源码注释中明确标注这是为了保证系统语言优先、配置文件中的语言设置随后生效。ui/目录Cambalache 生成的 XMLui/下的.ui文件全部由 Cambalache 从 czkawka.cmb 工程文件导出运行时通过gtk4::Builder::from_string(include_str!(../../ui/main_window.ui))加载见 gui_data.rs。文件内容main_window.ui约 65 KB 的主窗口完整布局含全部标签页settings.ui设置对话框compare_images.ui图片对比面板popover_select.ui选择过滤器 popoverpopover_sort.ui排序 popoverpopover_right_click.ui右键上下文菜单 popoverabout_dialog.ui关于窗口progress.ui扫描进度对话框Cambalache 是这些 XML 的唯一事实来源source of truth这意味着想改布局应该回到.cmb工程文件编辑再导出而不是手改.ui。GuiData连接所有 UI 组件的中央结构体GuiData是前端最核心的数据结构定义在 gui_structs/gui_data.rs。它把主窗口、两个 notebook、底部按钮、进度窗口、设置、头部菜单、图片对比面板、about 对话框、popover、文本入口、错误视图、文件对话框、任务栏状态与停止标志全部聚合在一起通过 clone/reference 传给每一个回调#[derive(Clone)] pub struct GuiData { pub window_main: gtk4::Window, pub main_notebook: GuiMainNotebook, // 11 个工具标签页 pub upper_notebook: GuiUpperNotebook, // 目录配置包含/排除 pub popovers_select: GuiSelectPopovers, // 选择过滤器 pub popovers_sort: GuiSortPopovers, // 排序过滤器 pub bottom_buttons: GuiBottomButtons, // 操作按钮搜索、删除等 pub progress_window: GuiProgressDialog, // 扫描进度窗口 pub about: GuiAbout, // 关于对话框 pub settings: GuiSettings, // 设置对话框 pub header: GuiHeader, // 菜单栏 pub compare_images: GuiCompareImages, // 并排图片差异对比 pub file_dialog_include_exclude_folder_selection: FileChooserNative, pub file_dialog_move_to_folder: FileChooserNative, pub taskbar_state: RcRefCellTaskbarProgress, pub shared_buttons: RcRefCellHashMapNotebookMainEnum, HashMapBottomButtonsEnum, bool, pub entry_info: gtk4::Entry, // 状态提示输入框 pub text_view_errors: gtk4::TextView, // 错误信息文本 pub scrolled_window_errors: gtk4::ScrolledWindow, pub stop_flag: ArcAtomicBool, // 向扫描线程发送停止信号 }GuiData::new_with_application()gui_data.rs的构造要点Builder 一次性加载整个main_window.ui各子结构GuiUpperNotebook、GuiMainNotebook、GuiBottomButtons等通过create_from_builder(builder)从同一 Builder 中取出自己的控件引用原生文件对话框必须常驻内存两个FileChooserNative在构造时创建、select_multiple分别设为true目录选择与false移动目标目录源码注释解释了原生对话框必须一直存在与普通对话框相反这一 GTK4 行为按钮状态映射shared_buttons默认每个标签页只显示搜索按钮其余按钮删除、保存、硬链接、符号链接、移动、对比、排序在对应工具找到结果后才激活stop_flag是ArcAtomicBool用于向工作线程发送取消信号详见下一节。GuiData还承担语言刷新职责update_language()会依次调用所有子结构的update_language()用flg!宏重设每个控件标签。扫描线程架构Search 按钮背后的完整链路扫描是前端最复杂的交互流程CLAUDE.md 给出了抽象流程图下面结合 connect_button_search.rs 还原每个环节的真实代码。抽象流程用户点击 Search → connect_button_search.rs → 禁用 UI、显示进度窗口 → 生成工作线程 - 从 GTK 控件读取设置 - 创建工具结构体如 DuplicateFinder - 调用 tool.search(stop_flag, progress_sender) - 通过 result_sender 发送 Message::Duplicates(tool) → 主线程接收进度更新 → 刷新进度条 → 收到结果后 - compute_results.rs 处理工具数据 → 追加到 ListStore - 重新启用 UI、隐藏进度两条 channel 的分工SenderMessage一次性结果通道携带携带完整数据的工具枚举Message::Duplicates(DuplicateFinder)等定义见 helpers/enums.rsSenderProgressData核心引擎实时推送的进度数据通道驱动进度窗口的进度条。两个通道都在 main.rs 用crossbeam_channel::unbounded()创建然后分别交给connect_button_search发送端和connect_compute_results/connect_progress_window接收端。工具分发与参数收集点击事件处理器先检查是否已把全部包含目录标记为参考目录check_if_list_store_column_have_all_same_values然后按当前标签页分发到 11 个独立搜索函数connect_button_search.rsmatch current_data.get_current_page() { NotebookMainEnum::Duplicate duplicate_search(gui_data, loaded_commons, stop_flag, result_sender, grid_progress, progress_sender), NotebookMainEnum::EmptyFiles empty_files_search(...), NotebookMainEnum::EmptyDirectories empty_dirs_search(...), NotebookMainEnum::BigFiles big_files_search(...), NotebookMainEnum::Temporary temporary_files_search(...), NotebookMainEnum::SimilarImages similar_image_search(...), NotebookMainEnum::SimilarVideos similar_video_search(...), NotebookMainEnum::SameMusic same_music_search(...), NotebookMainEnum::Symlinks bad_symlinks_search(...), NotebookMainEnum::BrokenFiles broken_files_search(...), NotebookMainEnum::BadExtensions bad_extensions_search(...), }公共参数统一由LoadedCommonItems::load_items()从 GTK 控件读取包括包含/排除/参考目录、递归搜索、排除项逗号分隔、允许/排除扩展名、隐藏硬链接、使用缓存、同时保存 JSON、最小缓存文件大小、最小/最大文件大小、是否忽略其他文件系统。随后通过泛型函数set_common_settingsT: CommonData(mut tool, loaded_commons)connect_button_search.rs批量写入工具结构体——这是czkawka_core的CommonDatatrait 统一抽象的价值所在。以重复文件工具为例完整线程调用链connect_button_search.rsthread::Builder::new() .stack_size(DEFAULT_THREAD_SIZE) .spawn(move || { let params DuplicateFinderParameters::new( check_method, hash_type, use_prehash_cache, loaded_commons.minimal_cache_file_size, minimal_prehash_cache_file_size, case_sensitive_name_comparison, ); let mut tool DuplicateFinder::new(params); set_common_settings(mut tool, loaded_commons); tool.set_delete_outdated_cache(delete_outdated_cache); tool.search(stop_flag, Some(progress_data_sender)); result_sender.send(Message::Duplicates(tool)).expect(Failed to send Duplicates message); }) .expect(Failed to spawn DuplicateFinder thread);要点每个工具都在独立线程中运行search(stop_flag, Some(progress_sender))其中 stop_flag 与 progress_sender 都是跨线程共享的每个工具各有自己的参数结构体如SimilarImagesParameters、SimilarVideosParameters、SameMusicParameters从对应下拉框/滑杆读取部分高级参数如相似视频的check_audio_content在 GTK 前端中未实现直接以硬编码常量传入扫描期间主 UI两个 notebook、设置按钮、信息按钮全部set_sensitive(false)锁定进度条复位为 0错误视图被清空点击 Search 时stop_flag.store(false)先清除旧标志取消扫描由 connect_button_stop.rs 置为true。结果填充管线compute_results.rs结果回传由 compute_results.rs 负责。它在glib::spawn_future_local中开启一个异步循环每 300ms 用try_recv()轮询结果通道compute_results.rs收到Message后按类型调用对应的compute_*函数。核心流程以 DuplicateFinder 为例收到Message::Duplicates(DuplicateFinder)handle_stopped_search()检查是否被用户中止若是则提示已停止从get_information()提取重复文件数、组数、可回收空间构造flg!翻译消息写入entry_info从工具中取出排序好的分组数据按CheckingMethod分别取自get_files_sorted_by_hash/get_files_sorted_by_size/get_files_sorted_by_names/get_files_sorted_by_size_name参考目录模式则用_referenced变体每个分组先插入一个header 行着色为HEADER_ROW_COLOR再为每个文件插入main 行MAIN_ROW_COLORappend_row_to_list_store()把单个单元格写入gtk4::ListStorefinalize_compute()将工具对象存入SubView.shared_model_enum供后续选择/排序回调复用compute_results.rs。行颜色与列定义行颜色定义在 help_functions.rspub const MAIN_ROW_COLOR: str #222222; pub const HEADER_ROW_COLOR: str #111111; pub const TEXT_COLOR: str #ffffff;每个工具的列索引是编译期枚举helpers/enums.rs例如重复文件有 11 列ActivatableSelectButton、SelectionButton、Size、SizeAsBytes、Name、Path、Modification、ModificationAsSecs、Color、IsHeader、TextColor。每个标签页的完整列 schema列类型、底部可用按钮、TreeView 名称集中定义在 notebook_info.rs 的NOTEBOOKS_INFO静态数组中前端其余模块都从这里读取元信息做到了一份定义、多处复用。并行排序与参考目录结果在渲染前使用rayon 并行排序vector.par_sort_unstable_by(|a, b| split_path_compare(a.get_path(), b.get_path()))compute_results.rs超过 2 个元素才排序少于则原样返回避免无谓开销。参考目录模式下渲染逻辑略有不同第一个文件作为基准行header 样式直接显示完整信息其余文件作为对照行且相似图片会按相似度差值difference升序排列选择函数也会切换为select_function_always_true以保证基准文件始终可选。语言切换机制前端支持多语言语言常量表定义在 language_functions.rsLANGUAGES_ALL: [Language]中每个条目包含combo_box_text下拉框显示名与short_textBCP-47 代码。文档标注为 26 项当前源码中实际列出了 27 个条目覆盖英文、法文、意大利文、波兰文、俄文、乌克兰文、韩文、捷克文、德文、日文、葡萄牙文含巴西、简体中文、繁体中文、西班牙文、挪威文、瑞典文、阿拉伯文、保加利亚文、希腊文、荷兰文、罗马尼亚文、土耳其文、波斯文、印地文、印尼文、越南文等。语言切换的三步流程由 connect_change_language.rs 驱动从选中下拉项查short_text同时调用localizer.select([lang_id])切换czkawka_core与czkawka_gui两套 Fluent 本地化器核心引擎的提示文本也会随之翻译调用gui_data.update_language()向所有子结构传播各子结构通过flg!(key)宏更新控件标签。应用启动时会调用load_system_language()尝试匹配系统默认语言。设置持久化JSON 配置的读写细节存储路径设置以 JSON 保存文件名为czkawka_gui_config.jsonsaving_loading.rs。实际路径由czkawka_core的get_config_cache_path()决定——默认位于用户配置目录Linux 下即~/.config/Czkawka/czkawka_gui_config.json并支持通过CZK_CONFIG/CZK_CACHE环境变量覆盖main.rs 启动时调用的set_config_cache_path(Czkawka, Czkawka)。SettingsJson 结构配置模型SettingsJsonsaving_loading.rs用 serde 序列化每个字段都带#[serde(default ...)]默认函数——这样某个字段缺失或损坏不会导致整个反序列化失败这是长期运行工具非常实用的健壮性设计。字段覆盖五类内容目录配置included_directories、reference_directories、excluded_directoriesUnix 默认排除/proc、/dev、/sys、/snapWindows 默认排除C:\Windows工具参数重复文件的检查方式/哈希类型/大小写敏感/预哈希缓存、相似图片的哈希大小/缩放算法/相似度、相似视频的相似度容差、大文件数量默认 50、坏文件检查类型PDF/音频/图片/压缩包/视频、音乐相似度维度等UI 状态是否显示底部文本面板、是否显示图片预览、语言偏好行为开关退出保存/启动加载、删除前确认文件/整组/链接、删除到回收站、隐藏硬链接、使用缓存、同时保存 JSON 缓存等通用默认值最小文件大小默认1638416 KB、最大文件大小默认999999999999、最小缓存文件大小默认257144字节。保存发生在窗口关闭时connect_close_request见 main.rs且使用非默认 CLI 参数启动时不保存避免把临时扫描参数写回配置。关键依赖与可选 FeatureCLAUDE.md 的依赖表与 Cargo.toml 完全对应整理如下Crate版本用途gtk40.11GTK4 GUI 框架v4_6featuregdk40.11绘制/渲染配合 gdk-pixbuf 显示图片glib0.22事件循环、spawn_future_locali18n-embedrust-embed0.16 / 8.5Fluent 翻译嵌入与加载open5.3调用系统文件管理器image0.25预览缩略图jpeg/pngresvg0.47SVG 图标缩放rayon1.10结果并行排序crossbeam-channel0.5结果 进度通道czkawka_core12.0.1扫描引擎path 依赖serde/serde_json1.x配置序列化humansize2.1人类可读文件大小格式化chrono0.4时间戳格式化fun_time0.3耗时统计日志#[fun_time]可选 features转发给czkawka_coreheifHEIF 图片、librawRAW 格式、libavifAVIF 图片、xdg_portal_trashLinux Flatpak 环境下通过 xdg-portal 使用回收站——普通回收站访问在 Flatpak 中总是失败此选项更慢但错误提示更友好其他系统上为 no-op。注释规范与协作约定最后一条约定关乎代码风格注释短而克制——遵循仓库根 AGENTS.md 的准则只在代码行为无法从阅读本身推断时才写注释例如非显然的约束、workaround、跨模块耦合绝不复述代码已表达的内容。这一约定解释了为什么czkawka_gui源码中注释密度很低、但每一条注释如原生对话框必须常驻内存都直指一个真实的坑。小结一张图看懂 czkawka_guiUI 层Cambalache 导出 XML →gtk4::Builder加载 →GuiData聚合全部控件交互层connect_*回调统一以GuiData为上下文负责参数收集与按钮/进度/语言管理并发层每个工具一个独立线程stop_flagArcAtomicBool控制取消progress_sender推送实时进度result_sender一次性回传携带完整数据的工具对象渲染层compute_results.rs在 GLib 主循环中轮询结果通道按分组插入 header/main 行rayon 并行排序最后把工具对象存入shared_model_enum供后续选择、排序、删除、移动、硬链接/符号链接、保存CSV/JSON、图片对比等操作复用。对想要理解如何为 Rust 扫描引擎编写 GTK4 前端的开发者而言czkawka_gui这套中央结构体 双通道线程模型 ListStore 渲染管线的模式是一份结构清晰、可直接借鉴的完整参考。赞分享桌面应用【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址https://gitcode.com/GitHub_Trending/cz/czkawka点击查看免费下载相关推荐RunCat 365完整指南10分钟修好任务栏猫咪卡顿与启动报错RunCat 365完整指南10分钟修好任务栏猫咪卡顿与启动报错 RunCat 365 是一款住在 Windows 任务栏里的轻量级系统资源监视器一只小猫在桌面应用CleanRL 快速上手手把手跑通第一个 PPO 强化学习实验CleanRL 快速上手手把手跑通第一个 PPO 强化学习实验 CleanRL 是一个单文件风格的深度强化学习DRL即智能体通过与环境交互来学习决策策略的桌面应用CloudNativePG PostgreSQL 大版本升级完全指南从 Minor 滚动更新到离线 In-Place 就地升级CloudNativePG PostgreSQL 大版本升级完全指南从 Minor 滚动更新到离线 In Place 就地升级 本文以 CloudNative桌面应用上一篇3大突破重新定义Markdown编辑体验下一篇3分钟生成爆款短视频MoneyPrinterTurbo AI视频生成完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考