civil-servans-tools

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

civil-servans-tools

★ 15 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎉 公考小工具 正式发布

> 一款面向公务员考试备考者的桌面工具箱，帮助你将第三方刷题 App 导出的 PDF 试卷转换为标准真题格式，并提供计时练习、答题卡生成与 PDF 拼合功能。

---

## 📦 版本信息

| 项目 | 内容                         |
|------|----------------------------|
| **版本号** | v1.1.2                     |
| **发布日期** | 2026-08-13                 |
| **运行平台** | Windows 10 / 11（64 位）      |
| **Python 版本** | 3.10+   < 3.13 (OCR场景依赖限制) |
| **开源协议** | MIT License                |

---
## 🧰 工具列表

| 工具 | 说明 | 使用文档 |
|------|------|:--:|
| PDF 格式转换 | 将粉笔/华图/中公等刷题软件导出的 PDF 转换为国考标准格式，支持行测和申论 | [📖 使用说明](./tools/pdf_converter/docs/pdf-converter.md) |
| 考试计时器 | 正计时 / 倒计时，大字显示，支持分段记录 | [📖 使用说明](./tools/exam_timer/docs/exam-timer.md) |
| 申论答题纸生成器 | 生成 25x24 标准格答题纸，支持按页和按题目字数导出 PDF / 图片 | [📖 使用说明](./tools/answer_sheet/docs/answer-sheet.md) |
| PDF 文件拼合 | 多个 PDF 按序合并为一个，拖拽排序，一键生成 | [📖 使用说明](./tools/pdf_merger/docs/pdf-merger.md) |
| OCR 文字识别 | 图片文字提取，支持印刷体/手写体，复制或导出 TXT | [📖 使用说明](./tools/ocr_recognizer/docs/ocr-recognizer.md) |
| 截图文字识别 | 全局快捷键截屏选区，自动 OCR 识别并复制到剪贴板，快捷键可自定义 | — |

---

## 🚀 六大核心功能

### 1. 📄 PDF 真题排版转换器（目前行测资料分析部分还存在一些缺陷）

将**粉笔 / 华图 / 中公**等 App 导出的 PDF 试卷，一键转换为**标准真题排版格式**。

`注：由于粉笔是使用Skia/Chromium PDF引擎生成，在文字提取上，可能会出发性能问题，导致提取较慢`

- **双引擎解析**：自动识别 PDF 类型，文字型走 PyMuPDF 文本解析，扫描型走 PaddleOCR + PaddlePaddle 图文识别，CUDA 可用时自动启用 GPU（`注：目前只支持英伟达显卡`）
- **智能清洗**：
    - 行测卷：自动去除水印、广告、二维码；识别题号与选项（A/B/C/D）；按五大模块归类（政治理论/常识判断、言语理解与表达、数量关系、判断推理、资料分析）；过滤页码等干扰信息
    - 申论卷：提取给定材料段落；分离作答要求；识别双栏排版；跳过答题卡页面
- **专业排版**：正文宋体（SimSun），题号黑体（SimHei），标准行距，字号 / 页边距 / 纸张大小均可配置
- **两套快捷预设**：国考（仿宋 14pt B5）和联考（仿宋 12pt B5），一键切换
- **图表保留**：资料分析模块的图表自动提取并嵌入
- **实时双栏预览**：左侧原始 PDF，右侧转换结果，所见即所得
- **可配置 40+ 排版参数**，JSON 驱动，无需改代码即可调优

### 2. ⏱️ 考试计时器

模拟真实考场计时环境的轻量计时工具。

- **正计时 / 倒计时**双模式
- 大字号显示（80px 加粗数字），远处也看得清
- **分段记录**（Lap）：点击记录各阶段耗时，有序列表展示
- 倒计时预警：剩余 5 分钟数字变红，归零时闪烁提醒
- 基于 Qt QTimer 引擎，100ms 精度

### 3. 📝 申论答题卡生成器

生成标准申论答题卡，支持打印练习或导出图片。

- **标准模式**：指定页数，每页独立编号，含 100/200/300/400/500/600 字数标记（25 列 × 24 行，每页 600 格）
- **题目模式**：按题目字数要求自定义，自动分页、跨页连续排版、题间距可设
- 导出为 **PDF**（ReportLab）或 **PNG 图片**（每页一张，PyMuPDF 渲染）

### 4. 📎 PDF 文件拼合

将多份 PDF 按自定义顺序合并为一份。

