Linux 日志删除助手

一个用于在 UOS LiveCD 环境中快速清理 Linux 系统磁盘空间的 GUI 工具。

适用场景

同事的 Linux 系统磁盘满了，无法进入桌面。使用 UOS LiveCD 启动后，运行本工具快速清理日志和大文件，恢复系统正常运行。

功能特性

🔍 自动检测磁盘分区 - 列出所有可用分区，自动排除 EFI、swap 和 LiveCD USB 分区
📊 目录大小统计 - 扫描并显示每个目录的占用空间，支持后台线程不阻塞界面
📁 文件浏览器 - 支持浏览子目录，查看文件详情，支持前进/后退/上级目录导航
🗑️ 右键删除 - 支持删除文件和目录，带二次确认防误删
⚡ 快捷删除系统日志 - 检测 /var/log 下大于 1GB 的日志文件，提供一键清理按钮
🔐 自动处理 sudo 权限 - 启动时自动检测 sudo 是否需要密码，需要则弹窗提示

系统要求

Linux 系统（推荐 UOS LiveCD）
Python 3.6+
PyQt5

快速开始

方法 1: 直接运行 Python 脚本

# 安装依赖
sudo apt update
sudo apt install python3-pyqt5

# 运行
sudo python3 main.py

方法 2: 打包为可执行文件

# 在 UOS 环境中打包
chmod +x build.sh
./build.sh

# 运行打包后的程序
sudo ./dist/log-cleaner

操作流程

启动程序 → 输入 sudo 密码 → 选择分区 → 浏览文件 → 删除大文件 → 完成

选择分区 - 程序启动后自动弹出分区选择对话框，显示各分区容量和使用率
浏览文件 - 双击文件夹进入子目录，工具栏支持后退/前进/上级目录
统计目录大小 - 点击"📊 统计目录大小"扫描各目录占用
删除文件 - 右键文件/目录 → 选择删除 → 勾选确认 → 执行删除
快捷删除日志 - 若 /var/log 日志 > 1GB，顶部显示红色快捷按钮

项目结构

├── main.py                 # 程序入口，初始化 QApplication 和 sudo 权限
├── disk_manager.py         # 磁盘分区检测、挂载、卸载
├── file_scanner.py         # 目录大小扫描、文件列表、日志检测
├── utils.py                # 工具函数（sudo 检测、命令执行、格式化）
├── gui/
│   ├── __init__.py
│   ├── main_window.py      # 主窗口（工具栏 + 文件浏览器 + 状态栏）
│   ├── partition_dialog.py # 分区选择对话框（表格显示分区信息）
│   ├── file_browser.py     # 文件浏览器组件（表格 + 导航 + 右键菜单）
│   ├── confirm_dialog.py   # 删除确认对话框（含日志清理确认）
│   └── sudo_dialog.py      # sudo 密码输入对话框
├── build.sh                # UOS 环境打包脚本（PyInstaller）
├── requirements.txt        # Python 依赖
├── readme.md               # 本文件
└── HANDOVER.md             # 交接文档（代码架构详解）

注意事项

删除不可撤销 - 请谨慎操作，重要数据先备份
需要 sudo 权限 - 挂载分区和删除文件需要 root 权限
自动跳过虚拟文件系统 - 扫描时自动跳过 /proc、/sys、/dev 等目录
退出时自动卸载 - 程序退出时会卸载由本工具挂载的分区

常见问题

Q: 为什么看不到某些分区？ A: 程序自动排除 EFI (vfat)、swap、LiveCD USB、光盘镜像 (iso9660) 等分区。

Q: 删除文件时提示权限不足？ A: 请确保以 sudo 运行：sudo python3 main.py

Q: 程序在 UOS LiveCD 上无法运行？ A: 安装 PyQt5：sudo apt install python3-pyqt5

开发说明

开发环境：Windows 10/11
测试/打包环境：UOS LiveCD
依赖管理：pip3 install -r requirements.txt
打包：在 UOS 中运行 ./build.sh

许可证

内部工具，仅供学习和工作使用。

3.9 KiB Raw Blame History Unescape Escape