# 极简导航浏览器

**Repository Path**: deepin20/minibrowser

## Basic Information

- **Project Name**: 极简导航浏览器
- **Description**: 极简导航浏览器 - HaoBrowser
 一个基于Python和QtWebEngine的轻量级浏览器，默认打开hao123导航页， 集成广告屏蔽、缩放、快捷键等功能，专为UOS系统优化。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HaoBrowser — 极简导航浏览器

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

**HaoBrowser** 是一款基于 Python 和 QtWebEngine 的轻量级浏览器，专为统信 UOS（及 Debian 系 Linux）系统优化。它以 **hao123** 为默认首页，提供极简干净的浏览体验，同时集成了实用的功能，让日常上网更高效。

---

## ✨ 主要特性

- **默认首页**：hao123 导航，快速访问常用网站。
- **智能地址栏**：自动识别网址或搜索关键词（支持百度搜索）。
- **广告屏蔽**：内置域名黑名单 + CSS 隐藏，亦可选用 `adblockparser` 增强规则。
- **页面缩放**：支持放大/缩小/重置，**按站点记忆**缩放比例。
- **收藏夹**：随时添加/删除，支持快捷键 `Ctrl+D`。
- **阅读模式**：一键净化页面，专注阅读。
- **无痕模式**：不保存历史、缓存、Cookie，关闭即清。
- **主题切换**：浅色/深色模式，保护视力。
- **页面查找**：`Ctrl+F` 调出浮动查找框，高亮所有匹配项。
- **鼠标手势**：双击页面空白处自动滚动到顶部。
- **快捷键**：全套快捷键支持（关闭、刷新、前进/后退、缩放等）。
- **下载管理**：内置下载对话框，显示进度条。
- **SSL 证书错误处理**：支持用户选择信任或忽略。
- **中文输入法支持**：已适配 UOS 默认 Fcitx 框架。

---

## 📦 依赖

### 系统依赖（必须）
```bash
sudo apt update
sudo apt install python3 python3-pyqt5 python3-pyqt5.qtwebengine libqt5webengine5 ffmpeg libavcodec-extra
```

### Python 模块
- 全部使用标准库，无需额外 `pip install`（若想启用完整广告规则，可安装 `adblockparser`，但非必须）。

---

## 🚀 快速开始

### 方式一：直接运行源码
1. 克隆或下载本仓库。
2. 进入项目目录：
   ```bash
   cd haobrowser
   ```
3. 运行主程序：
   ```bash
   python3 main.py
   ```

### 方式二：安装 `.deb` 包（UOS / Debian 推荐）
若您已拥有打包好的 `.deb` 文件，执行：
```bash
sudo dpkg -i com.example.haobrowser_1.0.0_amd64.deb
```
安装后，在启动器或终端输入 `haobrowser` 即可启动。

---

## 🛠 自定义与配置

所有用户配置保存在 `~/.config/MyCompany/HaoBrowser.conf`，包括：
- 自定义首页
- 默认缩放比例
- 收藏夹列表
- 主题偏好
- 无痕模式开关
- 广告屏蔽开关

您也可以通过图形界面（⚙️ 设置按钮）进行调整。

---

## 📖 快捷键列表

| 快捷键           | 功能                |
|------------------|---------------------|
| `Ctrl+F`         | 显示查找框          |
| `Esc`            | 关闭查找框          |
| `Ctrl+D`         | 收藏当前页          |
| `Ctrl+Shift+Del` | 清除浏览数据        |
| `Ctrl++` / `Ctrl+-` | 放大 / 缩小       |
| `Ctrl+0`         | 重置缩放（默认）    |
| `Ctrl+R` / `F5`  | 刷新页面            |
| `Alt+←` / `Alt+→`| 后退 / 前进         |
| `Ctrl+H`         | 回到主页            |
| `Ctrl+W`         | 关闭窗口            |

---

## 🧩 项目结构

```
.
├── main.py                    # 程序入口
├── haobrowser/                # 核心模块
│   ├── adblock.py             # 广告拦截器
│   ├── browser_window.py      # 主窗口与界面逻辑
│   ├── settings_dialog.py     # 设置对话框
│   ├── webpage.py             # 自定义网页页面
│   └── utils.py               # 工具函数（预留）
├── DEBIAN/                    # 打包控制文件（用于 .deb 构建）
│   ├── control
│   ├── postinst
│   └── prerm
├── LICENSE                    # GPL v3 许可证
└── README.md                  # 本文档
```

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request。请确保：
- 代码风格符合 PEP 8。
- 新功能需有清晰的文档说明。
- 遵守 GPL v3 许可证。

---

## 📄 许可证

本项目使用 **GNU General Public License v3.0**，详情请见 [LICENSE](LICENSE) 文件。

---

## 📧 联系方式

- 作者：温暖断章
- 邮箱：1802272181@qq.com
- 项目主页：https://gitee.com/deepin20/minibrowser

---

*最后更新：2026-06-28*