# 轻澈

**Repository Path**: deepin20/LitePurge

## Basic Information

- **Project Name**: 轻澈
- **Description**: 轻澈 LitePurge是一款专为统信 UOS / Deepin 系统设计的图形化系统清理与优化工具。它提供了一站式的系统垃圾清理、隐私痕迹擦除、启动项管理、磁盘空间分析、系统信息查看和软件包管理功能，帮助您轻松保持系统洁净、高效运行。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 轻澈 LitePurge

[![Version](https://img.shields.io/badge/version-1.3.0-blue)](https://github.com/yourname/litepurge)
[![License](https://img.shields.io/badge/license-GPLv3-green)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.7%2B-blue)](https://www.python.org/)
[![Qt](https://img.shields.io/badge/Qt-5.15-brightgreen)](https://www.qt.io/)

**轻澈 LitePurge** 是一款专为统信 UOS / Deepin 系统设计的图形化系统清理与优化工具。它提供了一站式的系统垃圾清理、隐私痕迹擦除、启动项管理、磁盘空间分析、系统信息查看和软件包管理功能，帮助您轻松保持系统洁净、高效运行。

## ✨ 功能特性

- 🧹 **系统垃圾清理**  
  智能扫描并清理 APT 缓存、用户缓存、回收站、压缩日志归档、Systemd 日志等，释放磁盘空间。

- 🔒 **隐私痕迹擦除**  
  一键清除终端命令历史、剪贴板缓存、最近文档列表，保护您的隐私安全。

- ⚙️ **启动项管理**  
  查看并启用/禁用用户和系统级别的自动启动项，优化开机速度。

- 💾 **磁盘空间分析**  
  以树形图直观展示目录占用，帮助您定位大文件/大目录。

- 📊 **系统信息查看**  
  显示操作系统、CPU、内存、磁盘分区等详细硬件和系统信息。

- 📦 **软件包管理**  
  列出已安装软件包，支持搜索和卸载，方便管理应用。

- 🌐 **多语言支持**  
  内置中文和英文界面（可扩展），随系统语言自动切换。

- 🎨 **现代化界面**  
  基于 PyQt5，采用扁平化设计，色彩柔和，操作直观。

## 📸 界面预览

（请在此处插入实际运行截图，例如主窗口、清理报告、磁盘分析等）

```
+------------------------------------------+
|  ℹ️  准备就绪                              |
|      点击「扫描」以发现系统可清理的垃圾文件  |
+------------------------------------------+
|  可清理项目                    共 0 项     |
|  +---------------------------------------+ |
|  |  ☑ APT软件包缓存  123.45 MB  [低]    | |
|  |  ☑ 回收站         45.67 MB   [低]    | |
|  |  ☑ 旧内核         234.56 MB  [中]    | |
|  +---------------------------------------+ |
|  [ 扫描 ]  [ 一键清理 ]  [清空日志] [设置] |
|  [启动项] [隐私擦除] [磁盘分析] [系统信息] [软件包] |
|  +---------------------------------------+ |
|  | 日志输出区域                           | |
|  |  ...                                  | |
|  +---------------------------------------+ |
|  ████████████████████████████████████     |
+------------------------------------------+
```

## 🚀 安装

### 通过 DEB 包安装（推荐）

1. 下载最新 `.deb` 包（[发行版页面](https://github.com/yourname/litepurge/releases)）。
2. 在终端执行：
   ```bash
   sudo dpkg -i litepurge_1.3.0-1_all.deb
   sudo apt install -f  # 解决依赖
   ```
3. 安装完成后，在开始菜单中找到 **轻澈 LitePurge** 并启动。

### 通过源码运行（开发/测试）

1. 克隆仓库：
   ```bash
   git clone https://github.com/yourname/litepurge.git
   cd litepurge
   ```
2. 安装 Python 依赖：
   ```bash
   pip install -r requirements.txt
   ```
   （若使用系统 PyQt5，可跳过）
3. 执行：
   ```bash
   ./run.sh
   ```
   或
   ```bash
   python3 src/main.py
   ```

> **注意**：部分清理功能需要 `root` 权限，建议使用 `pkexec` 或 `sudo` 启动，程序会在需要时自动提示。

## 📖 使用说明

1. **扫描**：点击主界面「扫描」按钮，程序将扫描系统各个可清理项，并显示可释放空间。
2. **选择清理项**：勾选您希望清理的项目（默认全部勾选），风险等级用颜色标签（绿/黄/红）标识。
3. **一键清理**：点击「一键清理」，确认后执行清理操作，完成后会弹出详细报告。
4. **隐私擦除**：点击「隐私擦除」按钮，快速清除终端历史、剪贴板缓存和最近文档。
5. **启动项管理**：查看系统启动项，可随时启用或禁用。
6. **磁盘分析**：输入目录路径，点击扫描，以树形图查看空间占用。
7. **系统信息**：查看操作系统、CPU、内存等详细信息。
8. **软件包管理**：搜索已安装软件包，可卸载不需要的应用。

更多详细操作请参阅 [用户手册](docs/user_manual.md)。

## 🔧 开发与构建

### 目录结构
```
.
├── build_deb.sh            # DEB 打包脚本
├── docs/                   # 文档（用户手册和开发者指南）
├── resources/              # 图标、样式、翻译文件
├── src/                    # 源代码
│   ├── app.py              # 应用主类
│   ├── core/               # 扫描、清理、模块等核心逻辑
│   ├── gui/                # 界面相关（主窗口、对话框）
│   ├── models/             # 数据模型
│   ├── services/           # 日志、配置、权限等公共服务
│   └── main.py             # 入口脚本
├── tests/                  # 单元测试
├── requirements.txt        # 运行时依赖
├── requirements-dev.txt    # 开发环境额外依赖
├── setup.py                # Python 安装配置
└── run.sh                  # 快速启动脚本
```

### 构建 DEB 包
在项目根目录执行：
```bash
./build_deb.sh
```
打包好的 `.deb` 文件将出现在当前目录。

### 依赖
- Python 3.7+
- PyQt5
- policykit-1（用于图形化提权）
- 其他见 `requirements.txt`

## 🤝 贡献

欢迎提交 Issue 和 Pull Request。请确保代码风格符合 [PEP 8](https://pep8.org/)，并尽量添加测试。

## 📄 许可证

本程序采用 **GNU General Public License v3.0** 开源协议，详情请见 [LICENSE](LICENSE) 文件。

## 作者

温暖断章 <1802272181@qq.com>

---

**轻澈 LitePurge** —— 让系统轻快如初。