# 快封

**Repository Path**: deepin20/QuickWrap

## Basic Information

- **Project Name**: 快封
- **Description**: 快封 QuickWrap是一款专为统信UOS/Deepin设计的桌面应用生成工具，帮助您将任意网站快速封装为独立的桌面应用，支持音视频播放、自动图标获取、桌面快捷方式与开始菜单集成，让 Web 应用拥有原生桌面体验。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快封 QuickWrap

[![Version](https://img.shields.io/badge/version-3.5-blue)](https://github.com/yourname/quickwrap)
[![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/)

**快封 QuickWrap** 是一款专为统信UOS/Deepin设计的桌面应用生成工具，帮助您将任意网站快速封装为独立的桌面应用，支持音视频播放、自动图标获取、桌面快捷方式与开始菜单集成，让 Web 应用拥有原生桌面体验。

---

## ✨ 功能特点

- 🚀 **一键生成**：输入名称和网址，即可生成桌面应用。
- 🎨 **自动图标**：自动从网站抓取 favicon，也可手动选择图标。
- 📂 **快捷方式**：自动创建桌面快捷方式和开始菜单项。
- 🔊 **音视频支持**：基于 WebKit2 引擎，支持 HTML5 音视频播放（需系统解码器）。
- 🔧 **虚拟环境管理**：首次启动自动创建 Python 虚拟环境并安装依赖，开箱即用。
- 🎭 **主题切换**：内置深色/浅色主题，随系统偏好自动适配。
- 🗑️ **应用卸载**：集成卸载工具，一键删除已生成的应用及所有相关文件。
- 📦 **DEB 打包**：提供一键构建 DEB 安装包的脚本，方便分发。

---

## 📦 安装

### 方法一：使用 DEB 包（推荐）

1. 下载 `quickwrap_*.deb` 安装包。
2. 在终端执行：
   ```bash
   sudo dpkg -i quickwrap_*.deb
   ```
3. 安装完成后，可在应用菜单或终端运行 `quickwrap` 启动。

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

```bash
git clone https://github.com/yourname/quickwrap.git
cd quickwrap
pip3 install -r requirements.txt
python3 -m src.main
```

---

## 🚀 使用说明

1. **启动快封**：点击图标或执行 `quickwrap`。
2. **输入信息**：填写应用名称和网址（支持预设快捷选择）。
3. **选择图标**：自动获取或手动上传图标文件。
4. **设置选项**：勾选是否创建桌面快捷方式和开始菜单项。
5. **生成应用**：点击“生成桌面应用”，等待完成。
6. **运行应用**：双击桌面图标或从开始菜单启动。

生成的应用默认安装在 `~/Applications/`，图标位于 `~/.local/share/icons/hicolor/48x48/apps/`。

---

## ⚙️ 系统依赖

- **Python** ≥ 3.7
- **系统库**（需手动安装）：
  ```bash
  sudo apt install python3-gi gir1.2-webkit2-4.0 python3-gi-cairo
  ```
- **可选音视频解码器**（用于生成的应用）：
  ```bash
  sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav
  ```

---

## 🛠️ 构建与打包

项目内置了 DEB 打包脚本：

```bash
python3 build_deb.py          # 或 ./build_deb.sh
```

生成的 `.deb` 文件位于项目根目录，可用于安装和分发。

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request。请确保代码符合 PEP8，并为新功能添加单元测试。

1. Fork 本仓库。
2. 创建功能分支 (`git checkout -b feature/your-feature`)。
3. 提交改动 (`git commit -am 'Add feature'`)。
4. 推送到分支 (`git push origin feature/your-feature`)。
5. 创建 Pull Request。

---

## 📄 许可证

本项目采用 [GNU General Public License v3.0](LICENSE) 开源协议。

---

## 📬 联系方式

- 项目主页：https://github.com/yourname/quickwrap
- 问题反馈：https://github.com/yourname/quickwrap/issues

---

**快封 QuickWrap – 让 Web 应用秒变桌面应用** 🎉