- **拖拽添加**：直接拖入 PDF 文件到列表，支持批量选择
- **拖拽排序**：列表内直接拖动调整合并顺序，半透明预览拖动目标
- **实时预览**：选中文件即时预览全部页面，支持翻页浏览
- **一键合并**：后台执行，进度可见，支持取消
- **统一保存**：默认文件名 `拼合后.pdf`

### 5. 🔍 OCR 文字识别

从图片中提取文字，支持印刷体和手写体识别。

- **图片识别**：支持 PNG / JPG / BMP / TIFF / WebP 等常见格式
- **手写体模式**：专为手写文字优化的预处理管线（对比度增强 + 锐化 + 去噪）
- **置信度标注**：识别结果以绿/黄/红色标注可信程度
- **结果可复制**：一键复制全文到剪贴板，或导出为 TXT 文件
- **拖放支持**：直接拖拽图片文件到窗口即可加载识别
- 基于 **PaddleOCR 2.x + PaddlePaddle**，CUDA 可用时自动 GPU 加速

### 6. ✂️ 快捷键截图文字识别

无需打开任何窗口，在**任意软件界面**按下全局快捷键，框选屏幕区域后自动识别文字并复制到剪贴板。

- **全局热键**：默认 `Ctrl + Shift + Z`，基于 GetAsyncKeyState 轮询实现，零注册零冲突
- **框选截图**：热键触发后拖拽框选屏幕任意区域（Esc 取消）
- **自动识别**：识别完成后文字自动复制到剪贴板，右下角 Toast 提示结果
- **快捷键可自定义**：菜单栏「截图OCR → 快捷键设置」修改组合键并自动保存
- **手动触发**：菜单栏「截图OCR → 立即截图识别」随时调用，无需记忆快捷键
- 复用 **PaddleOCR 2.x + PaddlePaddle** 引擎，首次使用需加载模型

---

## 立即下载 Windows 安装包

> 国内 GitHub 小白用户：优先使用蓝奏云下载，打开链接后直接下载 `CivilServansTools-v1.0.0-x64.exe`，速度通常比 GitHub Release 更稳、更接近满速。

