发布 PDFReaderLite 0.2.2

This commit is contained in:
2026-07-01 22:29:33 +08:00
parent b6b7e8e05a
commit a76d2dfea7
16 changed files with 3201 additions and 231 deletions
+24 -17
View File
@@ -2,20 +2,27 @@
PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,目标是提供 Adobe Acrobat 常用功能的轻量替代版。
当前稳定版本:`0.2.1`
当前稳定版本:`0.2.2`
## 当前能力
- 多标签打开 PDF。
- 连续阅读、缩放、适应宽度、适应页面、页码跳转。
- 左侧自适应缩略图。
- 阅读、编辑PDF、页面、工具、注释模式切换。
- 文本搜索。
- 指针/手形工具切换,阅读、编辑PDF、页面、工具、注释模式切换。
- 文本搜索,搜索结果跳转并临时高亮。
- PDF 自带目录/书签显示与跳转。
- 真实文本选择,支持复制、右键高亮、添加注释。
- 高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。
- 注释列表、注释跳转、注释删除。
- 添加文本、放置文本、插入图片、放置图片、遮盖区域。
- 高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。
- 注释列表、注释筛选、搜索、排序、仅当前页、导出、跳转、删除。
- 注释属性修改,支持内容、颜色、字号、线宽、透明度等常见属性。
- 鼠标悬停注释符号显示注释内容,双击注释符号可修改注释。
- 添加文本、插入图片、遮盖区域。
- 图片签名、放置签名、手写签名。
- 对象选择、移动、缩放、删除、复制粘贴、图层顺序、对齐与分布。
- 页面旋转、删除、移动、插入、提取、拆分、合并。
- 页面管理支持网格缩略图、多选、批量删除、批量旋转、批量提取、拖入 PDF 插入页面。
- 基础表单填写。
- 导出页面图片、批量导出图片、图片合成 PDF。
- 保存、另存为、加密另存为、移除密码另存为。
@@ -23,26 +30,26 @@ PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工
- 深色模式、窗口状态记忆、异常日志。
- 单文件 exe 打包。
## 第二版计划
## 当前版本重点
第二版重点提升注释和编辑能力:
`0.2.2` 在 `0.2.1` 的阅读、页面管理和基础编辑能力上,重点完善 Acrobat 风格的常用审阅流程:
- 第二版先支持框选区域高亮、下划线、删除线;真实文本选区标注留到第三版。
- 注释属性面板。
- 注释列表筛选和搜索。
- 图章工具。
- 文本框二次编辑,以及新建文本默认字号、颜色。
- 未保存图片、签名、图章对象支持旋转、透明度、裁剪。
- 文本、图片、签名、遮盖、图形注释统一对象选择,常见注释支持复制粘贴。
- 右键菜单、Esc 取消、Delete 删除、方向键微调。
- 未保存状态进一步完善。
- 指针模式下可选择 PDF 真实文本,支持逐字/逐字母选取。
- 双栏文档选择文字时优先按左栏、右栏阅读顺序处理。
- 选择文字后的右键菜单支持多色高亮、复制、添加注释。
- 添加注释后自动高亮所选文字,并保留注释符号和悬停提示。
- 注释模式下可捕捉已有注释,进行属性修改、删除和内容编辑。
- Ctrl+滚轮缩放、页面旋转等操作尽量保持当前页和视图位置。
文档入口:
- [开发计划](docs/development_plan.md)
- [V2 注释与编辑专项计划](docs/v2_annotation_edit_plan.md)
- [V2 需求清单](docs/v2_requirements_checklist.md)
- [V1 发布说明](docs/release_v0.2.1.md)
- [V3 Acrobat 工作流增强计划](docs/v3_acrobat_workflow_plan.md)
- [V4 可选高级能力探索计划](docs/v4_optional_advanced_plan.md)
- [V0.2.2 发布说明](docs/release_v0.2.2.md)
- [V0.2.1 发布说明](docs/release_v0.2.1.md)
V2 验收:
BIN
View File
Binary file not shown.
+41 -12
View File
@@ -7,7 +7,8 @@ PDFReaderLite 是面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,
核心边界:
- 重点做阅读、注释、覆盖式编辑、页面管理、基础表单、视觉签名、导出、密码保护。
- 不做复杂 OCR、PDF 原文重排编辑、数字证书签名、真正永久擦除敏感信息。
- V3 已完成,当前稳定版本为 `v0.2.2`,重点做更像 Acrobat 的常用审阅和编辑流程。
- V4 可重新评估 OCR、导出文本/图片、遮盖标记、签名记录等可选增强,但仍保持轻量边界。
- 打包形态以单文件 exe 为主。
## V1:稳定可用版
@@ -44,9 +45,9 @@ V1 已发布为 `v0.2.1`,发布产物为 `dist/PDFReaderLite.exe`。
## V2:注释与编辑增强版
V2 目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。
V2 已并入当前 `v0.2.2` 代码。目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。
主线:
已完成主线:
- 注释主线:文本选择标注、注释属性、注释列表筛选搜索、图章。
- 编辑主线:文本框二次编辑、对象属性、统一对象选择、复制删除移动缩放。
@@ -54,18 +55,46 @@ V2 目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注
优先功能包见 [V2 注释与编辑专项计划](v2_annotation_edit_plan.md)。
## V3:实用工具增强版
## V3:Acrobat 常用审阅与编辑流程增强版
候选方向:
V3 已并入当前 `v0.2.2` 代码。目标是让高频工作流更接近 Acrobat,但继续坚持“简单、实用、轻量”的原则。
- 水印工具:文字水印、图片水印,支持全部页/指定页。
- 图像编辑增强:裁剪、替换、透明度、旋转。
- 页面对象列表:显示当前页新增对象,点击选中。
- 注释导出:导出为 txt/html/json。
- 简单测量工具:两点距离、线段长度。
- 更完整的表单支持。
已完成主线:
## 长期不纳入范围
- 真实文本选择:选中 PDF 真实文本后直接高亮、下划线、删除线。
- 选区右键菜单:选中文本后弹出多色高亮、复制、添加注释等常用动作。
- 文本框样式:已有 FreeText 文本框支持修改内容、字号和文字颜色。
- 注释列表增强:按页码、类型、创建顺序排序,只看当前页注释,导出 txt/json。
- 页面管理增强:页面管理视图支持多选、批量删除、批量旋转、批量提取。
- 搜索与导航:搜索结果显示上下文,点击跳转并临时高亮;支持 PDF 自带目录/书签面板。
- 对象操作增强:对象复制粘贴尽量保留样式,支持简单对齐和分布。
缺陷修复与体验改进:
- 指针和手形工具互斥,右侧模式按钮互斥,两组状态互不干扰。
- 软件启动默认手形工具,指针工具用于文字选择和复制。
- Ctrl+鼠标滚轮缩放、页面旋转、页面操作后尽量保留当前页和视图位置。
- 双栏文档文字选择优先按栏位处理,降低跨栏误选。
- 对水印、行号、页边元素进行选择过滤,降低误选概率。
- 鼠标悬停注释符号时显示注释内容;双击注释符号可编辑注释。
- 已有文本高亮支持重新选中并修改颜色。
专项计划见 [V3 Acrobat 工作流增强计划](v3_acrobat_workflow_plan.md)。
## V4:可选高级能力探索版
V4 允许重新讨论部分之前不做的功能,但必须保持明确边界,不承诺 Acrobat Pro 级完整能力。
可选方向:
- OCR:可做外部 OCR 插件或可选安装,不内置到单 exe。
- PDF 导出:可做导出文本、导出图片,不承诺 PDF 转 Word 并保持原排版。
- 敏感信息处理:可做遮盖标记和风险提示,不宣称真正永久擦除。
- 签名:可做签名图片和签名记录,不做数字证书级签名。
专项计划见 [V4 可选高级能力探索计划](v4_optional_advanced_plan.md)。
## 长期保持谨慎的范围
- PDF 转 Word 并保持原排版。
- PDF 转 Excel 并保持表格结构。
+54
View File
@@ -0,0 +1,54 @@
# PDFReaderLite v0.2.2 发布说明
发布日期:2026-07-01
## 发布产物
当前为源码版本升级。打包后产物仍为:
```text
dist\PDFReaderLite.exe
```
版本信息:
- 应用版本:`0.2.2`
- exe 版本:`0.2.2`
- 文件大小:`49,463,139 bytes`
- SHA256:`0A7701E9F10D23009CF22C8188A094DA1DDBCAF8C2455D352546EB65A9B74CBA`
- Git 标签:待发布后填写
## 本版定位
`0.2.2` 是第三版审阅与编辑流程增强后的稳定版本,重点完善 Acrobat 风格的文本选择、注释、页面管理和视图保持体验。
## 主要新增与完善
- 指针模式支持选择 PDF 真实文本,并支持逐字、逐字母选择。
- 选中文本后右键菜单支持复制、多色高亮、下划线、删除线、添加注释。
- 高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。
- 添加注释时可自动高亮所选文字,并在页面上保留注释符号。
- 鼠标悬停注释符号显示注释内容;双击注释符号可修改注释内容。
- 注释模式下可捕捉已有注释,进行属性修改和删除。
- 已有文本高亮可重新选中并修改颜色。
- 双栏文档文字选择按栏位优化,降低左栏、右栏混选。
- 带水印、行号文档的文字选择增加过滤,降低误选页边内容。
- 左侧目录页签支持读取 PDF 自带书签并跳转。
- 注释列表支持类型筛选、关键字搜索、仅当前页、排序和导出 JSON/TXT。
- 页面管理支持多选、批量删除、批量旋转、批量提取,以及拖入 PDF 插入页面。
- 对象操作支持多选后的对齐和分布。
- Ctrl+鼠标滚轮缩放、页面旋转、页面操作后尽量保留当前页和视图位置。
- 指针/手形工具互斥,右侧阅读、编辑PDF、页面、工具、注释模式互斥,两组状态互不干扰。
## 已验证
- 源码冒烟测试通过。
- Python 编译检查通过。
- 版本号已同步到应用、包元数据和 Windows exe 版本资源。
## 已知边界
- 当前编辑仍属于覆盖式编辑,不是 PDF 原文段落级重排编辑。
- 遮盖区域是视觉遮盖,不是敏感信息永久擦除。
- 选区快捷操作当前采用右键菜单,悬浮迷你工具条保留为后续可选优化。
- OCR、数字证书签名、自动更新不在当前版本范围。
+11 -5
View File
@@ -1,5 +1,11 @@
# V2 注释与编辑专项计划
## 当前状态
V2 已并入当前 `v0.2.2` 代码。原 V2 目标中的框选区域标注、注释属性、注释列表、图章、文本框二次编辑、统一对象选择、右键菜单、键盘操作和未保存提示均已完成。
后续 V3 已继续补齐真实文本选择、多色高亮、选区添加注释、目录面板、页面管理批处理、注释导出和对象对齐分布等能力。本文档保留为 V2 需求来源和验收记录。
## 目标
V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”进入“审阅和覆盖式编辑顺手”的阶段。
@@ -20,19 +26,19 @@ V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”
第二版实施边界:
- 第二版先做框选区域标注,可用于普通文本 PDF 和扫描/图片型 PDF。
- 真正识别 PDF 文本选区、选中文本后的迷你工具条,延期到第三版。
- 真正识别 PDF 文本选区、选中文本后的快捷操作已在 V3 / `v0.2.2` 中完成,当前以右键菜单形式提供。
目标:
- 鼠标选中页面文字后,可直接执行高亮、下划线、删除线。
- 选中文本后可出现迷你工具条,提供高亮、下划线、删除线、复制、添加批注。
- 选中文本后可通过右键菜单执行高亮、下划线、删除线、复制、添加批注;悬浮迷你工具条作为后续可选优化。
- 对无法识别文本的扫描页,保留现有输入文字标注方式。
验收标准:
- 可在普通文本 PDF 中选中一段文字并直接添加标注。
- 标注后注释列表自动刷新。
- Esc 可取消当前选区或迷你工具条。
- Esc 可取消当前选区或快捷菜单相关状态。
### 2. 注释属性面板
@@ -77,7 +83,7 @@ V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”
- 支持拖动、缩放、删除。
- 双击文本框可修改内容。
- 第二版支持设置新建文本框的默认字号、颜色。
- 已有文本框样式编辑和中文文本加粗延期到第三版。
- 已有文本框内容、字号、文字颜色编辑已完成;中文文本加粗暂不作为当前承诺能力。
验收标准:
@@ -97,7 +103,7 @@ V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”
- 文本、图片、签名、遮盖、图形注释使用统一选择框和控制点。
- 右键菜单支持删除、复制、属性。
- 第二版支持常见注释对象复制粘贴;复杂 PDF 原生对象复制延期到第三版。
- 当前支持常见注释对象复制粘贴并尽量保留样式;复杂 PDF 原生对象仍不承诺完整编辑。
- 键盘 Delete 删除,Esc 取消选择。
- 方向键微调位置,Shift+方向键大步移动。
+9 -4
View File
@@ -1,12 +1,14 @@
# V2 需求清单
当前状态:V2 已完成并并入 `v0.2.2`;V3 又补齐了真实文本选择、选区右键菜单、注释导出、目录面板和页面管理批处理等增强能力。
## 注释:新增功能
- [x] 框选区域后直接高亮。
- [x] 框选区域后直接下划线。
- [x] 框选区域后直接删除线。
- [ ] 鼠标选择真实文本后直接高亮、下划线、删除线。(V3)
- [ ] 选中文本后的迷你工具条。(V3)
- [x] 鼠标选择真实文本后直接高亮、下划线、删除线。(V3 / 0.2.2)
- [x] 选中文本后的快捷操作菜单。(V3 / 0.2.2,当前为右键菜单;悬浮迷你工具条保留为后续可选优化)
- [x] 注释属性面板。
- [x] 注释颜色设置。
- [x] 注释线宽设置。
@@ -35,7 +37,7 @@
- [x] 文本框双击编辑内容。
- [x] 新建文本框默认字号设置。
- [x] 新建文本框默认颜色设置。
- [ ] 文本框加粗设置。(V3,需确认中文 FreeText 加粗方案)
- [ ] 文本框加粗设置。(暂不承诺,需确认中文 FreeText 加粗方案)
- [x] 添加文本后自动选中新对象。
- [x] 图片替换。
- [x] 未保存图片/签名/图章对象旋转。
@@ -78,7 +80,10 @@
## 验收测试建议
- [x] 普通文本 PDF:框选区域后高亮、下划线、删除线。
- [ ] 普通文本 PDF:选择真实文字后高亮、下划线、删除线。(V3)
- [x] 普通文本 PDF:选择真实文字后高亮、下划线、删除线。(V3 / 0.2.2)
- [x] 普通文本 PDF:选择文字后右键多色高亮、复制、添加注释。
- [x] 双栏文本 PDF:选择文字时优先按栏位处理,降低跨栏误选。
- [x] 带水印、行号 PDF:选择文字时过滤常见页边和水印干扰。
- [x] 扫描/图片型 PDF:区域高亮、图章、画笔仍可使用。
- [x] 多页 PDF:注释列表筛选、搜索、跳转、属性编辑正确。
- [x] 多标签 PDF:每个标签的未保存状态独立。
+182
View File
@@ -0,0 +1,182 @@
# V3 Acrobat 工作流增强计划
## 当前实现进度
- 当前 V3 能力已并入 `v0.2.2`。
- 已完成:真实文本框选识别、选区高亮、下划线、删除线、复制文字、选区批注。
- 已完成:选区快捷操作以轻量右键菜单实现;后续如需要,可再升级为悬浮迷你工具条。
- 已完成:右键高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。
- 已完成:添加注释时自动高亮所选文字,并保留注释符号和悬停提示。
- 已完成:选中注释符号后双击可编辑注释内容。
- 已完成:已有 FreeText 文本框可在右侧属性中修改内容、字号和文字颜色。
- 已完成:注释列表支持类型筛选、关键字搜索、仅当前页、排序、导出 JSON/TXT。
- 已完成:搜索结果点击后在页面上临时高亮命中区域。
- 已完成:左侧新增目录页签,可读取 PDF 自带书签并跳转。
- 已完成:页面管理支持多选、批量删除、批量左旋/右旋、提取所选页面。
- 已完成:常见注释复制粘贴时尽量保留颜色、填充色、线宽、透明度和内容。
- 已完成:页面对象支持多选后的左/中/右、顶/中/底对齐,以及水平/垂直分布。
- 已完成:页面管理支持从资源管理器拖入 PDF,并按释放位置插入外部 PDF 页面。
- 已完成:Ctrl+滚轮缩放、旋转页面、页面操作后尽量保持当前页和视图位置。
- 已完成:双栏文档文字选择按栏位优化,带水印和行号文档选择时过滤常见干扰。
- 当前 V3 计划项已完成,后续进入打包、人工验收和缺陷修复。
## 目标
V3 目标是让 PDFReaderLite 的高频审阅和覆盖式编辑流程更接近 Adobe Acrobat 常用操作,但继续保持轻量、中文、Windows 单机使用优先。
核心原则:
- 优先做简单实用的常用功能。
- 真实文本选择和注释快捷操作优先于复杂格式转换。
- 继续保留扫描件/图片型 PDF 的框选区域标注作为兜底方案。
- 不做 PDF 原文段落级重排编辑。
- 所有新增功能都要能保存、撤销或明确提示不可撤销边界。
## 第一优先级
### 1. 真实文本选择与快捷标注
目标:
- 鼠标拖选 PDF 真实文本后,可直接高亮、下划线、删除线。
- 支持复制选中文本。
- 支持对选中文本添加批注。
- 扫描件或无法识别文本时,继续使用 V2 的框选区域标注。
建议实现:
- 在页面视图中维护文本选区。
- 使用 PyMuPDF 的文本块/词坐标识别选中区域对应文字。
- 对真实文本使用 PDF 原生 highlight/underline/strikeout 注释。
- 选区取消支持 Esc、点击空白处、切换模式。
验收标准:
- 普通文本 PDF 可拖选一段文字并添加三种标注。
- 标注后右侧注释列表和属性面板自动刷新。
- 扫描件上不崩溃,并能继续使用区域标注。
### 2. 选中文本后的快捷操作
目标:
- 选中文本后提供快捷操作。
- 快捷操作包含:多色高亮、下划线、删除线、复制、批注。
- Esc、点击空白处或切换操作后取消选区。
建议实现:
- 当前实现为右键菜单,稳定后可再评估是否升级为悬浮迷你工具条。
- 注释操作需在可编辑模式下执行;阅读模式仍保留文本选择和复制能力。
验收标准:
- 菜单不会遮挡主要阅读流程。
- 菜单动作与右侧注释列表同步。
- 切换页码、缩放、滚动后选区状态保持可控。
### 3. 已有文本框样式编辑
目标:
- 已写入 PDF 的 FreeText 文本框可编辑字号、颜色、加粗、对齐方式。
- 新建文本框继续使用默认文本样式。
边界:
- 中文加粗需要优先验证 PyMuPDF FreeText 的稳定方案。
- 如果中文加粗不稳定,可采用“仅新建文本支持样式预设,已有文本暂不强制加粗”的降级方案。
验收标准:
- 双击文本框可修改内容。
- 选中文本框后右侧属性可修改字号、颜色。
- 保存重开后样式存在。
## 第二优先级
### 4. 注释列表增强
目标:
- 支持按页码、类型、创建顺序排序。
- 支持只显示当前页注释。
- 支持导出注释为 txt/json。
建议导出内容:
- 页码。
- 注释类型。
- 注释内容。
- 矩形坐标。
- 导出时间。
验收标准:
- 多页 PDF 中筛选、排序、搜索组合使用正确。
- 导出文件中文正常。
### 5. 页面管理多选与批处理
目标:
- 页面管理视图支持多选。
- 支持批量删除、批量旋转、批量提取。
- 拖拽重排时显示插入位置。
- 支持从资源管理器拖入 PDF 到页面管理视图并插入。
验收标准:
- 多选页面批处理后页码顺序正确。
- 保存重开后页面顺序和内容正确。
- 操作前有明确确认,避免误删。
### 6. 搜索结果上下文与目录面板
目标:
- 搜索结果显示命中页码和前后上下文。
- 点击搜索结果跳转并临时高亮命中区域。
- 如果 PDF 自带目录/书签,则显示目录面板。
验收标准:
- 多页搜索结果定位准确。
- 没有目录的 PDF 不显示空白噪音。
## 第三优先级
### 7. 对象对齐与分布
目标:
- 多对象选择后支持左对齐、居中、右对齐。
- 支持水平/垂直分布。
边界:
- V3 可先支持当前会话对象和常见注释对象。
- 复杂 PDF 原生对象仍不承诺完整编辑。
### 8. 复制粘贴保留样式
目标:
- 注释对象复制粘贴时尽量保留颜色、线宽、透明度、内容。
- 文本框复制粘贴尽量保留字号、颜色。
验收标准:
- 常见注释复制后视觉效果接近原对象。
- 不支持的对象类型给出提示,不静默失败。
## 建议实施顺序
1. 真实文本选择基础能力。
2. 真实文本高亮、下划线、删除线。
3. 选区右键快捷菜单。
4. 已有文本框样式编辑。
5. 注释列表排序、当前页过滤、导出。
6. 页面管理多选和批处理。
7. 搜索上下文和目录面板。
8. 对象对齐、样式复制等增强。
+116
View File
@@ -0,0 +1,116 @@
# V4 可选高级能力探索计划
## 目标
V4 用于探索部分更高级但仍保持轻量边界的功能。V4 不追求完整替代 Acrobat Pro,也不承诺复杂版面重建、证书签名或真正永久擦除。
核心原则:
- 高风险能力采用可选安装、外部工具或明确降级方案。
- 不把大型 OCR 引擎内置进单文件 exe。
- 对用户可能误解的安全能力必须给出明确提示。
- 优先提供“可用、可解释、不会误导”的轻量能力。
## 可选方向
### 1. OCR 外部插件或可选安装
目标:
- 支持调用外部 OCR 工具识别当前页或指定页。
- 可选生成简单文本层或导出 OCR 文本。
边界:
- 不内置完整 OCR 到单 exe。
- 不承诺高质量可搜索 PDF。
- 不承诺扫描件自动版面分析。
建议方案:
- 软件设置中配置外部 OCR 程序路径。
- 支持按页导出图片后交给外部 OCR。
- OCR 结果先以 txt 或侧边栏文本方式展示。
验收标准:
- 未配置外部 OCR 时界面给出清晰提示。
- OCR 失败不影响原 PDF。
### 2. PDF 导出文本/图片
目标:
- 支持导出当前页或全部页文本。
- 支持导出当前页或全部页图片。
- 可选将导出的文本按页分段保存。
边界:
- 不承诺 PDF 转 Word 并保持原排版。
- 不承诺 PDF 转 Excel 并保持表格结构。
- 表格导出仅作为后续探索,不放入 V4 必做项。
验收标准:
- 普通文本 PDF 能导出可读 txt。
- 扫描件无文本时给出提示。
- 图片导出沿用已有页面图片导出能力,不重复造复杂流程。
### 3. 敏感信息遮盖标记
目标:
- 在遮盖工具基础上增加“敏感信息遮盖标记”模式。
- 遮盖对象有特殊名称或列表标识,便于检查。
- 保存前提示:这是视觉遮盖,不是真正永久擦除。
边界:
- 不宣称真正永久擦除敏感信息。
- 不自动删除 PDF 内部文本、对象、元数据。
- 如果未来做真正擦除,需要单独设计和专项验证。
验收标准:
- 用户能区分普通遮盖和敏感信息遮盖标记。
- 导出或保存前有明确风险提示。
### 4. 签名图片与签名记录
目标:
- 在现有图片签名、点击放置签名、手写签名基础上增加签名记录。
- 记录签名时间、页码、位置、签名图片名称或摘要。
- 可导出签名记录 txt/json。
边界:
- 不做数字证书级签名。
- 不做法律意义上的签名验证。
- 不承诺防篡改。
验收标准:
- 添加签名后可在签名记录列表中看到记录。
- 保存重开后签名图片仍在 PDF 中。
- 签名记录导出中文正常。
## 暂不纳入 V4 必做项
- PDF 转 Word 并保持原排版。
- PDF 转 Excel 并保持表格结构。
- OCR 生成高质量可搜索 PDF。
- 扫描件自动版面分析。
- 数字证书签名。
- 敏感信息真正永久擦除。
- 自动更新。
- 单 exe 内置完整 OCR。
## 建议实施顺序
1. 导出文本能力。
2. 敏感信息遮盖标记和风险提示。
3. 签名记录列表与导出。
4. 外部 OCR 配置和单页 OCR 文本导出。
+4 -4
View File
@@ -1,8 +1,8 @@
# UTF-8
VSVersionInfo(
ffi=FixedFileInfo(
filevers=(0, 2, 1, 0),
prodvers=(0, 2, 1, 0),
filevers=(0, 2, 2, 0),
prodvers=(0, 2, 2, 0),
mask=0x3f,
flags=0x0,
OS=0x40004,
@@ -17,11 +17,11 @@ VSVersionInfo(
[
StringStruct("CompanyName", "PDFReaderLite"),
StringStruct("FileDescription", "PDFReaderLite"),
StringStruct("FileVersion", "0.2.1"),
StringStruct("FileVersion", "0.2.2"),
StringStruct("InternalName", "PDFReaderLite"),
StringStruct("OriginalFilename", "PDFReaderLite.exe"),
StringStruct("ProductName", "PDFReaderLite"),
StringStruct("ProductVersion", "0.2.1"),
StringStruct("ProductVersion", "0.2.2"),
],
)
]),
+1 -1
View File
@@ -1 +1 @@
__version__ = "0.2.1"
__version__ = "0.2.2"
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
+178 -6
View File
@@ -1,14 +1,21 @@
from __future__ import annotations
from PySide6.QtCore import QSize, Qt
from PySide6.QtGui import QDragEnterEvent, QDropEvent, QIcon, QPixmap
from pathlib import Path
import fitz
from PySide6.QtCore import QSize, Qt, Signal
from PySide6.QtGui import QDragEnterEvent, QDropEvent, QIcon, QImage, QPixmap
from PySide6.QtWidgets import (
QAbstractItemView,
QDialog,
QDialogButtonBox,
QFileDialog,
QHBoxLayout,
QLabel,
QListWidget,
QListWidgetItem,
QMessageBox,
QPushButton,
QVBoxLayout,
)
@@ -16,6 +23,8 @@ from pdfreaderlite.core.document import PdfDocument
class PageGrid(QListWidget):
pdf_files_dropped = Signal(list, int)
def __init__(self) -> None:
super().__init__()
self.setViewMode(QListWidget.ViewMode.IconMode)
@@ -28,32 +37,82 @@ class PageGrid(QListWidget):
self.setGridSize(QSize(178, 230))
self.setDragDropMode(QAbstractItemView.DragDropMode.InternalMove)
self.setDefaultDropAction(Qt.DropAction.MoveAction)
self.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
self.setSelectionMode(QAbstractItemView.SelectionMode.ExtendedSelection)
def dropEvent(self, event: QDropEvent) -> None:
paths = self._dropped_pdf_paths(event)
if paths:
row = self.indexAt(event.position().toPoint()).row()
self.pdf_files_dropped.emit(paths, row if row >= 0 else self.count())
event.acceptProposedAction()
return
super().dropEvent(event)
self._renumber_items()
def dragEnterEvent(self, event: QDragEnterEvent) -> None:
if self._dropped_pdf_paths(event):
event.acceptProposedAction()
return
event.acceptProposedAction()
def dragMoveEvent(self, event) -> None:
if self._dropped_pdf_paths(event):
event.acceptProposedAction()
return
super().dragMoveEvent(event)
def _dropped_pdf_paths(self, event: QDragEnterEvent | QDropEvent) -> list[str]:
if not event.mimeData().hasUrls():
return []
paths: list[str] = []
for url in event.mimeData().urls():
if not url.isLocalFile():
continue
path = Path(url.toLocalFile())
if path.suffix.lower() == ".pdf":
paths.append(str(path))
return paths
def _renumber_items(self) -> None:
for row in range(self.count()):
item = self.item(row)
original_page = item.data(Qt.ItemDataRole.UserRole) + 1
item.setText(f"位置 {row + 1}\n原第 {original_page} 页")
entry = item.data(Qt.ItemDataRole.UserRole)
if isinstance(entry, dict) and entry.get("source") == "external":
item.setText(
f"位置 {row + 1}\n插入 {Path(str(entry['path'])).name}\n第 {int(entry['page_index']) + 1} 页"
)
else:
original_page = int(entry) + 1
item.setText(f"位置 {row + 1}\n原第 {original_page} 页")
class PageManagerDialog(QDialog):
def __init__(self, document: PdfDocument, parent=None) -> None:
super().__init__(parent)
self.document = document
self.rotations: dict[int, int] = {}
self.setWindowTitle("页面管理")
self.resize(920, 680)
self.grid = PageGrid()
hint = QLabel("拖拽缩略图调整页面顺序,点击“应用”后写入当前 PDF。")
self.grid.pdf_files_dropped.connect(self.insert_external_pdfs)
hint = QLabel("拖拽缩略图调整页面顺序,可多选后批量删除、旋转或提取,点击“应用”后写入当前 PDF。")
hint.setWordWrap(True)
delete_button = QPushButton("删除所选")
rotate_left_button = QPushButton("左旋所选")
rotate_right_button = QPushButton("右旋所选")
extract_button = QPushButton("提取所选")
delete_button.clicked.connect(self.delete_selected_pages)
rotate_left_button.clicked.connect(lambda: self.rotate_selected_pages(-90))
rotate_right_button.clicked.connect(lambda: self.rotate_selected_pages(90))
extract_button.clicked.connect(self.extract_selected_pages)
action_layout = QHBoxLayout()
action_layout.addWidget(delete_button)
action_layout.addWidget(rotate_left_button)
action_layout.addWidget(rotate_right_button)
action_layout.addWidget(extract_button)
action_layout.addStretch(1)
buttons = QDialogButtonBox(
QDialogButtonBox.StandardButton.Apply | QDialogButtonBox.StandardButton.Cancel
@@ -64,6 +123,7 @@ class PageManagerDialog(QDialog):
layout = QVBoxLayout(self)
layout.addWidget(hint)
layout.addLayout(action_layout)
layout.addWidget(self.grid, 1)
layout.addWidget(buttons)
@@ -73,8 +133,98 @@ class PageManagerDialog(QDialog):
return [
self.grid.item(row).data(Qt.ItemDataRole.UserRole)
for row in range(self.grid.count())
if isinstance(self.grid.item(row).data(Qt.ItemDataRole.UserRole), int)
]
def page_plan(self) -> list[dict[str, object]]:
plan: list[dict[str, object]] = []
for row in range(self.grid.count()):
entry = self.grid.item(row).data(Qt.ItemDataRole.UserRole)
if isinstance(entry, dict):
plan.append(entry)
else:
plan.append({"source": "current", "page_index": int(entry)})
return plan
def selected_pages(self) -> list[int]:
pages = [
item.data(Qt.ItemDataRole.UserRole)
for item in self.grid.selectedItems()
if isinstance(item.data(Qt.ItemDataRole.UserRole), int)
]
return sorted(set(pages))
def delete_selected_pages(self) -> None:
selected_items = self.grid.selectedItems()
if not selected_items:
return
if self.grid.count() - len(selected_items) <= 0:
QMessageBox.information(self, "删除页面", "PDF 至少需要保留一页。")
return
reply = QMessageBox.question(
self,
"删除页面",
f"确定从当前页面管理列表中删除 {len(selected_items)} 页吗?",
QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
)
if reply != QMessageBox.StandardButton.Yes:
return
for item in selected_items:
self.grid.takeItem(self.grid.row(item))
self.grid._renumber_items()
def insert_external_pdfs(self, paths: list[str], insert_row: int) -> None:
row = max(0, min(insert_row, self.grid.count()))
inserted = 0
for path in paths:
try:
with fitz.open(path) as source:
for page_index in range(source.page_count):
item = self._external_page_item(path, source, page_index)
self.grid.insertItem(row + inserted, item)
inserted += 1
except Exception as exc:
QMessageBox.warning(self, "插入 PDF", f"无法读取外部 PDF:\n{path}\n\n{exc}")
if inserted:
self.grid._renumber_items()
def rotate_selected_pages(self, degrees: int) -> None:
pages = self.selected_pages()
if not pages:
return
for page_index in pages:
self.rotations[page_index] = (self.rotations.get(page_index, 0) + degrees) % 360
self._renumber_with_rotation()
def extract_selected_pages(self) -> None:
pages = self.selected_pages()
if not pages:
return
target, _ = QFileDialog.getSaveFileName(
self,
"提取所选页面",
"PDFReaderLite_提取页面.pdf",
"PDF 文件 (*.pdf)",
)
if not target:
return
try:
self.document.extract_pages([page + 1 for page in pages], target)
QMessageBox.information(self, "提取页面", "所选页面已提取为新 PDF。")
except Exception as exc:
QMessageBox.critical(self, "提取失败", f"无法提取所选页面:\n{exc}")
def _renumber_with_rotation(self) -> None:
self.grid._renumber_items()
for row in range(self.grid.count()):
item = self.grid.item(row)
original_page = item.data(Qt.ItemDataRole.UserRole)
if not isinstance(original_page, int):
continue
rotation = self.rotations.get(original_page, 0)
if rotation:
item.setText(f"{item.text()}\n旋转 {rotation}°")
def _load_pages(self) -> None:
for page_index in range(self.document.page_count):
image = self.document.render_thumbnail(page_index, width=150)
@@ -85,3 +235,25 @@ class PageManagerDialog(QDialog):
item.setData(Qt.ItemDataRole.UserRole, page_index)
item.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
self.grid.addItem(item)
def _external_page_item(self, path: str, source: fitz.Document, page_index: int) -> QListWidgetItem:
page = source.load_page(page_index)
zoom = 150 / page.rect.width
pixmap = page.get_pixmap(matrix=fitz.Matrix(zoom, zoom), alpha=False)
image = QImage(
pixmap.samples,
pixmap.width,
pixmap.height,
pixmap.stride,
QImage.Format.Format_RGB888,
).copy()
item = QListWidgetItem(
QIcon(QPixmap.fromImage(image)),
f"插入 {Path(path).name}\n第 {page_index + 1} 页",
)
item.setData(
Qt.ItemDataRole.UserRole,
{"source": "external", "path": path, "page_index": page_index},
)
item.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
return item
+474 -8
View File
@@ -1,6 +1,6 @@
from __future__ import annotations
from PySide6.QtCore import QPoint, QPointF, QRectF, Qt, Signal
from PySide6.QtCore import QPoint, QPointF, QRectF, Qt, QTimer, Signal
from PySide6.QtGui import QColor, QContextMenuEvent, QMouseEvent, QPainter, QPen, QPixmap, QWheelEvent
from PySide6.QtWidgets import QGraphicsDropShadowEffect, QLabel, QScrollArea, QSizePolicy, QVBoxLayout, QWidget
@@ -10,31 +10,57 @@ from pdfreaderlite.core.document import PdfDocument
class PageLabel(QLabel):
stroke_finished = Signal(list)
placement_requested = Signal(QPointF)
hand_pan_delta = Signal(QPointF)
area_selection_finished = Signal(QRectF)
text_selection_preview_changed = Signal(QRectF, QPointF, QPointF)
text_selection_finished = Signal(QRectF, QPointF, QPointF)
text_selection_click_requested = Signal(QPointF)
text_selection_context_requested = Signal(QPointF)
shape_placement_finished = Signal(str, QPointF, QPointF)
object_select_requested = Signal(QPointF)
object_rect_changed = Signal(QRectF)
object_context_requested = Signal(QPointF)
object_double_clicked = Signal(QPointF)
annotation_double_clicked = Signal(QPointF)
annotation_hover_requested = Signal(QPointF)
def __init__(self, text: str = "") -> None:
super().__init__(text)
self.drawing_enabled = False
self.placement_enabled = False
self.area_selection_enabled = False
self.text_selection_enabled = False
self.shape_placement_enabled = False
self.shape_placement_kind = ""
self.hand_pan_enabled = False
self.object_edit_enabled = False
self.selected_rect: QRectF | None = None
self.selected_rects: list[QRectF] = []
self.overlay_images: list[dict[str, object]] = []
self.search_highlights: list[tuple[float, float, float, float]] = []
self.text_selection_highlights: list[tuple[float, float, float, float]] = []
self._drawing = False
self._selecting_area = False
self._selecting_text = False
self._placing_shape = False
self._hand_panning = False
self._stroke: list[QPointF] = []
self._area_start = QPointF()
self._area_rect = QRectF()
self._shape_start = QPointF()
self._shape_end = QPointF()
self._dragging_object = False
self._resizing_object = False
self._drag_start = QPointF()
self._drag_origin_rect = QRectF()
self._hand_last_pos = QPointF()
def mousePressEvent(self, event: QMouseEvent) -> None:
if self.hand_pan_enabled and event.button() == Qt.MouseButton.LeftButton:
self._hand_panning = True
self._hand_last_pos = event.position()
self.setCursor(Qt.CursorShape.ClosedHandCursor)
return
if self.placement_enabled and event.button() == Qt.MouseButton.LeftButton:
self.placement_requested.emit(event.position())
return
@@ -44,6 +70,30 @@ class PageLabel(QLabel):
self._area_rect = QRectF(self._area_start, self._area_start)
self.update()
return
if self.text_selection_enabled and event.button() == Qt.MouseButton.LeftButton:
self._selecting_text = True
self._area_start = event.position()
self._area_rect = QRectF(self._area_start, self._area_start)
self.text_selection_preview_changed.emit(self._area_rect, self._area_start, event.position())
self.update()
return
if self.shape_placement_enabled and event.button() == Qt.MouseButton.LeftButton:
if not self._placing_shape:
self._placing_shape = True
self._shape_start = event.position()
self._shape_end = event.position()
self.update()
return
self._placing_shape = False
self._shape_end = event.position()
self.update()
if (self._shape_end - self._shape_start).manhattanLength() >= 8:
self.shape_placement_finished.emit(
self.shape_placement_kind,
self._shape_start,
self._shape_end,
)
return
if self.object_edit_enabled and event.button() == Qt.MouseButton.LeftButton:
if self.selected_rect and self._resize_handle_rect().contains(event.position()):
self._resizing_object = True
@@ -68,9 +118,17 @@ class PageLabel(QLabel):
if self.object_edit_enabled and event.button() == Qt.MouseButton.LeftButton:
self.object_double_clicked.emit(event.position())
return
if event.button() == Qt.MouseButton.LeftButton:
self.annotation_double_clicked.emit(event.position())
return
super().mouseDoubleClickEvent(event)
def mouseMoveEvent(self, event: QMouseEvent) -> None:
if self._hand_panning:
delta = event.position() - self._hand_last_pos
self._hand_last_pos = event.position()
self.hand_pan_delta.emit(delta)
return
if self._dragging_object and self.selected_rect:
delta = event.position() - self._drag_start
self.selected_rect = self._drag_origin_rect.translated(delta)
@@ -92,9 +150,24 @@ class PageLabel(QLabel):
self._area_rect = QRectF(self._area_start, event.position()).normalized()
self.update()
return
if self._selecting_text:
self._area_rect = QRectF(self._area_start, event.position()).normalized()
self.text_selection_preview_changed.emit(self._area_rect, self._area_start, event.position())
self.update()
return
if self._placing_shape:
self._shape_end = event.position()
self.update()
return
self.annotation_hover_requested.emit(event.position())
super().mouseMoveEvent(event)
def mouseReleaseEvent(self, event: QMouseEvent) -> None:
if self._hand_panning and event.button() == Qt.MouseButton.LeftButton:
self._hand_panning = False
if self.hand_pan_enabled:
self.setCursor(Qt.CursorShape.OpenHandCursor)
return
if self._dragging_object and event.button() == Qt.MouseButton.LeftButton:
self._dragging_object = False
if self.selected_rect:
@@ -120,9 +193,22 @@ class PageLabel(QLabel):
if rect.width() >= 8 and rect.height() >= 8:
self.area_selection_finished.emit(rect)
return
if self._selecting_text and event.button() == Qt.MouseButton.LeftButton:
self._selecting_text = False
rect = self._area_rect.normalized()
self._area_rect = QRectF()
self.update()
if rect.width() >= 8 and rect.height() >= 8:
self.text_selection_finished.emit(rect, self._area_start, event.position())
else:
self.text_selection_click_requested.emit(event.position())
return
super().mouseReleaseEvent(event)
def contextMenuEvent(self, event: QContextMenuEvent) -> None:
if self.text_selection_enabled:
self.text_selection_context_requested.emit(QPointF(event.pos()))
return
if self.object_edit_enabled:
self.object_context_requested.emit(QPointF(event.pos()))
return
@@ -151,14 +237,35 @@ class PageLabel(QLabel):
painter.setPen(QPen(Qt.GlobalColor.blue, 2, Qt.PenStyle.DashLine))
painter.drawRect(self.selected_rect)
painter.fillRect(self._resize_handle_rect(), Qt.GlobalColor.blue)
for rect in self.selected_rects:
painter.setPen(QPen(QColor("#1f6fd1"), 2, Qt.PenStyle.DashLine))
painter.drawRect(rect)
for x0, y0, x1, y1 in self.search_highlights:
highlight_rect = QRectF(x0, y0, x1 - x0, y1 - y0)
painter.setPen(QPen(QColor("#d18b00"), 1, Qt.PenStyle.SolidLine))
painter.fillRect(highlight_rect, QColor(255, 214, 72, 95))
painter.drawRect(highlight_rect)
for x0, y0, x1, y1 in self.text_selection_highlights:
selection_rect = QRectF(x0, y0, x1 - x0, y1 - y0)
painter.setPen(Qt.PenStyle.NoPen)
painter.fillRect(selection_rect, QColor(43, 120, 215, 118))
if self._stroke:
painter.setPen(QPen(Qt.GlobalColor.black, 2, Qt.PenStyle.SolidLine, Qt.PenCapStyle.RoundCap))
for index in range(1, len(self._stroke)):
painter.drawLine(self._stroke[index - 1], self._stroke[index])
if not self._area_rect.isNull():
if not self._area_rect.isNull() and not self._selecting_text:
painter.setPen(QPen(QColor("#2d73c5"), 2, Qt.PenStyle.DashLine))
painter.fillRect(self._area_rect, QColor(45, 115, 197, 38))
painter.drawRect(self._area_rect)
if self._placing_shape:
painter.setPen(QPen(QColor("#2d73c5"), 2, Qt.PenStyle.DashLine))
rect = QRectF(self._shape_start, self._shape_end).normalized()
if self.shape_placement_kind == "circle":
painter.drawEllipse(rect)
elif self.shape_placement_kind in {"line", "arrow"}:
painter.drawLine(self._shape_start, self._shape_end)
else:
painter.drawRect(rect)
def _resize_handle_rect(self) -> QRectF:
if not self.selected_rect:
@@ -205,10 +312,17 @@ class PdfViewer(QScrollArea):
ink_stroke_finished = Signal(int, list)
placement_requested = Signal(int, tuple)
area_selection_finished = Signal(int, tuple)
text_selection_preview_changed = Signal(int, tuple, tuple, tuple)
text_selection_finished = Signal(int, tuple, tuple, tuple)
text_selection_click_requested = Signal(int, tuple)
text_selection_context_requested = Signal(int, tuple)
shape_placement_finished = Signal(int, str, tuple, tuple)
object_select_requested = Signal(int, tuple)
object_rect_changed = Signal(int, tuple)
object_context_requested = Signal(int, tuple)
object_double_clicked = Signal(int, tuple)
annotation_double_clicked = Signal(int, tuple)
annotation_hover_requested = Signal(int, tuple)
def __init__(self) -> None:
super().__init__()
@@ -217,7 +331,10 @@ class PdfViewer(QScrollArea):
self.zoom = 1.2
self._page_labels: list[PageLabel] = []
self._overlay_images: list[dict[str, object]] = []
self._search_highlights: dict[int, list[tuple[float, float, float, float]]] = {}
self._text_selection_highlights: dict[int, list[tuple[float, float, float, float]]] = {}
self._selected_object_rect: tuple[float, float, float, float] | None = None
self._selected_object_rects: list[tuple[float, float, float, float]] = []
self._selected_object_page_index: int | None = None
self._updating_scroll_page = False
@@ -242,7 +359,7 @@ class PdfViewer(QScrollArea):
self.page_index = 0
self.render()
def render(self) -> None:
def render(self, scroll_to_page: bool = True) -> None:
if not self.document or not self.document.is_open:
self._clear_page_labels()
self.page_label = self._make_empty_label()
@@ -250,6 +367,7 @@ class PdfViewer(QScrollArea):
return
previous_page = min(self.page_index, self.document.page_count - 1)
self._updating_scroll_page = True
self._clear_page_labels()
for page_index in range(self.document.page_count):
label = self._make_page_label(page_index)
@@ -264,11 +382,51 @@ class PdfViewer(QScrollArea):
self.content_layout.activate()
self.content_widget.adjustSize()
self._refresh_overlay_zoom()
self._refresh_search_highlights()
self._refresh_text_selection_highlights()
self._apply_object_selection_to_labels()
self._scroll_to_page(self.page_index)
if scroll_to_page:
self._scroll_to_page(self.page_index)
else:
QTimer.singleShot(0, self._finish_programmatic_scroll)
self.page_changed.emit(self.page_index)
self.zoom_changed.emit(self.zoom)
def render_preserving_scroll(self, page_index: int, scroll_value: int) -> None:
if self.document and 0 <= page_index < self.document.page_count:
self.page_index = page_index
self.render()
self._updating_scroll_page = True
bar = self.verticalScrollBar()
bar.setValue(max(bar.minimum(), min(bar.maximum(), scroll_value)))
if self._page_labels and 0 <= self.page_index < len(self._page_labels):
self.page_label = self._page_labels[self.page_index]
QTimer.singleShot(0, self._finish_programmatic_scroll)
def refresh_page(self, page_index: int) -> None:
if (
not self.document
or not self.document.is_open
or page_index < 0
or page_index >= len(self._page_labels)
):
return
self._updating_scroll_page = True
label = self._page_labels[page_index]
image = self.document.render_page(page_index, self.zoom)
label.setPixmap(QPixmap.fromImage(image))
label.adjustSize()
self.page_index = page_index
self.page_label = label
self.content_layout.activate()
self._refresh_overlay_zoom()
self._refresh_search_highlights()
self._refresh_text_selection_highlights()
self._apply_object_selection_to_labels()
self.page_changed.emit(self.page_index)
self.zoom_changed.emit(self.zoom)
QTimer.singleShot(0, self._finish_programmatic_scroll)
def next_page(self) -> None:
if self.document and self.page_index < self.document.page_count - 1:
self.go_to_page(self.page_index + 1)
@@ -291,8 +449,23 @@ class PdfViewer(QScrollArea):
self.set_zoom(max(0.2, self.zoom - 0.15))
def set_zoom(self, zoom: float) -> None:
self.zoom = max(0.2, min(3.0, zoom))
self.render()
new_zoom = max(0.2, min(3.0, zoom))
if abs(new_zoom - self.zoom) < 0.001:
return
if not self.document or not self.document.is_open:
self.zoom = new_zoom
self.render()
return
anchor = self._viewport_pdf_anchor()
if anchor is not None:
self.page_index = anchor[0]
self.zoom = new_zoom
self.render(scroll_to_page=False)
if anchor is not None:
self._restore_pdf_anchor(anchor)
QTimer.singleShot(0, lambda saved_anchor=anchor: self._restore_pdf_anchor(saved_anchor))
def wheelEvent(self, event: QWheelEvent) -> None:
if event.modifiers() & Qt.KeyboardModifier.ControlModifier:
@@ -304,10 +477,57 @@ class PdfViewer(QScrollArea):
return
super().wheelEvent(event)
def _viewport_pdf_anchor(self) -> tuple[int, float, float] | None:
if not self._page_labels or self.zoom <= 0:
return None
viewport_center = QPoint(self.viewport().width() // 2, self.viewport().height() // 2)
content_point = self.content_widget.mapFromGlobal(self.viewport().mapToGlobal(viewport_center))
best_index = self.page_index
best_distance: int | None = None
for index, label in enumerate(self._page_labels):
geometry = label.geometry()
if geometry.contains(content_point):
local_x = content_point.x() - geometry.x()
local_y = content_point.y() - geometry.y()
return index, local_x / self.zoom, local_y / self.zoom
distance = abs(geometry.center().y() - content_point.y())
if best_distance is None or distance < best_distance:
best_distance = distance
best_index = index
if 0 <= best_index < len(self._page_labels):
geometry = self._page_labels[best_index].geometry()
local_x = min(max(content_point.x() - geometry.x(), 0), geometry.width())
local_y = min(max(content_point.y() - geometry.y(), 0), geometry.height())
return best_index, local_x / self.zoom, local_y / self.zoom
return None
def _restore_pdf_anchor(self, anchor: tuple[int, float, float]) -> None:
page_index, pdf_x, pdf_y = anchor
if not (0 <= page_index < len(self._page_labels)):
self._finish_programmatic_scroll()
return
self._updating_scroll_page = True
self.page_index = page_index
self.page_label = self._page_labels[page_index]
geometry = self.page_label.geometry()
target_x = geometry.x() + pdf_x * self.zoom - self.viewport().width() / 2
target_y = geometry.y() + pdf_y * self.zoom - self.viewport().height() / 2
hbar = self.horizontalScrollBar()
vbar = self.verticalScrollBar()
hbar.setValue(max(hbar.minimum(), min(hbar.maximum(), int(target_x))))
vbar.setValue(max(vbar.minimum(), min(vbar.maximum(), int(target_y))))
self.page_changed.emit(self.page_index)
QTimer.singleShot(0, self._finish_programmatic_scroll)
def set_drawing_enabled(self, enabled: bool) -> None:
if enabled:
self.set_placement_enabled(False)
self.set_area_selection_enabled(False)
self.set_text_selection_enabled(False)
self.set_shape_placement_enabled(False)
self.set_hand_pan_enabled(False)
for label in self._labels():
label.drawing_enabled = enabled
label.setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
@@ -315,9 +535,12 @@ class PdfViewer(QScrollArea):
def set_placement_enabled(self, enabled: bool) -> None:
if enabled:
self.set_shape_placement_enabled(False)
self.set_hand_pan_enabled(False)
for label in self._labels():
label.drawing_enabled = False
label.area_selection_enabled = False
label.text_selection_enabled = False
self.set_object_edit_enabled(False)
for label in self._labels():
label.placement_enabled = enabled
@@ -326,9 +549,12 @@ class PdfViewer(QScrollArea):
def set_area_selection_enabled(self, enabled: bool) -> None:
if enabled:
self.set_shape_placement_enabled(False)
self.set_hand_pan_enabled(False)
for label in self._labels():
label.drawing_enabled = False
label.placement_enabled = False
label.text_selection_enabled = False
self.set_object_edit_enabled(False)
for label in self._labels():
label.area_selection_enabled = enabled
@@ -339,12 +565,69 @@ class PdfViewer(QScrollArea):
label.setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
self.viewport().setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
def set_object_edit_enabled(self, enabled: bool) -> None:
def set_text_selection_enabled(self, enabled: bool) -> None:
if enabled:
self.set_shape_placement_enabled(False)
self.set_hand_pan_enabled(False)
for label in self._labels():
label.drawing_enabled = False
label.placement_enabled = False
label.area_selection_enabled = False
self.set_object_edit_enabled(False)
for label in self._labels():
label.text_selection_enabled = enabled
if not enabled:
label._selecting_text = False
label._area_rect = QRectF()
label.update()
label.setCursor(Qt.CursorShape.IBeamCursor if enabled else Qt.CursorShape.ArrowCursor)
self.viewport().setCursor(Qt.CursorShape.IBeamCursor if enabled else Qt.CursorShape.ArrowCursor)
def set_shape_placement_enabled(self, enabled: bool, kind: str = "") -> None:
if enabled:
self.set_hand_pan_enabled(False)
for label in self._labels():
label.drawing_enabled = False
label.placement_enabled = False
label.area_selection_enabled = False
label.text_selection_enabled = False
self.set_object_edit_enabled(False)
for label in self._labels():
label.shape_placement_enabled = enabled
label.shape_placement_kind = kind if enabled else ""
if not enabled:
label._placing_shape = False
label._shape_start = QPointF()
label._shape_end = QPointF()
label.update()
label.setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
self.viewport().setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
def set_hand_pan_enabled(self, enabled: bool) -> None:
if enabled:
for label in self._labels():
label.drawing_enabled = False
label.placement_enabled = False
label.area_selection_enabled = False
label.text_selection_enabled = False
label.shape_placement_enabled = False
self.set_object_edit_enabled(False)
for label in self._labels():
label.hand_pan_enabled = enabled
if not enabled:
label._hand_panning = False
label.setCursor(Qt.CursorShape.OpenHandCursor if enabled else Qt.CursorShape.ArrowCursor)
self.viewport().setCursor(Qt.CursorShape.OpenHandCursor if enabled else Qt.CursorShape.ArrowCursor)
def set_object_edit_enabled(self, enabled: bool) -> None:
if enabled:
self.set_shape_placement_enabled(False)
self.set_hand_pan_enabled(False)
for label in self._labels():
label.drawing_enabled = False
label.placement_enabled = False
label.area_selection_enabled = False
label.text_selection_enabled = False
else:
self.clear_object_selection()
for label in self._labels():
@@ -357,30 +640,70 @@ class PdfViewer(QScrollArea):
label.drawing_enabled = False
label.placement_enabled = False
label.area_selection_enabled = False
label.text_selection_enabled = False
label.shape_placement_enabled = False
label.shape_placement_kind = ""
label.hand_pan_enabled = False
label._hand_panning = False
label.object_edit_enabled = False
label._placing_shape = False
label.setCursor(Qt.CursorShape.ArrowCursor)
self.viewport().setCursor(Qt.CursorShape.ArrowCursor)
self.clear_object_selection()
self.clear_text_selection()
def set_selected_object_rect(self, rect: tuple[float, float, float, float] | None) -> None:
if not rect:
self.clear_object_selection()
return
self._selected_object_rect = rect
self._selected_object_rects = []
self._selected_object_page_index = self.page_index
self._apply_object_selection_to_labels()
def set_selected_object_rects(self, rects: list[tuple[float, float, float, float]]) -> None:
self._selected_object_rect = None
self._selected_object_rects = rects
self._selected_object_page_index = self.page_index if rects else None
self._apply_object_selection_to_labels()
def set_overlay_images(self, overlays: list[dict[str, object]]) -> None:
self._overlay_images = overlays
self._refresh_overlay_zoom()
def set_search_highlights(
self,
page_index: int | None,
rects: list[tuple[float, float, float, float]] | None = None,
) -> None:
self._search_highlights.clear()
if page_index is not None and rects:
self._search_highlights[page_index] = rects
self._refresh_search_highlights()
def set_text_selection_highlights(
self,
page_index: int | None,
rects: list[tuple[float, float, float, float]] | None = None,
) -> None:
self._text_selection_highlights.clear()
if page_index is not None and rects:
self._text_selection_highlights[page_index] = rects
self._refresh_text_selection_highlights()
def clear_object_selection(self) -> None:
self._selected_object_rect = None
self._selected_object_rects = []
self._selected_object_page_index = None
for label in self._labels():
label.selected_rect = None
label.selected_rects = []
label.update()
def clear_text_selection(self) -> None:
self._text_selection_highlights.clear()
self._refresh_text_selection_highlights()
def fit_width(self) -> None:
if not self.document or not self.document.is_open:
return
@@ -423,12 +746,25 @@ class PdfViewer(QScrollArea):
def _connect_page_label(self, label: PageLabel, page_index: int) -> None:
label.stroke_finished.connect(lambda stroke, index=page_index: self._emit_ink_stroke_for_page(index, stroke))
label.hand_pan_delta.connect(self._pan_by_delta)
label.placement_requested.connect(lambda point, index=page_index: self._emit_placement_for_page(index, point))
label.area_selection_finished.connect(lambda rect, index=page_index: self._emit_area_selection_for_page(index, rect))
label.text_selection_preview_changed.connect(
lambda rect, start, end, index=page_index: self._emit_text_selection_preview_for_page(index, rect, start, end)
)
label.text_selection_finished.connect(
lambda rect, start, end, index=page_index: self._emit_text_selection_for_page(index, rect, start, end)
)
label.text_selection_click_requested.connect(lambda point, index=page_index: self._emit_text_selection_click_for_page(index, point))
label.text_selection_context_requested.connect(lambda point, index=page_index: self._emit_text_selection_context_for_page(index, point))
label.shape_placement_finished.connect(lambda kind, start, end, index=page_index: self._emit_shape_placement_for_page(index, kind, start, end))
label.object_select_requested.connect(lambda point, index=page_index: self._emit_object_select_for_page(index, point))
label.object_rect_changed.connect(lambda rect, index=page_index: self._emit_object_rect_changed_for_page(index, rect))
label.object_context_requested.connect(lambda point, index=page_index: self._emit_object_context_for_page(index, point))
label.object_double_clicked.connect(lambda point, index=page_index: self._emit_object_double_clicked_for_page(index, point))
label.annotation_double_clicked.connect(lambda point, index=page_index: self._emit_annotation_double_clicked_for_page(index, point))
label.annotation_hover_requested.connect(lambda point, index=page_index: self._emit_annotation_hover_for_page(index, point))
label.setMouseTracking(True)
def _labels(self) -> list[PageLabel]:
return self._page_labels or [self.page_label]
@@ -445,7 +781,25 @@ class PdfViewer(QScrollArea):
if not self._page_labels or page_index < 0 or page_index >= len(self._page_labels):
return
self._updating_scroll_page = True
self.ensureWidgetVisible(self._page_labels[page_index], 0, 0)
self.page_index = page_index
self.page_label = self._page_labels[page_index]
self._apply_scroll_to_page(page_index, attempts=3)
def _apply_scroll_to_page(self, page_index: int, attempts: int = 0) -> None:
if not self._page_labels or page_index < 0 or page_index >= len(self._page_labels):
self._finish_programmatic_scroll()
return
self.content_layout.activate()
self.content_widget.adjustSize()
target_y = self._page_labels[page_index].geometry().top()
bar = self.verticalScrollBar()
bar.setValue(max(bar.minimum(), min(bar.maximum(), target_y)))
if attempts > 0:
QTimer.singleShot(0, lambda: self._apply_scroll_to_page(page_index, attempts - 1))
else:
QTimer.singleShot(0, self._finish_programmatic_scroll)
def _finish_programmatic_scroll(self) -> None:
self._updating_scroll_page = False
def _update_current_page_from_scroll(self) -> None:
@@ -474,6 +828,32 @@ class PdfViewer(QScrollArea):
]
label.update()
def _refresh_search_highlights(self) -> None:
for page_index, label in enumerate(self._labels()):
label.search_highlights = [
(
float(x0) * self.zoom,
float(y0) * self.zoom,
float(x1) * self.zoom,
float(y1) * self.zoom,
)
for x0, y0, x1, y1 in self._search_highlights.get(page_index, [])
]
label.update()
def _refresh_text_selection_highlights(self) -> None:
for page_index, label in enumerate(self._labels()):
label.text_selection_highlights = [
(
float(x0) * self.zoom,
float(y0) * self.zoom,
float(x1) * self.zoom,
float(y1) * self.zoom,
)
for x0, y0, x1, y1 in self._text_selection_highlights.get(page_index, [])
]
label.update()
def _apply_object_selection_to_labels(self) -> None:
for index, label in enumerate(self._labels()):
if self._selected_object_rect and self._selected_object_page_index == index:
@@ -486,6 +866,18 @@ class PdfViewer(QScrollArea):
)
else:
label.selected_rect = None
if self._selected_object_rects and self._selected_object_page_index == index:
label.selected_rects = [
QRectF(
x0 * self.zoom,
y0 * self.zoom,
(x1 - x0) * self.zoom,
(y1 - y0) * self.zoom,
)
for x0, y0, x1, y1 in self._selected_object_rects
]
else:
label.selected_rects = []
label.update()
def _set_current_page_from_interaction(self, page_index: int) -> None:
@@ -500,6 +892,10 @@ class PdfViewer(QScrollArea):
points = [(point.x() / self.zoom, point.y() / self.zoom) for point in stroke]
self.ink_stroke_finished.emit(page_index, points)
def _pan_by_delta(self, delta: QPointF) -> None:
self.horizontalScrollBar().setValue(self.horizontalScrollBar().value() - int(delta.x()))
self.verticalScrollBar().setValue(self.verticalScrollBar().value() - int(delta.y()))
def _emit_placement_for_page(self, page_index: int, point: QPointF) -> None:
self._set_current_page_from_interaction(page_index)
self.placement_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
@@ -516,6 +912,69 @@ class PdfViewer(QScrollArea):
),
)
def _emit_text_selection_for_page(
self,
page_index: int,
rect: QRectF,
start: QPointF,
end: QPointF,
) -> None:
self._set_current_page_from_interaction(page_index)
self.text_selection_finished.emit(
page_index,
(
rect.left() / self.zoom,
rect.top() / self.zoom,
rect.right() / self.zoom,
rect.bottom() / self.zoom,
),
(start.x() / self.zoom, start.y() / self.zoom),
(end.x() / self.zoom, end.y() / self.zoom),
)
def _emit_text_selection_preview_for_page(
self,
page_index: int,
rect: QRectF,
start: QPointF,
end: QPointF,
) -> None:
self._set_current_page_from_interaction(page_index)
self.text_selection_preview_changed.emit(
page_index,
(
rect.left() / self.zoom,
rect.top() / self.zoom,
rect.right() / self.zoom,
rect.bottom() / self.zoom,
),
(start.x() / self.zoom, start.y() / self.zoom),
(end.x() / self.zoom, end.y() / self.zoom),
)
def _emit_text_selection_context_for_page(self, page_index: int, point: QPointF) -> None:
self._set_current_page_from_interaction(page_index)
self.text_selection_context_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
def _emit_text_selection_click_for_page(self, page_index: int, point: QPointF) -> None:
self._set_current_page_from_interaction(page_index)
self.text_selection_click_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
def _emit_shape_placement_for_page(
self,
page_index: int,
kind: str,
start: QPointF,
end: QPointF,
) -> None:
self._set_current_page_from_interaction(page_index)
self.shape_placement_finished.emit(
page_index,
kind,
(start.x() / self.zoom, start.y() / self.zoom),
(end.x() / self.zoom, end.y() / self.zoom),
)
def _emit_object_select_for_page(self, page_index: int, point: QPointF) -> None:
self._set_current_page_from_interaction(page_index)
self.object_select_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
@@ -539,3 +998,10 @@ class PdfViewer(QScrollArea):
def _emit_object_double_clicked_for_page(self, page_index: int, point: QPointF) -> None:
self._set_current_page_from_interaction(page_index)
self.object_double_clicked.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
def _emit_annotation_double_clicked_for_page(self, page_index: int, point: QPointF) -> None:
self._set_current_page_from_interaction(page_index)
self.annotation_double_clicked.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
def _emit_annotation_hover_for_page(self, page_index: int, point: QPointF) -> None:
self.annotation_hover_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
+34 -1
View File
@@ -6,7 +6,7 @@ from PySide6.QtCore import QSize, Qt, QTimer, Signal
from PySide6.QtGui import QPixmap
from PySide6.QtWidgets import QLabel, QListWidget, QListWidgetItem, QTabWidget, QWidget, QVBoxLayout
from pdfreaderlite.core.document import PdfDocument
from pdfreaderlite.core.document import Bookmark, PdfDocument
class ThumbnailItemWidget(QWidget):
@@ -187,7 +187,10 @@ class Sidebar(QTabWidget):
super().__init__()
self.setObjectName("leftSidebar")
self.thumbnails = ThumbnailList()
self.bookmarks = QListWidget()
self.bookmarks.setObjectName("bookmarkList")
self.thumbnails.page_selected.connect(self.page_selected.emit)
self.bookmarks.itemClicked.connect(self._emit_bookmark_page)
thumb_page = QWidget()
layout = QVBoxLayout(thumb_page)
@@ -195,11 +198,41 @@ class Sidebar(QTabWidget):
layout.addWidget(self.thumbnails)
self.addTab(thumb_page, "缩略图")
self.addTab(self.bookmarks, "目录")
self.setMinimumWidth(150)
self.setMaximumWidth(330)
def load_document(self, document: PdfDocument) -> None:
self.thumbnails.load_document(document)
self._load_bookmarks(document)
def select_page(self, page_index: int) -> None:
self.thumbnails.select_page(page_index)
def _load_bookmarks(self, document: PdfDocument) -> None:
self.bookmarks.clear()
if not document.is_open:
self._add_empty_bookmark_item("打开 PDF 后显示目录")
return
bookmarks = document.bookmarks()
if not bookmarks:
self._add_empty_bookmark_item("当前 PDF 没有目录")
return
for bookmark in bookmarks:
item = QListWidgetItem(self._bookmark_text(bookmark))
item.setData(Qt.ItemDataRole.UserRole, bookmark.page_index)
self.bookmarks.addItem(item)
def _add_empty_bookmark_item(self, text: str) -> None:
item = QListWidgetItem(text)
item.setFlags(item.flags() & ~Qt.ItemFlag.ItemIsEnabled)
self.bookmarks.addItem(item)
def _bookmark_text(self, bookmark: Bookmark) -> str:
prefix = " " * max(0, bookmark.level - 1)
return f"{prefix}{bookmark.title} 第 {bookmark.page_index + 1} 页"
def _emit_bookmark_page(self, item: QListWidgetItem) -> None:
page_index = item.data(Qt.ItemDataRole.UserRole)
if isinstance(page_index, int):
self.page_selected.emit(page_index)
+1 -1
View File
@@ -1,6 +1,6 @@
[project]
name = "PDFReaderLite"
version = "0.1.0"
version = "0.2.2"
description = "A lightweight Windows PDF reader and editor inspired by common Adobe Acrobat workflows."
requires-python = ">=3.10"
dependencies = [