# 学强国

**Repository Path**: deepin20/XueQiangGuo

## Basic Information

- **Project Name**: 学强国
- **Description**: 学强国（XueQiangGuo）：一款集成学习强国浏览器、资料库、下载管理和笔记系统的桌面应用，专为 Linux 桌面环境（UOS / Deepin / Ubuntu）设计。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学强国（XueQiangGuo）

> 一款集成学习强国浏览器、资料库、下载管理和笔记系统的桌面应用  
> 专为 Linux 桌面环境（UOS / Deepin / Ubuntu）设计

---

## 📖 简介

**学强国** 是一款以“学习强国”平台为核心，集学习、资料管理、下载、笔记于一体的效率工具。它解决了在 Linux 系统下访问学习强国时视频播放、资料保存、笔记记录等痛点，让学习更高效、更便捷。

---

## ✨ 功能特性

### 🌐 浏览器模块
- 内嵌 **QtWebEngine** 浏览器，完美适配学习强国网站。
- **Cookie 持久化**：登录状态自动保存，无需重复登录。
- **地址栏导航** + 常用按钮（后退/前进/刷新/停止/主页）。
- **一键外部浏览器打开**：遇到视频播放问题时可快速切换。
- **右键菜单**：保存文章、查看源代码、保存到资料库。
- **书签管理**：添加/删除/导入/导出（支持 Netscape 格式）。
- **历史记录**：按日期分组，支持搜索和清空。
- **智能视频检测**：自动识别页面中的 `<video>` 标签，调用本地播放器（mpv/VLC）播放视频流，彻底解决内嵌播放器解码问题。

### 📚 资料库
- **文档管理**：支持导入 PDF、TXT、Markdown、HTML、音视频等常见文件。
- **全文搜索**：基于 SQLite FTS5，快速检索文档内容。
- **标签系统**：灵活分类，自动收集所有标签。
- **分页展示**：每页 50 条，后台线程加载不卡顿。
- **文档预览**：文本/PDF 内嵌显示，音视频引导外部播放。
- **阅读计数**：自动统计阅读次数。
- **导出 CSV**：一键导出所有文档信息。

### ⬇️ 下载管理器
- **多任务并发**：可自定义最大并发数（1~10）。
- **断点续传**：使用 `.part` 临时文件，支持暂停/恢复。
- **任务持久化**：程序重启后自动恢复未完成的任务。
- **实时状态**：显示下载进度、速度、文件大小。
- **任务控制**：暂停/恢复/取消/移除（支持右键菜单和操作按钮）。
- **清除已完成**：一键清理已完成/错误/取消的任务。

### 📝 笔记系统
- **Markdown 编辑器**：支持标题、标签和正文编辑。
- **全文搜索**：基于 FTS5 快速定位笔记。
- **标签管理**：自动收集所有标签，方便筛选。
- **关联文档**：可将笔记与资料库中的文档关联。
- **导出功能**：支持导出为 Markdown、HTML、PDF 格式。
- **批量导出**：一键导出所有笔记为 Markdown 文件。

### ⚙️ 设置与个性化
- **可配置项**：下载目录、并发数、正文提取长度、Cookie 持久化、主题（浅色/暗色）、自动播放视频。
- **数据库管理**：备份、压缩、重置（带二次确认）。
- **主题即时切换**：无需重启，所有控件立即生效。

### 🗄️ 数据存储
- 用户数据目录：`~/.local/share/xueqiangguo/`
- 数据库：`library.db`（含 FTS5 全文搜索）
- 配置文件：`settings.json`
- 下载文件、保存的文章、Cookie 等均在此目录下。

---

## 🚀 快速开始

### 系统要求
- **操作系统**：Deepin 25 / UOS / Ubuntu 20.04+ / Debian 11+
- **Python**：3.8+
- **桌面环境**：支持 X11（已强制使用 xcb 平台插件）

### 安装依赖

#### 1. 系统依赖（播放器及解码器）
```bash
sudo apt update
sudo apt install -y python3-pyqt5 python3-pyqt5.qtwebengine \
    python3-requests python3-bs4 python3-markdown \
    mpv vlc ffmpeg
```

#### 2. Python 依赖（若使用 pip 额外安装）
```bash
pip3 install -r requirements.txt
```

### 从源码运行

```bash
git clone https://github.com/your-username/xueqiangguo.git
cd xueqiangguo
python3 run.py
```

---

## 📦 打包与安装

我们提供一键打包脚本 `build_deb.py`，可生成适用于 Deepin/UOS 的 `.deb` 安装包。

### 打包
```bash
python3 build_deb.py
```
执行后会在当前目录生成 `xueqiangguo_1.0.0_all.deb`。

### 安装
```bash
sudo dpkg -i xueqiangguo_1.0.0_all.deb
# 如有依赖缺失，执行：
sudo apt install -f
```

### 卸载
```bash
sudo dpkg -r xueqiangguo
```
用户数据（`~/.local/share/xueqiangguo/`）会被保留。

### 安装后的路径
- 源码安装到 `/opt/xueqiangguo/`
- 启动命令 `xueqiangguo` 全局可用
- 桌面快捷方式出现在“教育”或“办公”分类中

---

## 🛠️ 开发指南

### 项目结构
```
xueqiangguo/
├── src/                    # 核心源码
│   ├── app.py              # 主窗口
│   ├── browser/            # 浏览器模块
│   ├── database/           # 数据库核心（含命令行工具）
│   ├── downloader/         # 下载管理器
│   ├── library/            # 资料库
│   ├── notes/              # 笔记系统
│   ├── settings/           # 设置
│   └── utils/              # 工具函数
├── data/                   # 运行时数据目录（用户数据）
├── tests/                  # 单元测试（待完善）
├── requirements.txt        # Python 依赖
├── build_deb.py            # 打包脚本
└── run.py                  # 启动入口
```

### 数据库迁移
程序启动时自动执行迁移，添加缺失列，无需手动操作。  
也可使用命令行工具：
```bash
python3 -m src.database migrate   # 初始化/迁移
python3 -m src.database backup    # 备份数据库
python3 -m src.database vacuum    # 压缩数据库
python3 -m src.database check     # 检查完整性
python3 -m src.database tables    # 列出所有表
python3 -m src.database schema <表名>  # 查看表结构
```

---

## 🐛 已知问题与解决方案

| 问题 | 解决方案 |
|------|----------|
| 内嵌视频播放报错（FFmpeg 解码失败） | 已提供“外部播放器”方案（自动调用 mpv/VLC），在设置中开启“自动播放视频”即可。 |
| QtWebEngine 警告 `FFmpegDemuxer: no supported streams` | 这是 QtWebEngine 的底层限制，不影响外部播放器功能，忽略即可。 |
| Wayland 环境下崩溃 | 已强制使用 X11 平台插件（`QT_QPA_PLATFORM=xcb`），可稳定运行。 |

---

## 📜 许可证

本项目采用 [MIT License](LICENSE)，您可以自由使用、修改和分发。

---

## 👥 贡献

欢迎提交 Issue 和 Pull Request！  
如果您有任何建议或问题，请通过 GitHub Issues 与我们联系。

---

**学强国** —— 让学习更高效，让知识触手可及。 🎉