# 深核管家

**Repository Path**: deepin20/deepkernel

## Basic Information

- **Project Name**: 深核管家
- **Description**: 深核管家是一款专为 deepin 25操作系统设计的内核管理工具，提供图形界面和命令行两种操作方式，帮助您轻松完成内核的安装、卸载、切换、清理、GRUB 配置、内核参数调优等常见维护任务。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 深核管家 (DeepKernel)

**深核管家** 是一款专为 **deepin 25** 操作系统设计的内核管理工具，提供图形界面和命令行两种操作方式，帮助您轻松完成内核的安装、卸载、切换、清理、GRUB 配置、内核参数调优等常见维护任务。

---

## ✨ 主要功能

- **内核管理**  
  - 查看已安装内核的版本、大小、运行状态  
  - 在线安装新内核（支持版本号指定）  
  - 卸载内核（自动保护当前运行内核和最后一个内核）  
  - 设置默认启动内核  
  - 自动清理旧内核（保留最近 N 个）

- **GRUB 配置**  
  - 一键备份 / 恢复 GRUB 配置文件  
  - 重建 GRUB 启动菜单

- **内核参数调优**  
  - 查询当前内核参数（支持关键字过滤）  
  - 临时修改参数（立即生效）  
  - 永久修改参数（写入配置文件）

- **内核更新检测**  
  - 对比软件源与当前内核版本，发现新版本后提示安装

- **可安装内核搜索**  
  - 在软件源中搜索可用的内核包，一键安装

- **操作日志**  
  - 所有关键操作记录到 `/var/log/deepkernel.log`，便于排查问题

---

## 🖥️ 界面预览

### 图形界面 (GUI)  
- 基于 PyQt5，支持深色/浅色主题自适应  
- 标签式布局，功能清晰  
- 支持从 deepin 启动器启动（通过 `pkexec` 提权）

### 命令行界面 (CLI)  
- 交互式菜单，适合远程或终端环境  
- 所有功能与 GUI 一致

---

## 📦 安装方法

### 方法一：使用 .deb 包安装（推荐）

1. 克隆或下载本项目源码到本地。
2. 在项目根目录执行打包脚本：
   ```bash
   ./build_deb.sh
   ```
   成功后会在上级目录生成 `deepkernel_1.0.0-1_all.deb`。
3. 安装：
   ```bash
   sudo dpkg -i ../deepkernel_1.0.0-1_all.deb
   sudo apt install -f   # 若依赖缺失，自动补全
   ```
4. 安装完成后，在开始菜单中找到“深核管家”并点击，弹出身份验证对话框后输入密码即可启动图形界面。

### 方法二：直接运行源码（开发或调试）

```bash
# 安装 Python 依赖（PyQt5 等）
sudo apt install python3-pyqt5

# 进入项目目录
cd deepkernel

# 启动图形界面（需要 root 权限）
sudo python3 gui.py

# 或使用命令行界面
sudo python3 cli.py
```

---

## 🚀 使用指南

### 图形界面 (GUI)

- 启动后默认显示“内核管理”标签页，列出所有已安装内核。
- 选中一个内核，可使用下方按钮进行安装、卸载、设为默认等操作。
- 切换到“可安装内核”标签页，搜索软件源中的内核包并安装。
- “GRUB 配置”和“内核参数”标签页提供更多系统级管理功能。

### 命令行界面 (CLI)

运行 `sudo deepkernel-cli` 后，按提示输入数字选择操作：
```
1. 查看当前内核状态
2. 列出已安装内核
3. 安装新内核
4. 卸载内核
5. 设置默认启动内核
6. 自动清理旧内核
7. GRUB 配置工具
8. 内核参数管理
9. 查看操作日志
0. 退出
```

---

## 🔧 依赖项

- Python 3.9+
- PyQt5
- apt / dpkg
- grub2-common
- policykit-1（用于 GUI 提权）

这些依赖在 deepin 25 中默认已安装，若缺失可通过 `sudo apt install` 补全。

---

## 🤝 贡献

欢迎通过 Issue 或 Pull Request 提交改进建议、Bug 报告或新功能。

- 代码风格遵循 PEP 8。
- 提交前请确保在 deepin 25 上测试通过。

---

## 📜 许可证

本项目基于 **GNU General Public License v3.0** 开源，详见 [LICENSE](LICENSE) 文件。

---

## 📧 联系方式

如有问题，可联系 Deepin 社区或维护团队。

---

**深核管家** —— 让内核管理更简单、更可靠。