面向扫描版 / 图片型 PDF 的选色清理桌面工具：按颜色替换浅色水印与杂质，支持区域遮盖、灰度、组合多步一次导出与批量处理。
免责声明：请仅处理你有权处理的文档。本工具采用光栅化路线，导出多为图片型 PDF（通常不可再选中文字）。使用后果由使用者自行承担。
| 项 | 内容 |
|---|---|
| 中文名 | 净页 |
| 英文名 | JingYe |
| 包名 | pdf_dewatermark |
| 许可证 | MIT |
| 当前版本 | 见 src/pdf_dewatermark/__init__.py |
| 详细使用说明 | 博客：扫描版 PDF 选色去水印工具说明 |
适合
- 整页是扫描图或伪扫描（几乎选不中字）
- 正文上的浅灰半透明公号字、浅色 logo、固定页眉页脚条
不太适合
- 编辑器可一键删除的矢量水印 / 注释水印（优先用阅读器自带功能）
- 需要保留可选中文字、可检索的 PDF（本工具会光栅化）
| 模块 | 说明 |
|---|---|
| 选色替换 | 多组「目标色 → 背景色」、容差、预览、单页 / 范围 / 全部 |
| 区域遮盖 | 矩形纯色遮盖；可应用到全部 / 奇偶 / 隔页 / 自定义页码 |
| 灰度转换 | 整本转灰度图 PDF |
| 组合处理 | 灰度 · 选色 · 区域在同一渲染上按序处理，一次导出 |
| 批量 | 多文件共用选色页参数队列导出 |
完整图文说明：以蓝博客 · 扫描版 PDF 选色去水印
- Windows 10/11（GUI 与打包脚本按 Windows 编写）
- Python 3.10+（开发机推荐 3.12）
在项目根目录 PowerShell 中：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\dev_setup.ps1脚本会创建 .venv、安装依赖（含 GUI）、可编辑安装本包。
cd <本项目目录>
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -U pip
pip install -e ".[gui,dev]"# 已激活 venv 时
python -m pdf_dewatermark
# 或
.\run_gui.bat入口也可使用：
jingye
pdf-dewatermark-guipdf-dewatermark-cli remove 输入.pdf --r 200 --g 200 --b 200 --tolerance 30 -o 输出.pdf应用内：帮助 → 使用说明 会打开完整在线文档。
- 顶栏 打开 扫描 PDF（全局共用一本）
- 选色替换：吸管点水印色 → 调容差 → 可选「效果」预览
- 若有固定页眉：到 区域遮盖 画框 → 应用到…
- 若要多步：到 组合处理 勾选步骤 → 组合导出
- 导出预设默认 均衡（约 200 DPI + JPEG；扫描页默认不高于原图分辨率）
更多参数、工作流与 FAQ 见：使用说明（博客）。
采用标准 src layout：
.
├── src/pdf_dewatermark/ # 可安装 Python 包
│ ├── core/ # 选色 / 区域 / 灰度 / 页码等算法
│ ├── pdf/ # 打开、渲染、导出 DPI
│ ├── gui/ # PySide6 + Fluent 界面
│ ├── cli.py # 命令行
│ ├── processor.py # 业务编排（含组合流水线）
│ └── models.py
├── tests/ # pytest
├── docs/ # 设计与开发说明
├── legacy/ # 改造前脚本（参考）
├── packaging/ # PyInstaller / 元数据 / Inno 可选
├── scripts/ # 开发环境与打包脚本（dev_setup / build_*）
├── pyproject.toml
├── LICENSE # MIT
└── README.md
不会进入版本库的内容（见 .gitignore）：.venv/、build/、dist/、用户 output/、日志、个人 PDF、本地偏好等。
预编译绿色包请到仓库的 Releases（若已发布）下载；源码树中默认不包含 dist/。
# 建议先完成环境准备，再：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_gui_onedir.ps1产物（均在本地 dist/）：
| 路径 | 含义 |
|---|---|
dist/JingYe/JingYe.exe |
最新可运行目录 |
dist/releases/JingYe-x.y.z.zip |
对外分发用压缩包 |
使用：解压 zip 后保留整个文件夹，运行 JingYe.exe。
可选 Windows 安装包（需本机 Inno Setup 6）：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_installer.ps1更细说明见 docs/04-打包与分发.md。
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
pytest -q- Python 3.10+
- PyMuPDF (fitz) · NumPy · Pillow
- GUI：PySide6 · QFluentWidgets
- 打包：PyInstaller（onedir）
欢迎 Issue / PR：修 bug、改进文档、补充测试均可。较大改动建议先开 Issue 讨论。
提交前请确认未把个人 PDF、data/gui_prefs.json、dist/ 等纳入版本库。
- 依赖与开源生态：PyMuPDF、Qt/PySide、QFluentWidgets、PyInstaller 等
MIT License © 2026 净页 JingYe contributor(s)