# 深度源管家

**Repository Path**: deepin20/deepin-apt-manager

## Basic Information

- **Project Name**: 深度源管家
- **Description**: 深度源管家 是一款专为 Deepin 操作系统 设计的图形化软件源管理工具，旨在帮助用户以可视化的方式轻松管理 APT 软件源，告别繁琐的命令行操作。无论是系统新手还是资深用户，都能通过它高效、安全地维护软件源配置。
- **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

# 深度源管家

#### 介绍
深度源管家 是一款专为 Deepin 操作系统 设计的图形化软件源管理工具，旨在帮助用户以可视化的方式轻松管理 APT 软件源，告别繁琐的命令行操作。无论是系统新手还是资深用户，都能通过它高效、安全地维护软件源配置
# 深度源管家

> 深度操作系统软件源图形化管理工具 —— 让软件源管理变得简单、安全、高效。

---

## 📖 简介

**深度源管家** 是一款专为 **Deepin 操作系统** 设计的图形化软件源管理工具，旨在帮助用户以可视化的方式轻松管理 APT 软件源，告别繁琐的命令行操作。无论是系统新手还是资深用户，都能通过它高效、安全地维护软件源配置。

---

## ✨ 功能特性

- **源列表可视化**：清晰展示 `/etc/apt/sources.list` 及 `/etc/apt/sources.list.d/` 下所有源，支持按文件分组，状态一目了然。
- **源管理操作**：添加、编辑、删除、启用/禁用源，支持批量操作和右键快捷菜单。
- **一键备份与恢复**：将当前所有源配置打包为 `.tar.gz` 备份文件，随时一键还原，避免误操作风险。
- **恢复官方源**：一键重置为 Deepin 25 官方稳定版源，并自动备份第三方源，让系统回归纯净。
- **镜像源快速切换**：预置华为云、清华源、阿里云、腾讯云等国内镜像，点选即可切换，加速软件下载。
- **第三方源检测与警告**：自动识别非 Deepin 官方源（如 Debian、Ubuntu、PPA 等），并以淡红色背景高亮提示，防范兼容风险。
- **源有效性测试**：后台测试选中源的连通性（检测 `dists/发行版/Release` 文件），快速验证源是否可访问。
- **系统主题集成**：工具栏使用 Deepin 系统图标，界面风格统一，操作直观。

---

## 📦 依赖

- Python 3.6+
- PyQt5
- python3-apt

在 Deepin 中可通过以下命令安装依赖：

```bash
sudo apt update
sudo apt install python3-pyqt5 python3-apt
```

---

## 🚀 安装与运行

### 方式一：使用预构建 DEB 包（推荐）

1. 下载 `deepin-apt-manager_1.0.0_all.deb` 包。
2. 在终端中执行：
   ```bash
   sudo dpkg -i deepin-apt-manager_1.0.0_all.deb
   ```
3. 安装完成后，在开始菜单中找到“深度源管家”并启动，或终端运行：
   ```bash
   pkexec python3 /opt/deepin-apt-manager/main.py
   ```

### 方式二：从源码运行

```bash
git clone https://github.com/your-repo/deepin-apt-manager.git
cd deepin-apt-manager
# 安装依赖（见上）
sudo python3 main.py
```

> **注意**：程序需要 root 权限才能修改源配置文件，首次启动会通过 `pkexec` 或 `sudo` 请求提权。

---

## 🖥️ 使用说明

### 主界面
- **表格区**：列出所有有效源，支持排序、勾选启用/禁用。
- **工具栏**：提供刷新、添加、编辑、删除、备份、恢复、恢复官方源、切换镜像、测试源等操作按钮。
- **右键菜单**：在表格行上右键，可快速启用/禁用源。

### 常见操作
- **添加源**：点击“添加”按钮，填写类型（deb/deb-src）、URI、发行版代号、组件（空格分隔）及注释。
- **切换镜像**：点击“切换镜像”下拉菜单，选择镜像源即可一键切换。
- **测试源**：选中一个源后点击“测试选中源”，程序会检查该源是否可访问。
- **备份/恢复**：点击“备份”选择保存路径，生成 `.tar.gz` 备份包；“恢复”选择备份包即可还原。

---

## 📦 打包与构建

如需自行构建 DEB 包，可在项目根目录执行：

```bash
bash scripts/build_deb.sh
```

成功后在项目根目录生成 `deepin-apt-manager_1.0.0_all.deb` 安装包。

---

## 📄 许可证

本项目采用 **GNU General Public License v3.0** 授权，详情请参阅 [LICENSE](LICENSE) 文件。

---

## 🤝 贡献

欢迎提交 Issue 或 Pull Request。如果你有任何改进建议或发现了问题，请在 GitHub 仓库中反馈。

---

**深度源管家** —— 让 Deepin 系统的软件源管理更加轻松高效！