108 lines
3.9 KiB
Markdown
108 lines
3.9 KiB
Markdown
# 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 脚本
|
||
|
||
```bash
|
||
# 安装依赖
|
||
sudo apt update
|
||
sudo apt install python3-pyqt5
|
||
|
||
# 运行
|
||
sudo python3 main.py
|
||
```
|
||
|
||
### 方法 2: 打包为可执行文件
|
||
|
||
```bash
|
||
# 在 UOS 环境中打包
|
||
chmod +x build.sh
|
||
./build.sh
|
||
|
||
# 运行打包后的程序
|
||
sudo ./dist/log-cleaner
|
||
```
|
||
|
||
## 操作流程
|
||
|
||
```
|
||
启动程序 → 输入 sudo 密码 → 选择分区 → 浏览文件 → 删除大文件 → 完成
|
||
```
|
||
|
||
1. **选择分区** - 程序启动后自动弹出分区选择对话框，显示各分区容量和使用率
|
||
2. **浏览文件** - 双击文件夹进入子目录，工具栏支持后退/前进/上级目录
|
||
3. **统计目录大小** - 点击"📊 统计目录大小"扫描各目录占用
|
||
4. **删除文件** - 右键文件/目录 → 选择删除 → 勾选确认 → 执行删除
|
||
5. **快捷删除日志** - 若 /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`
|
||
|
||
## 许可证
|
||
|
||
内部工具，仅供学习和工作使用。
|