| 下载入口 | 推荐人群 | 链接                                                                                   |
| --- | --- |--------------------------------------------------------------------------------------|
| 蓝奏云满速下载 | 国内用户优先 | [下载 公考小工具安装包](https://wwanl.lanzoum.com/s/CivilServansTools)                         |
| GitHub Release 备用 | 能稳定访问 GitHub 的用户 | [v1.1.2 Release](https://github.com/codepmy/civil-servans-tools/releases/tag/v1.1.2) |

安装时只需要下载并运行 `CivilServansTools-v1.1.2-x64.exe`。

## 🛠️ 技术栈

| 组件 | 技术 | 版本 |
|------|------|------|
| UI 框架 | PyQt6 | ≥ 6.6 |
| PDF 解析 | PyMuPDF (fitz) | ≥ 1.24 |
| OCR 识别 | PaddleOCR + PaddlePaddle | PaddleOCR ≥ 2.7 / PaddlePaddle CUDA 可选 |
| PDF 生成 | ReportLab | ≥ 4.2 |
| 图像处理 | Pillow | ≥ 10.0 |
| 数据校验 | Pydantic | ≥ 2.0 |
| 打包分发 | PyInstaller (单文件 exe) | — |

**设计系统**：Slate + Indigo 统一配色，白色卡片 + 圆角 + 层次分明地排版风格。

---

## 📥 安装与运行

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

```bash
# 1. 克隆仓库
git clone https://github.com/codepmy/civil-servans-tools.git
cd CivilServantsTools

# 2. 一键安装环境
setup.bat

# 3. 启动程序
run.bat
```

### 方式二：直接使用打包版

下载 `公考小工具.exe`，双击运行（已包含所有依赖和资源）。

> **注意**：OCR 功能需要 PaddleOCR/PaddlePaddle 运行环境；源码运行请先执行 `setup.bat`。首次启动 OCR 解析时会下载模型，安装 CUDA 版 PaddlePaddle 后可使用 NVIDIA GPU 加速。

---

## 📂 项目结构

```
CivilServantsTools/
├── main.py                 # 程序入口
├── app_paths.py            # 资源路径解析
├── version.json            # 版本与更新信息
├── ui/                     # 主窗口、首页路由、通知组件
├── tools/
│   ├── ocr_engine/         # 共享 OCR 引擎（PaddleOCR 2.x）
│   ├── pdf_converter/      # PDF 排版转换器
│   ├── exam_timer/         # 考试计时器
│   ├── answer_sheet/       # 答题卡生成器
│   ├── pdf_merger/         # PDF 文件拼合
│   ├── ocr_recognizer/     # OCR 文字识别工具
│   └── screenshot_ocr/     # 快捷键截图文字识别
├── resources/styles/       # 全局样式（Slate + Indigo 设计系统）
├── sample_input/           # 示例 PDF
└── output/                 # 输出目录
```

---

## 🔄 更新检查

程序启动时自动从 Gitee 远端仓库拉取 `version.json`，检测是否有新版本发布。如有更新，将在状态栏提示用户。

---

## ⚠️ 已知限制

- 目前仅支持 **Windows 10 / 11（64 位）** 平台，macOS / Linux 尚未适配
- OCR 引擎（PaddleOCR）首次使用需等待模型下载与加载，GPU 加速依赖 CUDA 版 PaddlePaddle。
- 排版转换对**非标准版式**的第三方 App 导出 PDF 可能存在兼容性问题，建议优先使用粉笔 App 导出的 PDF

### 🖥️ RTX 50 系列（Blackwell）GPU 加速尚未支持

由于 PaddlePaddle 版本适配滞后，**RTX 5070 / 5080 / 5090 等 Blackwell 架构显卡目前无法使用 GPU 加速**，OCR 自动回退为 CPU 模式运行。

**技术原因：**

| 组件 | 版本 | 最大支持的 GPU 架构 |
|------|------|:--:|
| PaddlePaddle | 2.6.2 | Ada Lovelace（RTX 40 系列，CC ≤ 8.9） |
| PaddlePaddle | 3.x | Blackwell（RTX 50 系列，CC 12.0）|

当前项目使用 **PaddlePaddle 2.6.2**，原因：
- PaddlePaddle 3.x 的 **Windows GPU 包尚未发布**（国内 PyPI 镜像暂无可用 wheel）
- PaddleOCR 3.x 在 Windows 上存在 **PIR/OneDNN 运行时兼容性 bug**（`ConvertPirAttribute2RuntimeAttribute` 崩溃）

因此项目锁定在 2.6.2 版本，它编译时只支持到 RTX 40 系列的 Compute Capability 8.9。**RTX 50 的 CC 12.0 超出范围**，程序启动时会检测到不兼容的 GPU 并自动回退 CPU。

**影响：**
- CPU 模式下 OCR 速度约为 GPU 的 1/3～1/5，但**识别精度完全不受影响**
- 以 59 页 PDF 为例，CPU 模式约需 60 秒完成全文 OCR

**未来解决路径：**
- 等待 PaddlePaddle 官方 / 国内镜像发布 **3.x Windows GPU wheel**
- 届时只需升级版本号并移除 GPU 架构检测限制，RTX 50 系列即可满血 GPU 加速

---

## 🔮 后续计划
- 暂时脑海中还有一些功能意向，但需要看备考时间是否充裕，再做后续开发计划
- 欢迎大家提 Issue 或 PR，将你的想法说出来，也可通过邮箱联系我

---

## 🔗 友情链接 / Community

- **[linux.do](https://linux.do)** — 新的理想型社区 / a thriving developer community.

---
## 作者支持

如果小工具有帮到您，也欢迎请作者一杯咖啡。

![小工具 作者支持渠道](https://raw.githubusercontent.com/codepmy/civil-servans-tools/master/resources/author-support-poster.png)
## 👨‍💻 关于作者

- **开发者**：CodePmy
- **开发方式**：本项目**全程由 AI 辅助编程**完成
- **反馈与建议**：欢迎提 Issue 或 PR

---

> 公考路上，愿这个小工具能帮你省下一点排版的时间，少一些寻找工具的烦恼，多刷两道题。💪

## 版权与许可

本项目使用的第三方开源组件遵循其各自许可证，详见 [详见](THIRD_PARTY_NOTICES.md)。用户在分发、修改或商用本项目时，应同时遵守相关第三方组件的许可证要求。

本软件仅作为学习、备考和办公辅助工具，不代表任何官方机构。

用户处理的文件版权归用户或原权利人所有，用户应确保资料来源合法。

## 不可以商用
禁止任何商用付费行为

civil-servans-tools

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README