Kudu跨平台架构完整解读：Electron如何实现Win、macOS、Linux三端统一系统清理能力

Kudu跨平台架构完整解读：Electron如何实现Win、macOS、Linux三端统一系统清理能力

【免费下载链接】kuduFree Windows, Mac and Linux cleaner, scanner, and more.项目地址: https://gitcode.com/gh_mirrors/kudu1/kudu

Kudu 是一款免费的开源跨平台系统清理工具，基于 Electron 构建，用同一套代码在 Windows、macOS 和 Linux 上提供统一的能力：清理系统与浏览器缓存、扫描恶意软件、管理启动项和服务、监控性能并支持定时扫描。本文带你读懂它的跨平台架构——为什么它能在三个操作系统上保持功能一致，以及这套模式值得你借鉴的几个关键设计。

一、为什么跨平台系统清理这么难？

做清理工具，最难的不是 UI，而是“动手”的部分——删文件、提权、读系统状态，这些操作在三个系统上完全不是一套逻辑：

差异点	Windows	macOS	Linux
提权方式	UAC 管理员清单	osascript 授权	pkexec（polkit）
缓存路径	%TEMP%、AppData	~/Library/Caches	~/.cache
浏览器缓存位置	与应用配置同目录	独立 Caches 目录	独立~/.cache目录
安装包	NSIS / 便携版	DMG / ZIP（x64+arm64）	AppImage / DEB

Kudu 的解法可以概括为一句话：UI 完全统一，系统操作全部抽象，清理知识数据化。下面逐层拆解。

二、三层进程架构：一份 UI 代码跑三端

Kudu 使用 electron-vite 构建，主进程入口 src/main/index.ts 定义了三种运行形态：

• GUI 模式：常规桌面窗口 + 托盘；
• CLI 模式（--cli）：无界面执行清理命令；
• 守护模式（--daemon）：无界面的云端代理进程。

UI 层是标准的 React 应用，与操作系统毫无关系，因此三端界面 100% 一致：

• 构建配置：electron.vite.config.ts（main / preload / renderer 三入口）
• 渲染层入口：src/renderer/index.html

三端之间通信走 IPC。所有通道名集中在 src/shared/channels.ts，按功能分组（cleaner:system:scan、startup:list、debloater:remove等），主进程在 src/main/ipc/index.ts 中统一注册约 40 个功能模块的处理器。

三、平台抽象层：三端能力统一的真正核心 🔑

这是整个架构最漂亮的部分。Kudu 把“操作系统相关”的一切封装进了一个工厂函数：

getPlatform() → 根据 process.platform 返回 win32 / darwin / linux 的 Provider

• 工厂入口：src/main/platform/index.ts
• 统一接口定义：src/main/platform/types.ts

PlatformProvider把系统能力切成 11 个维度，每个平台目录（src/main/platform/win32/、src/main/platform/darwin/、src/main/platform/linux/）各自实现同一套接口：

模块	职责	示例能力
paths	清理目标路径	系统临时目录、浏览器缓存、应用缓存
elevation	提权	UAC / pkexec / 管理员检查
security	安全态势	防火墙、磁盘加密、监听端口
commands	系统命令	关机重启、事件日志、已装应用
startup	启动项	列表 / 开关 / 删除
privacy	隐私设置	检查 + 应用 + 可回滚
services	服务管理	扫描 / 修改启动类型
malware	恶意软件	原生杀毒联动、PE 分析开关
browser	浏览器进程	清理前关闭浏览器
network	网络	连接、DNS 缓存、Wi-Fi 档案

上层业务代码（清理器、扫描器）从不关心当前是哪个系统——它们只调用getPlatform().paths.systemCleanTargets()这类统一 API。这就是“三端统一清理能力”的来源：差异被压在最底层的三个目录里，其余代码全部共享。

对于平台特有的功能（如 Windows 专属的注册表清理、游戏模式），主进程会返回一份功能矩阵，渲染层据此隐藏不适用入口，见 src/main/ipc/index.ts：

features: { registry: isWin, debloater: isWin, drivers: isWin, ... }

四、JSON 规则文件：把清理知识从代码里拆出来

“哪些路径可以清理”这类知识，Kudu 不写死在代码里，而是按平台拆成纯 JSON 规则：

• rules/win32/、rules/darwin/、rules/linux/ 各含 7 类规则（apps、browsers、databases、gaming、gpu-cache、misc、steam、system）
• 规则模式：rules/schema/rules.schema.json
• 编写指南：rules/RULES.md，支持目录：rules/CATALOG.md

加载器 src/main/rules/loader.ts 读取这些 JSON，解析${HOME}等模板变量、归一化路径分隔符，转成统一的PlatformPaths结构供清理引擎使用。这意味着：

1. 添加新应用支持不需要写代码，加一段 JSON 即可；
2. npm run validate:rules可自动校验规则合法性（src/main/rules/validate.ts）；
3. npm run parity-check会检查三端规则的功能对等性（scripts/parity-check.js），防止某平台悄悄漏掉能力。

五、跨平台提权：一个功能的三种实现

删除系统级缓存需要管理员/root 权限，Kudu 对每种系统做了针对性适配：

• Windows：安装包直接声明管理员清单（electron-builder.yml 中requestedExecutionLevel: requireAdministrator），进程常驻管理员权限；
• Linux：通过pkexec提权重启自身，并转发DISPLAY、HOME等 6 个环境变量，再用--kudu-data-dir参数让提权进程继续读写原用户的配置目录，完整实现见 src/main/platform/linux/elevation.ts；
• macOS：不采用管理员重启方案，渲染层直接隐藏相关入口，由界面提示替代。

同一抽象、三份实现、行为互不干扰——这是平台层设计的直接收益。

六、打包发布：一套代码，三种发行格式

发布配置集中在 electron-builder.yml，一个package:all命令产出全部安装包：

• Windows：NSIS 安装包 + 便携版 ZIP/EXE（x64）
• macOS：DMG + ZIP（x64 / arm64），含公证（notarize）
• Linux：AppImage + DEB（x64 / arm64），安装后脚本 scripts/deb-postinstall.sh

配套能力还包括：

• 自动更新：基于 electron-updater，各平台格式均支持（src/main/services/auto-updater.ts）；
• 多语言：30 种语言资源按平台无关的方式组织在 src/renderer/src/locales/；
• CLI 脚本化：无界面模式下同样可以跑清理任务，详见 CLI.md。

七、小结：可复用的跨平台架构清单 ✅

设计	Kudu 的做法	借鉴价值
统一入口工厂	getPlatform()按process.platform分发	消除散落各处的if (win)判断
能力接口化	PlatformProvider11 个维度分模块实现	业务层与操作系统彻底解耦
知识数据化	清理规则用 JSON + Schema 校验	非开发者也能扩展清理支持
功能矩阵降级	平台特性探测 + 界面按需隐藏	优雅处理“某平台没有此能力”
对等性检查	parity-check 脚本保障三端功能一致	防止能力在迭代中漂移

Kudu 证明了一件事：Electron 完全能够承载重度系统级应用——只要把“差异”关进抽象层，把“知识”搬进数据文件。对想构建跨平台桌面工具的团队来说，这个三层架构 + 平台 Provider + JSON 规则的组合，是一套值得直接参考的工程范式。更多架构细节可参考仓库内的 AGENTS.md 与 CONTRIBUTING.md。

【免费下载链接】kuduFree Windows, Mac and Linux cleaner, scanner, and more.项目地址: https://gitcode.com/gh_mirrors/kudu1/kudu