diff --git a/README.md b/README.md index b37ca57..3dfc1f0 100644 --- a/README.md +++ b/README.md @@ -2,24 +2,24 @@ PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,目标是提供 Adobe Acrobat 常用功能的轻量替代版。 -当前稳定版本:`0.2.2` +当前稳定版本:`0.2.3` -## 当前能力 +当前开发目标:后续版本继续保持轻量、稳定、实用的方向。 + +## 主要功能 - 多标签打开 PDF。 -- 连续阅读、缩放、适应宽度、适应页面、页码跳转。 -- 左侧自适应缩略图。 -- 指针/手形工具切换,阅读、编辑PDF、页面、工具、注释模式切换。 +- 连续阅读、鼠标滚轮浏览、键盘翻页、缩放、适应宽度、适应页面、页码跳转。 +- 左侧自适应缩略图和 PDF 目录/书签。 +- 指针/手形工具切换;阅读、编辑 PDF、页面、工具、注释模式切换。 - 文本搜索,搜索结果跳转并临时高亮。 -- PDF 自带目录/书签显示与跳转。 -- 真实文本选择,支持复制、右键高亮、添加注释。 -- 高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。 -- 高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。 -- 注释列表、注释筛选、搜索、排序、仅当前页、导出、跳转、删除。 +- 真实文本选择,支持复制、右键多色高亮、下划线、删除线和添加注释。 +- 注释工具:高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。 +- 注释列表、筛选、搜索、排序、仅当前页、导出、跳转、删除。 - 注释属性修改,支持内容、颜色、字号、线宽、透明度等常见属性。 - 鼠标悬停注释符号显示注释内容,双击注释符号可修改注释。 -- 添加文本、插入图片、遮盖区域。 -- 图片签名、放置签名、手写签名。 +- 编辑工具:添加文本、插入图片、遮盖区域。 +- 签名工具:图片签名、点击放置签名、手写签名。 - 对象选择、移动、缩放、删除、复制粘贴、图层顺序、对齐与分布。 - 页面旋转、删除、移动、插入、提取、拆分、合并。 - 页面管理支持网格缩略图、多选、批量删除、批量旋转、批量提取、拖入 PDF 插入页面。 @@ -28,34 +28,13 @@ PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工 - 保存、另存为、加密另存为、移除密码另存为。 - 打印、最近文件、拖拽打开。 - 深色模式、窗口状态记忆、异常日志。 -- 单文件 exe 打包。 +- PyInstaller 单文件 exe 打包。 -## 当前版本重点 - -`0.2.2` 在 `0.2.1` 的阅读、页面管理和基础编辑能力上,重点完善 Acrobat 风格的常用审阅流程: - -- 指针模式下可选择 PDF 真实文本,支持逐字/逐字母选取。 -- 双栏文档选择文字时优先按左栏、右栏阅读顺序处理。 -- 选择文字后的右键菜单支持多色高亮、复制、添加注释。 -- 添加注释后自动高亮所选文字,并保留注释符号和悬停提示。 -- 注释模式下可捕捉已有注释,进行属性修改、删除和内容编辑。 -- Ctrl+滚轮缩放、页面旋转等操作尽量保持当前页和视图位置。 - -文档入口: +## 文档入口 - [开发计划](docs/development_plan.md) -- [V2 注释与编辑专项计划](docs/v2_annotation_edit_plan.md) -- [V2 需求清单](docs/v2_requirements_checklist.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 验收: - -```powershell -.\.venv\Scripts\python.exe scripts\v2_acceptance_test.py -``` +- [版本记录](docs/release_notes.md) +- [0.2.3 稳定性待办](todo.md) ## 本地运行 @@ -88,6 +67,8 @@ python main.py ```powershell python scripts\smoke_test.py +python scripts\v2_acceptance_test.py +python scripts\stability_regression_test.py ``` ## 打包 @@ -110,7 +91,7 @@ powershell -ExecutionPolicy Bypass -File .\build.ps1 dist\PDFReaderLite.exe ``` -## 不纳入范围 +## 不纳入当前承诺范围 - PDF 转 Word 并保持原排版。 - PDF 转 Excel 并保持表格结构。 @@ -123,6 +104,6 @@ dist\PDFReaderLite.exe ## 说明 -这是我用CODEX完成的软件,感兴趣的朋友可以下载学习或者自用,如果对软件有建议,可以联系我。 +这是我使用 Codex 完成的软件,感兴趣的朋友可以下载学习或自由使用。如果对软件有建议,可以联系我。 wenhao.shen@pkuncii.cn diff --git a/dist/PDFReaderLite.exe b/dist/PDFReaderLite.exe index a5578c8..388ed5b 100644 Binary files a/dist/PDFReaderLite.exe and b/dist/PDFReaderLite.exe differ diff --git a/docs/development_plan.md b/docs/development_plan.md index e7ecffa..f776713 100644 --- a/docs/development_plan.md +++ b/docs/development_plan.md @@ -6,71 +6,54 @@ PDFReaderLite 是面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具, 核心边界: -- 重点做阅读、注释、覆盖式编辑、页面管理、基础表单、视觉签名、导出、密码保护。 -- V3 已完成,当前稳定版本为 `v0.2.2`,重点做更像 Acrobat 的常用审阅和编辑流程。 -- V4 可重新评估 OCR、导出文本/图片、遮盖标记、签名记录等可选增强,但仍保持轻量边界。 +- 重点做好阅读、注释、覆盖式编辑、页面管理、基础表单、视觉签名、导出、密码保护。 +- 保持中文界面和 Windows 单机使用优先。 - 打包形态以单文件 exe 为主。 +- 不承诺完整替代 Acrobat Pro,不做高风险、重型或容易误导用户的能力。 -## V1:稳定可用版 +## 已完成版本 -V1 已发布为 `v0.2.1`,发布产物为 `dist/PDFReaderLite.exe`。 +### V1:稳定可用版 -已完成能力: +V1 已发布为 `v0.2.1`,主要完成基础可用能力: - 多标签 PDF 打开、切换、关闭。 -- 连续阅读、鼠标滚轮滚动、键盘左右翻页、键盘上下滚动。 -- 状态栏页码输入、缩放滑条、缩放百分比输入、适应宽度、适应页面。 -- 阅读、编辑PDF、页面、工具、注释模式切换。 -- 阅读模式下退出对象选择、画笔、放置等编辑状态。 +- 连续阅读、鼠标滚轮滚动、键盘翻页、状态栏页码和缩放控制。 - 左侧缩略图懒加载,支持横屏/竖屏自适应布局。 - 右侧工具面板按模式显示。 - 文本搜索与搜索结果跳转。 - 页面旋转、删除、移动、插入空白页、插入 PDF、提取、拆分、合并。 -- 高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。 -- 注释列表展示、点击跳转、删除。 -- 添加文本、点击放置文本、插入图片、点击放置图片、遮盖区域。 -- 图片签名、点击放置签名、手写签名。 -- 新增图片/签名对象在当前会话内可拖动、缩放、删除,保存时写入 PDF。 +- 基础注释:高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。 +- 基础编辑:添加文本、插入图片、遮盖区域、图片签名、手写签名。 +- 新增图片/签名对象可在当前会话内拖动、缩放、删除,保存时写入 PDF。 - 保存、另存为、加密另存为、移除密码另存为。 -- 打开加密 PDF。 -- 基础表单字段填写。 -- 当前页导出图片、批量导出图片、图片合成 PDF。 -- 文档信息查看与修改。 -- 打印。 -- 未保存星号提示,关闭标签/窗口时保存确认。 -- 最近文件、拖拽 PDF 到窗口打开。 -- 深色模式、窗口状态记忆、异常日志、打开日志目录。 -- PDF 文件关联入口。 -- PyInstaller 单文件 exe 打包,含图标与版本资源。 +- 打开加密 PDF、基础表单填写、导出图片、图片合成 PDF、打印。 +- 最近文件、拖拽打开、深色模式、窗口状态记忆、异常日志。 +- PyInstaller 单文件 exe 打包,包含图标和版本资源。 -## V2:注释与编辑增强版 +### V2:注释与编辑增强版 -V2 已并入当前 `v0.2.2` 代码。目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。 +V2 已并入 `v0.2.2`。目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。 已完成主线: - 注释主线:文本选择标注、注释属性、注释列表筛选搜索、图章。 -- 编辑主线:文本框二次编辑、对象属性、统一对象选择、复制删除移动缩放。 +- 编辑主线:文本框二次编辑、对象属性、统一对象选择、复制、删除、移动、缩放。 - 交互主线:右键菜单、Esc 取消、模式状态清晰、未保存提示完善。 -优先功能包见 [V2 注释与编辑专项计划](v2_annotation_edit_plan.md)。 +### V3:Acrobat 常用审阅与编辑流程增强版 -## V3:Acrobat 常用审阅与编辑流程增强版 - -V3 已并入当前 `v0.2.2` 代码。目标是让高频工作流更接近 Acrobat,但继续坚持“简单、实用、轻量”的原则。 +V3 已并入 `v0.2.2`。目标是让高频工作流更接近 Acrobat,同时继续坚持简单、实用、轻量。 已完成主线: - 真实文本选择:选中 PDF 真实文本后直接高亮、下划线、删除线。 -- 选区右键菜单:选中文本后弹出多色高亮、复制、添加注释等常用动作。 +- 选区右键菜单:选中文字后弹出多色高亮、复制、添加注释等常用动作。 - 文本框样式:已有 FreeText 文本框支持修改内容、字号和文字颜色。 -- 注释列表增强:按页码、类型、创建顺序排序,只看当前页注释,导出 txt/json。 +- 注释列表增强:按页码、类型、创建顺序排序,只看当前页注释,导出 TXT/JSON。 - 页面管理增强:页面管理视图支持多选、批量删除、批量旋转、批量提取。 - 搜索与导航:搜索结果显示上下文,点击跳转并临时高亮;支持 PDF 自带目录/书签面板。 - 对象操作增强:对象复制粘贴尽量保留样式,支持简单对齐和分布。 - -缺陷修复与体验改进: - - 指针和手形工具互斥,右侧模式按钮互斥,两组状态互不干扰。 - 软件启动默认手形工具,指针工具用于文字选择和复制。 - Ctrl+鼠标滚轮缩放、页面旋转、页面操作后尽量保留当前页和视图位置。 @@ -79,22 +62,28 @@ V3 已并入当前 `v0.2.2` 代码。目标是让高频工作流更接近 Acroba - 鼠标悬停注释符号时显示注释内容;双击注释符号可编辑注释。 - 已有文本高亮支持重新选中并修改颜色。 -专项计划见 [V3 Acrobat 工作流增强计划](v3_acrobat_workflow_plan.md)。 +## 当前版本:0.2.3 稳定性增强 -## V4:可选高级能力探索版 +0.2.3 只做稳定性增强,不新增业务功能。完整待办见根目录 [todo.md](../todo.md)。 -V4 允许重新讨论部分之前不做的功能,但必须保持明确边界,不承诺 Acrobat Pro 级完整能力。 +当前重点: -可选方向: +- 保存、另存为、加密另存为等写文件操作尽量事务化。 +- 撤销/重做、渲染缓存、缩略图缓存、搜索、打印等长耗时或高内存流程需要可控。 +- 大文档打开、页面管理、搜索、打印等操作要有进度提示或后台处理。 +- 多标签页、延迟信号、旧页面控件、关闭空状态等边界要避免互相污染。 +- 所有高风险界面操作要有异常保护、中文提示和日志。 -- OCR:可做外部 OCR 插件或可选安装,不内置到单 exe。 -- PDF 导出:可做导出文本、导出图片,不承诺 PDF 转 Word 并保持原排版。 -- 敏感信息处理:可做遮盖标记和风险提示,不宣称真正永久擦除。 -- 签名:可做签名图片和签名记录,不做数字证书级签名。 +## 后续可选方向 -专项计划见 [V4 可选高级能力探索计划](v4_optional_advanced_plan.md)。 +这些能力可以在第四版或更后续版本讨论,但必须保持明确边界: -## 长期保持谨慎的范围 +- OCR:可以做外部 OCR 插件或可选安装,不内置到单 exe。 +- PDF 导出:可以做导出文本、导出图片,不承诺 PDF 转 Word 并保持原排版。 +- 敏感信息处理:可以做遮盖标记和风险提示,不宣称真正永久擦除。 +- 签名:可以做签名图片和签名记录,不做数字证书级签名。 + +## 长期谨慎范围 - PDF 转 Word 并保持原排版。 - PDF 转 Excel 并保持表格结构。 diff --git a/docs/release_notes.md b/docs/release_notes.md new file mode 100644 index 0000000..3c5e3d0 --- /dev/null +++ b/docs/release_notes.md @@ -0,0 +1,157 @@ +# PDFReaderLite 版本记录 + +本文档合并历史发布说明,作为后续唯一版本记录入口。 + +## v0.2.3 + +发布日期:2026-07-02 + +### 版本定位 + +`0.2.3` 是稳定性增强版本,不新增业务功能,重点降低大文档、长耗时操作和异常场景下的卡顿与状态错乱风险。 + +### 发布产物 + +```text +dist\PDFReaderLite.exe +``` + +版本信息: + +- 应用版本:`0.2.3` +- exe 版本:`0.2.3` +- 文件大小:`49,496,971 bytes` +- SHA256:`BD947E9AD6FB4AC66ED132A2BAD765258275C3927E02F450EB555D7E21DFB328` + +### 主要变化 + +- 保存、另存为、加密另存为等写文件流程加强事务保护,失败时尽量保持当前文档可继续使用。 +- 撤销/重做快照增加内存上限,大文档自动限制或跳过高成本快照。 +- 主视图渲染改为优先渲染可见页,并对连续缩放做防抖处理。 +- 渲染缓存按内存上限淘汰,避免高缩放下缓存占用过大。 +- 大 PDF 打开改为后台读取,并显示打开进度。 +- 搜索、页面管理缩略图、打印等长耗时流程增加进度、取消或分批处理。 +- 多标签页、旧页面控件、延迟滚动、延迟信号等状态边界增加保护。 +- 注释列表和对象列表减少不必要的全量扫描。 +- 临时图片、文件关联、Qt 警告日志等诊断和清理流程补强。 +- 文档整理为中文,合并重复文档,并统一为 UTF-8 without BOM。 + +### 已验证 + +- 稳定性回归测试通过。 +- 源码冒烟测试通过。 +- V2 验收测试通过。 +- Python 编译检查通过。 + +### 已知边界 + +- 当前编辑仍属于覆盖式编辑,不是 PDF 原文段落级重排编辑。 +- 大文档为了稳定性可能限制撤销层数或跳过部分撤销快照。 +- 打印取消时,可能已有部分页面发送到打印机。 +- 遮盖区域是视觉遮盖,不是敏感信息永久擦除。 +- OCR、数字证书签名、自动更新不在当前版本范围。 + +## v0.2.2 + +发布日期:2026-07-01 + +### 版本定位 + +`0.2.2` 是第三版审阅与编辑流程增强后的稳定版本,重点完善 Acrobat 风格的文字选择、注释、页面管理和视图保持体验。 + +### 发布产物 + +```text +dist\PDFReaderLite.exe +``` + +版本信息: + +- 应用版本:`0.2.2` +- exe 版本:`0.2.2` +- 文件大小:`49,463,139 bytes` +- SHA256:`0A7701E9F10D23009CF22C8188A094DA1DDBCAF8C2455D352546EB65A9B74CBA` + +### 主要变化 + +- 指针模式支持选择 PDF 真实文本,并支持逐字、逐字母选择。 +- 选中文字后,右键菜单支持复制、多色高亮、下划线、删除线和添加注释。 +- 高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。 +- 添加注释时可自动高亮所选文字,并在页面上保留注释符号。 +- 鼠标悬停注释符号显示注释内容;双击注释符号可修改注释内容。 +- 注释模式下可捕捉已有注释,进行属性修改、内容编辑和删除。 +- 已有文本高亮可重新选中并修改颜色。 +- 双栏文档文字选择按栏位优化,降低左右栏混选概率。 +- 带水印、行号文档的文字选择增加过滤,降低误选页边内容概率。 +- 左侧目录页签支持读取 PDF 自带书签并跳转。 +- 注释列表支持类型筛选、关键字搜索、仅当前页、排序和导出 JSON/TXT。 +- 页面管理支持多选、批量删除、批量旋转、批量提取,以及拖入 PDF 插入页面。 +- 对象操作支持多选后的对齐和分布。 +- Ctrl+鼠标滚轮缩放、页面旋转、页面操作后尽量保持当前页和视图位置。 +- 指针/手形工具互斥;阅读、编辑 PDF、页面、工具、注释模式互斥,两组状态互不干扰。 + +### 已验证 + +- 源码冒烟测试通过。 +- Python 编译检查通过。 +- 版本号已同步到应用、包元数据和 Windows exe 版本资源。 + +### 已知边界 + +- 当前编辑仍属于覆盖式编辑,不是 PDF 原文段落级重排编辑。 +- 遮盖区域是视觉遮盖,不是敏感信息永久擦除。 +- 选区快捷操作当前采用右键菜单;悬浮迷你工具条保留为后续可选优化。 +- OCR、数字证书签名、自动更新不在当前版本范围。 + +## v0.2.1 + +发布日期:2026-06-30 + +### 版本定位 + +`0.2.1` 是第一版相对稳定的可用版本,重点完成阅读、基础注释、覆盖式编辑、页面管理、导出、签名和打包发布。 + +### 发布产物 + +```text +dist\PDFReaderLite.exe +``` + +版本信息: + +- 应用版本:`0.2.1` +- exe 版本:`0.2.1` +- 文件大小:`73,311,770 bytes` +- SHA256:`91803BAC5616463F5F5EB3E8B1C0C19A626333CB74FEBDB69ADE0B1ADCC9C4A3` +- Git 标签:`v0.2.1` + +### 主要功能 + +- 多标签 PDF 阅读。 +- 连续阅读和缩放控制。 +- 左侧自适应缩略图。 +- 顶部模式切换:阅读、编辑 PDF、页面、工具、注释。 +- 右侧模式化工具面板。 +- 注释工具:高亮、下划线、删除线、批注、画笔、图形、注释列表。 +- 编辑工具:文本、图片、遮盖、签名。 +- 页面工具:旋转、删除、移动、页面管理、插入、提取、拆分、合并。 +- 导出工具:当前页图片、批量图片、图片转 PDF。 +- 基础表单填写。 +- 密码保护另存为和移除密码另存为。 +- 打印。 +- 未保存提示和关闭确认。 +- 单文件 exe 发布。 + +### 已验证 + +- 源码冒烟测试通过。 +- exe 启动检查通过。 +- PyInstaller 单文件打包通过。 +- 远程仓库 `master` 已包含发布提交。 +- 远程仓库已发布标签 `v0.2.1`。 + +### 已知边界 + +- 当前编辑属于覆盖式编辑,不是 PDF 原文重排编辑。 +- 遮盖区域是视觉遮盖,不是敏感信息永久擦除。 +- OCR、数字证书签名、自动更新不在当前范围。 diff --git a/docs/release_v0.2.1.md b/docs/release_v0.2.1.md deleted file mode 100644 index 9f1527d..0000000 --- a/docs/release_v0.2.1.md +++ /dev/null @@ -1,53 +0,0 @@ -# PDFReaderLite v0.2.1 发布说明 - -发布日期:2026-06-30 - -## 发布产物 - -```text -dist\PDFReaderLite.exe -``` - -版本信息: - -- 应用版本:`0.2.1` -- exe 版本:`0.2.1` -- 文件大小:`73,311,770 bytes` -- SHA256:`91803BAC5616463F5F5EB3E8B1C0C19A626333CB74FEBDB69ADE0B1ADCC9C4A3` -- Git 标签:`v0.2.1` - -## 本版定位 - -这是第一版相对稳定的可用版本,重点完成阅读、基础注释、覆盖式编辑、页面管理、导出、签名、打包发布。 - -## 主要功能 - -- 多标签 PDF 阅读。 -- 连续阅读和缩放控制。 -- 左侧自适应缩略图。 -- 顶部模式切换:阅读、编辑PDF、页面、工具、注释。 -- 右侧模式化工具面板。 -- 注释工具:高亮、下划线、删除线、批注、画笔、图形、注释列表。 -- 编辑工具:文本、图片、遮盖、签名。 -- 页面工具:旋转、删除、移动、页面管理、插入、提取、拆分、合并。 -- 导出工具:当前页图片、批量图片、图片转 PDF。 -- 基础表单填写。 -- 密码保护另存为和移除密码另存为。 -- 打印。 -- 未保存提示和关闭确认。 -- 单文件 exe 发布。 - -## 已验证 - -- 源码冒烟测试通过。 -- exe 启动检查通过。 -- PyInstaller 单文件打包通过。 -- 远程仓库 `master` 已包含发布提交。 -- 远程仓库已发布标签 `v0.2.1`。 - -## 已知边界 - -- 当前编辑属于覆盖式编辑,不是 PDF 原文重排编辑。 -- 遮盖区域是视觉遮盖,不是敏感信息永久擦除。 -- OCR、数字证书签名、自动更新不在当前范围。 -- 注释和编辑能力将在 V2 重点增强。 diff --git a/docs/release_v0.2.2.md b/docs/release_v0.2.2.md deleted file mode 100644 index 75216c9..0000000 --- a/docs/release_v0.2.2.md +++ /dev/null @@ -1,54 +0,0 @@ -# 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、数字证书签名、自动更新不在当前版本范围。 diff --git a/docs/v2_annotation_edit_plan.md b/docs/v2_annotation_edit_plan.md deleted file mode 100644 index a7a51a9..0000000 --- a/docs/v2_annotation_edit_plan.md +++ /dev/null @@ -1,205 +0,0 @@ -# V2 注释与编辑专项计划 - -## 当前状态 - -V2 已并入当前 `v0.2.2` 代码。原 V2 目标中的框选区域标注、注释属性、注释列表、图章、文本框二次编辑、统一对象选择、右键菜单、键盘操作和未保存提示均已完成。 - -后续 V3 已继续补齐真实文本选择、多色高亮、选区添加注释、目录面板、页面管理批处理、注释导出和对象对齐分布等能力。本文档保留为 V2 需求来源和验收记录。 - -## 目标 - -V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”进入“审阅和覆盖式编辑顺手”的阶段。 - -设计原则: - -- 参考 Acrobat 的常用工作流,但保持轻量。 -- 优先增强已有能力,不引入高风险的大型功能。 -- 编辑方式仍以覆盖式编辑为主,不做 PDF 原文重排编辑。 -- 所有新增编辑都必须有清晰的选中、取消、删除、保存提示。 - -## 第一优先级 - -### 1. 文本选择后直接标注 - -现状:高亮、下划线、删除线主要通过输入文字查找后标注。 - -第二版实施边界: - -- 第二版先做框选区域标注,可用于普通文本 PDF 和扫描/图片型 PDF。 -- 真正识别 PDF 文本选区、选中文本后的快捷操作已在 V3 / `v0.2.2` 中完成,当前以右键菜单形式提供。 - -目标: - -- 鼠标选中页面文字后,可直接执行高亮、下划线、删除线。 -- 选中文本后可通过右键菜单执行高亮、下划线、删除线、复制、添加批注;悬浮迷你工具条作为后续可选优化。 -- 对无法识别文本的扫描页,保留现有输入文字标注方式。 - -验收标准: - -- 可在普通文本 PDF 中选中一段文字并直接添加标注。 -- 标注后注释列表自动刷新。 -- Esc 可取消当前选区或快捷菜单相关状态。 - -### 2. 注释属性面板 - -第二版实施范围: - -- 选中注释后,右侧注释面板显示属性区。 -- 支持修改注释内容、颜色、线宽、透明度。 -- 修改后刷新页面、注释列表,并标记文档未保存。 - -目标: - -- 选中注释后,右侧显示属性区。 -- 支持查看页码、类型、内容。 -- 支持修改颜色、线宽、透明度。 -- 对便签/批注支持修改内容。 - -验收标准: - -- 选中高亮、图形、画笔、便签时,属性面板显示对应可编辑项。 -- 修改属性后页面立即刷新,并标记文档未保存。 - -### 3. 注释列表筛选与搜索 - -目标: - -- 注释列表支持按类型筛选:全部、高亮、文本标记、便签、图形、画笔。 -- 支持搜索注释内容。 -- 支持点击跳转、右键删除、双击编辑内容。 - -验收标准: - -- 筛选不改变 PDF 内容,只影响列表显示。 -- 删除或修改注释后列表和页面同步刷新。 - -### 4. 文本框对象化与二次编辑 - -现状:添加文本后可写入 PDF,但二次编辑能力有限。 - -目标: - -- 添加文本后自动选中文本框。 -- 支持拖动、缩放、删除。 -- 双击文本框可修改内容。 -- 第二版支持设置新建文本框的默认字号、颜色。 -- 已有文本框内容、字号、文字颜色编辑已完成;中文文本加粗暂不作为当前承诺能力。 - -验收标准: - -- 添加文本后可立即调整位置和大小。 -- 双击后修改文字内容,保存后写入 PDF。 -- Delete 删除文本框,Esc 取消选择。 - -### 5. 统一对象选择体验 - -第二版实施范围: - -- 新建文本、图片、签名、批注、文字图章、遮盖、矩形、圆形、线条、箭头、画笔后自动选中。 -- 选中对象后统一显示选择框,支持拖动、缩放、Delete 删除、Esc 取消。 -- 右侧页面对象列表可选择当前页对象。 - -目标: - -- 文本、图片、签名、遮盖、图形注释使用统一选择框和控制点。 -- 右键菜单支持删除、复制、属性。 -- 当前支持常见注释对象复制粘贴并尽量保留样式;复杂 PDF 原生对象仍不承诺完整编辑。 -- 键盘 Delete 删除,Esc 取消选择。 -- 方向键微调位置,Shift+方向键大步移动。 - -验收标准: - -- 不同对象的选择、移动、删除行为一致。 -- 阅读模式下不能选中任何页面对象。 - -## 第二优先级 - -### 6. 图章工具 - -目标: - -- 提供常用中文图章:已阅、批准、草稿、作废、请修改。 -- 支持点击页面放置图章。 -- 支持移动、缩放、删除。 - -验收标准: - -- 图章作为可选中对象进入编辑流程。 -- 保存后写入 PDF。 - -### 7. 遮盖工具增强 - -目标: - -- 遮盖区域支持颜色选择、透明度设置。 -- 支持遮盖后添加文字。 -- 界面明确提示:这是视觉遮盖,不是敏感信息永久擦除。 - -验收标准: - -- 遮盖对象可移动、缩放、删除。 -- 保存后视觉效果固化进 PDF。 - -### 8. 图片对象增强 - -目标: - -- 插入图片后支持替换图片、旋转、透明度。 -- 可选做简单裁剪边界。 - -验收标准: - -- 替换图片不改变对象位置和大小。 -- 旋转和透明度保存后写入 PDF。 - -### 9. 注释样式预设 - -目标: - -- 高亮颜色、线宽、透明度可保存为默认样式。 -- 下次创建同类注释时自动沿用。 - -验收标准: - -- 样式设置保存在本地配置中。 -- 重启软件后仍生效。 - -### 10. 未保存状态完善 - -目标: - -- 标签页文件名后显示 `*`。 -- 编辑、注释属性修改、对象移动、删除都触发未保存状态。 -- 关闭标签或窗口时提示保存/不保存/取消。 - -验收标准: - -- 所有 V2 新增编辑路径都能触发未保存状态。 -- 保存后星号消失。 - -## 第三优先级 - -- 注释导出为 txt/html/json。 -- 页面内对象列表。 -- 复制/粘贴对象。 -- 复制/粘贴样式。 -- 简单对齐辅助线。 -- 水印工具。 -- 简单测量工具。 - -## 需要避免的方向 - -- 不做 PDF 原文段落级编辑和自动重排。 -- 不做高质量 OCR。 -- 不做敏感信息永久擦除。 -- 不把大量复杂功能塞进顶部工具栏,优先放在右侧面板和右键菜单。 - -## 建议实施顺序 - -1. 统一对象选择与 Esc/右键/Delete 行为。 -2. 文本框二次编辑和属性面板基础框架。 -3. 注释属性面板。 -4. 文本选择后直接标注。 -5. 注释列表筛选、搜索、编辑内容。 -6. 图章工具。 -7. 遮盖、图片、水印等编辑增强。 diff --git a/docs/v2_requirements_checklist.md b/docs/v2_requirements_checklist.md deleted file mode 100644 index 4ebc3c9..0000000 --- a/docs/v2_requirements_checklist.md +++ /dev/null @@ -1,93 +0,0 @@ -# V2 需求清单 - -当前状态:V2 已完成并并入 `v0.2.2`;V3 又补齐了真实文本选择、选区右键菜单、注释导出、目录面板和页面管理批处理等增强能力。 - -## 注释:新增功能 - -- [x] 框选区域后直接高亮。 -- [x] 框选区域后直接下划线。 -- [x] 框选区域后直接删除线。 -- [x] 鼠标选择真实文本后直接高亮、下划线、删除线。(V3 / 0.2.2) -- [x] 选中文本后的快捷操作菜单。(V3 / 0.2.2,当前为右键菜单;悬浮迷你工具条保留为后续可选优化) -- [x] 注释属性面板。 -- [x] 注释颜色设置。 -- [x] 注释线宽设置。 -- [x] 注释透明度设置。 -- [x] 便签/批注内容二次编辑。 -- [x] 注释列表按类型筛选。 -- [x] 注释列表搜索。 -- [x] 注释列表右键删除。 -- [x] 注释列表双击编辑内容。 -- [x] 图章工具。 -- [x] 常用中文图章预设。 -- [x] 自定义图片图章。 -- [x] 注释样式预设。 - -## 注释:旧功能完善 - -- [x] 高亮、下划线、删除线改为第二版框选区域标注。 -- [x] 图形注释支持修改颜色、线宽、透明度。 -- [x] 自由画笔支持颜色、线宽、透明度。 -- [x] 注释创建后自动刷新右侧注释列表。 -- [x] 注释删除后自动刷新右侧注释列表。 -- [x] 阅读模式下禁止选中注释对象。 - -## 编辑:新增功能 - -- [x] 文本框双击编辑内容。 -- [x] 新建文本框默认字号设置。 -- [x] 新建文本框默认颜色设置。 -- [ ] 文本框加粗设置。(暂不承诺,需确认中文 FreeText 加粗方案) -- [x] 添加文本后自动选中新对象。 -- [x] 图片替换。 -- [x] 未保存图片/签名/图章对象旋转。 -- [x] 未保存图片/签名/图章对象透明度。 -- [x] 未保存图片/签名/图章对象裁剪。 -- [x] 遮盖颜色设置。 -- [x] 遮盖透明度。 -- [x] 遮盖后添加文字。 -- [x] 图片/签名对象复制。 -- [x] 图片/签名对象粘贴。 -- [x] 常见注释对象复制。 -- [x] 常见注释对象粘贴。 -- [x] 方向键微调对象。 -- [x] Shift+方向键大步移动对象。 -- [x] 对象图层顺序:置顶、置底、上移、下移。 -- [x] 页面内对象列表。 - -## 编辑:旧功能完善 - -- [x] 文本、图片、签名、遮盖、图形注释使用统一选择框。 -- [x] Delete 删除选中对象。 -- [x] Esc 取消当前选择。 -- [x] 右键菜单支持删除、复制、属性。 -- [x] 保存前正确固化当前会话对象。 -- [x] 所有对象变更触发未保存状态。 - -## 交互体验 - -- [x] 当前模式在状态栏显示。 -- [x] 阅读、编辑PDF、页面、工具、注释模式互斥。 -- [x] 鼠标光标随模式变化。 -- [x] Esc 取消放置文本。 -- [x] Esc 取消放置图片。 -- [x] Esc 取消放置签名。 -- [x] Esc 取消画笔。 -- [x] Esc 取消当前选中对象。 -- [x] 顶部工具栏进一步精简。(已确认第二版保持现状,后续优化) -- [x] 复杂设置进一步集中到右侧面板或右键菜单中。(已确认第二版保持现状,后续优化) - -## 验收测试建议 - -- [x] 普通文本 PDF:框选区域后高亮、下划线、删除线。 -- [x] 普通文本 PDF:选择真实文字后高亮、下划线、删除线。(V3 / 0.2.2) -- [x] 普通文本 PDF:选择文字后右键多色高亮、复制、添加注释。 -- [x] 双栏文本 PDF:选择文字时优先按栏位处理,降低跨栏误选。 -- [x] 带水印、行号 PDF:选择文字时过滤常见页边和水印干扰。 -- [x] 扫描/图片型 PDF:区域高亮、图章、画笔仍可使用。 -- [x] 多页 PDF:注释列表筛选、搜索、跳转、属性编辑正确。 -- [x] 多标签 PDF:每个标签的未保存状态独立。 -- [x] 保存后重新打开:新增文本、图片、图章、遮盖、注释存在。 -- [x] 新建批注、文字图章、遮盖、图形注释后自动进入统一选择框。 -- [x] 阅读模式:不能选中页面对象,右侧工具窗口关闭。 -- [x] 大文件:30 页 PDF 页面渲染和缩略图基础验收通过。 diff --git a/docs/v3_acrobat_workflow_plan.md b/docs/v3_acrobat_workflow_plan.md deleted file mode 100644 index 463d99a..0000000 --- a/docs/v3_acrobat_workflow_plan.md +++ /dev/null @@ -1,182 +0,0 @@ -# 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. 对象对齐、样式复制等增强。 diff --git a/docs/v4_optional_advanced_plan.md b/docs/v4_optional_advanced_plan.md deleted file mode 100644 index d3b3e68..0000000 --- a/docs/v4_optional_advanced_plan.md +++ /dev/null @@ -1,116 +0,0 @@ -# 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 文本导出。 - diff --git a/packaging/version_info.txt b/packaging/version_info.txt index 9b10f90..9219cac 100644 --- a/packaging/version_info.txt +++ b/packaging/version_info.txt @@ -1,8 +1,8 @@ # UTF-8 VSVersionInfo( ffi=FixedFileInfo( - filevers=(0, 2, 2, 0), - prodvers=(0, 2, 2, 0), + filevers=(0, 2, 3, 0), + prodvers=(0, 2, 3, 0), mask=0x3f, flags=0x0, OS=0x40004, @@ -17,11 +17,11 @@ VSVersionInfo( [ StringStruct("CompanyName", "PDFReaderLite"), StringStruct("FileDescription", "PDFReaderLite"), - StringStruct("FileVersion", "0.2.2"), + StringStruct("FileVersion", "0.2.3"), StringStruct("InternalName", "PDFReaderLite"), StringStruct("OriginalFilename", "PDFReaderLite.exe"), StringStruct("ProductName", "PDFReaderLite"), - StringStruct("ProductVersion", "0.2.2"), + StringStruct("ProductVersion", "0.2.3"), ], ) ]), diff --git a/pdfreaderlite/__init__.py b/pdfreaderlite/__init__.py index b5fdc75..d31c31e 100644 --- a/pdfreaderlite/__init__.py +++ b/pdfreaderlite/__init__.py @@ -1 +1 @@ -__version__ = "0.2.2" +__version__ = "0.2.3" diff --git a/pdfreaderlite/app.py b/pdfreaderlite/app.py index 6ce87c4..e8e625b 100644 --- a/pdfreaderlite/app.py +++ b/pdfreaderlite/app.py @@ -4,7 +4,7 @@ import logging import sys from pathlib import Path -from PySide6.QtCore import QStandardPaths +from PySide6.QtCore import QtMsgType, QStandardPaths, qInstallMessageHandler from PySide6.QtGui import QIcon from PySide6.QtWidgets import QApplication, QMessageBox @@ -29,6 +29,28 @@ def configure_logging() -> Path: return log_path +def install_qt_message_logger() -> None: + level_map = { + QtMsgType.QtDebugMsg: logging.DEBUG, + QtMsgType.QtInfoMsg: logging.INFO, + QtMsgType.QtWarningMsg: logging.WARNING, + QtMsgType.QtCriticalMsg: logging.ERROR, + QtMsgType.QtFatalMsg: logging.CRITICAL, + } + + def handler(message_type, context, message) -> None: + level = level_map.get(message_type, logging.INFO) + logging.getLogger("Qt").log( + level, + "%s (%s:%s)", + message, + context.file or "", + context.line, + ) + + qInstallMessageHandler(handler) + + def main() -> int: app = QApplication(sys.argv) app.setApplicationName("PDFReaderLite") @@ -36,6 +58,7 @@ def main() -> int: app.setApplicationVersion(__version__) app.setWindowIcon(QIcon(software_icon_path().as_posix())) log_path = configure_logging() + install_qt_message_logger() def handle_exception(exc_type, exc_value, exc_traceback) -> None: logging.exception("Unhandled exception", exc_info=(exc_type, exc_value, exc_traceback)) diff --git a/pdfreaderlite/core/document.py b/pdfreaderlite/core/document.py index 5d1b40d..d7d6512 100644 --- a/pdfreaderlite/core/document.py +++ b/pdfreaderlite/core/document.py @@ -46,6 +46,11 @@ class EncryptedPdfError(RuntimeError): class PdfDocument: _TEXT_MARKUP_TYPES = {"highlight", "underline", "strikeout", "squiggly"} + _MAX_HISTORY_ITEMS = 20 + _MAX_HISTORY_BYTES = 256 * 1024 * 1024 + _MAX_SNAPSHOT_BYTES = 96 * 1024 * 1024 + _MAX_SNAPSHOT_PAGES = 300 + _MAX_RENDER_CACHE_BYTES = 192 * 1024 * 1024 def __init__(self) -> None: self.path: Path | None = None @@ -54,8 +59,14 @@ class PdfDocument: self._dirty = False self._undo_stack: list[bytes] = [] self._redo_stack: list[bytes] = [] + self._undo_stack_bytes = 0 + self._redo_stack_bytes = 0 self._render_cache: OrderedDict[tuple[int, int, float], QImage] = OrderedDict() + self._render_cache_bytes = 0 self._thumbnail_cache: OrderedDict[tuple[int, int, int], QImage] = OrderedDict() + self._text_char_cache: OrderedDict[tuple[int, int], list[tuple[int, int, int, str, fitz.Rect]]] = OrderedDict() + self._text_column_split_cache: OrderedDict[tuple[int, int], float | None] = OrderedDict() + self._annotation_cache: OrderedDict[tuple[int, int | None], list[AnnotationInfo]] = OrderedDict() @property def is_open(self) -> bool: @@ -82,7 +93,18 @@ class PdfDocument: def open(self, path: str | Path, password: str | None = None) -> None: self.close() self.path = Path(path) - self._doc = fitz.open(self.path) + self._doc = fitz.open("pdf", self.path.read_bytes()) + if self._doc.needs_pass: + if not password or not self._doc.authenticate(password): + self.close() + raise EncryptedPdfError("该 PDF 需要密码。") + self._dirty = False + self.clear_history() + + def open_bytes(self, data: bytes, title: str | Path | None = None, password: str | None = None) -> None: + self.close() + self.path = Path(title) if title else None + self._doc = fitz.open("pdf", data) if self._doc.needs_pass: if not password or not self._doc.authenticate(password): self.close() @@ -116,7 +138,7 @@ class PdfDocument: QImage.Format.Format_RGB888, ) cached = image.copy() - self._remember_cache_item(self._render_cache, cache_key, cached, max_items=16) + self._remember_image_cache_item(self._render_cache, cache_key, cached) return cached.copy() def render_thumbnail(self, page_index: int, width: int = 150) -> QImage: @@ -143,13 +165,15 @@ class PdfDocument: def page_rect(self, page_index: int) -> tuple[float, float, float, float]: return self._rect_tuple(self._page(page_index).rect) - def search(self, text: str, limit: int = 200) -> list[SearchMatch]: + def search(self, text: str, limit: int = 200, progress_callback=None) -> list[SearchMatch]: if not self._doc or not text.strip(): return [] matches: list[SearchMatch] = [] query = text.strip() for page_index, page in enumerate(self._doc): + if progress_callback and not progress_callback(page_index + 1, self.page_count): + break rects = page.search_for(query) if rects: page_text = page.get_text("text").replace("\n", " ") @@ -185,8 +209,8 @@ class PdfDocument: return items def rotate_page(self, page_index: int, degrees: int = 90) -> None: - self.snapshot() page = self._page(page_index) + self.snapshot() page.set_rotation((page.rotation + degrees) % 360) self.mark_changed() @@ -253,7 +277,7 @@ class PdfDocument: all_chars = self._page_text_chars(page) selectable_chars = all_chars if start is not None: - column_split = self._detect_text_char_column_split(all_chars, float(page.rect.width)) + column_split = self._page_text_column_split(page.number, all_chars, float(page.rect.width)) if column_split is not None: start_column = 0 if float(start[0]) < column_split else 1 column_chars = [ @@ -307,8 +331,25 @@ class PdfDocument: lines.append("".join(current_chars)) return "\n".join(lines), rects - @staticmethod - def _page_text_chars(page: fitz.Page) -> list[tuple[int, int, int, str, fitz.Rect]]: + def _page_text_column_split( + self, + page_index: int, + chars: list[tuple[int, int, int, str, fitz.Rect]], + page_width: float, + ) -> float | None: + cache_key = (self._revision, page_index) + if cache_key in self._text_column_split_cache: + self._text_column_split_cache.move_to_end(cache_key) + return self._text_column_split_cache[cache_key] + split = self._detect_text_char_column_split(chars, page_width) + self._remember_cache_item(self._text_column_split_cache, cache_key, split, max_items=16) + return split + + def _page_text_chars(self, page: fitz.Page) -> list[tuple[int, int, int, str, fitz.Rect]]: + cache_key = (self._revision, page.number) + if cache_key in self._text_char_cache: + self._text_char_cache.move_to_end(cache_key) + return self._text_char_cache[cache_key] raw = page.get_text("rawdict") lines: list[dict[str, object]] = [] page_width = float(page.rect.width) @@ -359,6 +400,7 @@ class PdfDocument: for _block_index, _line_index, text, rect in line["chars"]: chars.append((0, reading_line_index, char_index, text, rect)) char_index += 1 + self._remember_cache_item(self._text_char_cache, cache_key, chars, max_items=8) return chars @staticmethod @@ -644,7 +686,6 @@ class PdfDocument: ) -> AnnotationInfo | None: if not rects: return None - self.snapshot() page = self._page(page_index) fitz_rects = self._merge_markup_rects_for_selection( [self._normalized_rect(rect) for rect in rects], @@ -652,6 +693,7 @@ class PdfDocument: ) if not fitz_rects: return None + self.snapshot() if markup == "highlight": annot = page.add_highlight_annot(fitz_rects) elif markup == "underline": @@ -840,9 +882,15 @@ class PdfDocument: image_path: str | Path, rect: tuple[float, float, float, float], ) -> None: - self.snapshot() + image_file = Path(image_path) + if not image_file.exists(): + raise FileNotFoundError(f"图片文件不存在:{image_file}") page = self._page(page_index) - page.insert_image(fitz.Rect(*rect), filename=str(image_path), keep_proportion=True) + target_rect = fitz.Rect(*rect) + if target_rect.is_empty or target_rect.is_infinite: + raise ValueError("图片区域无效") + self.snapshot() + page.insert_image(target_rect, filename=str(image_file), keep_proportion=True) self.mark_changed() def add_signature( @@ -879,9 +927,15 @@ class PdfDocument: image_path: str | Path, rect: tuple[float, float, float, float], ) -> None: - self.snapshot() + image_file = Path(image_path) + if not image_file.exists(): + raise FileNotFoundError(f"签名图片不存在:{image_file}") page = self._page(page_index) - page.insert_image(fitz.Rect(*rect), filename=str(image_path), keep_proportion=True) + target_rect = fitz.Rect(*rect) + if target_rect.is_empty or target_rect.is_infinite: + raise ValueError("签名区域无效") + self.snapshot() + page.insert_image(target_rect, filename=str(image_file), keep_proportion=True) self.mark_changed() def add_rectangle( @@ -1029,7 +1083,6 @@ class PdfDocument: def insert_blank_page(self, after_page_index: int | None = None) -> int: if not self._doc: raise RuntimeError("没有打开 PDF") - self.snapshot() if self.page_count: source = self._page(after_page_index if after_page_index is not None else self.page_count - 1) width = source.rect.width @@ -1038,6 +1091,7 @@ class PdfDocument: width = 595 height = 842 insert_at = self.page_count if after_page_index is None else after_page_index + 1 + self.snapshot() self._doc.new_page(pno=insert_at, width=width, height=height) self.mark_changed() return insert_at @@ -1045,10 +1099,12 @@ class PdfDocument: def insert_pdf(self, source_path: str | Path, after_page_index: int | None = None) -> int: if not self._doc: raise RuntimeError("没有打开 PDF") - self.snapshot() insert_at = self.page_count if after_page_index is None else after_page_index + 1 with fitz.open(source_path) as source: count = source.page_count + if count <= 0: + return 0 + self.snapshot() self._doc.insert_pdf(source, start_at=insert_at) self.mark_changed() return count @@ -1164,18 +1220,23 @@ class PdfDocument: self._doc.set_metadata(metadata) self.mark_changed() - def annotations(self) -> list[AnnotationInfo]: + def annotations(self, page_index: int | None = None) -> list[AnnotationInfo]: if not self._doc: raise RuntimeError("没有打开 PDF") + cache_key = (self._revision, page_index) + if cache_key in self._annotation_cache: + self._annotation_cache.move_to_end(cache_key) + return list(self._annotation_cache[cache_key]) items: list[AnnotationInfo] = [] - for page_index in range(self.page_count): - page = self._page(page_index) + page_indexes = [page_index] if page_index is not None else range(self.page_count) + for current_page_index in page_indexes: + page = self._page(int(current_page_index)) annot = page.first_annot while annot: content = annot.info.get("content", "") if annot.info else "" items.append( AnnotationInfo( - page_index=page_index, + page_index=int(current_page_index), xref=annot.xref, annotation_type=annot.type[1], content=content, @@ -1183,6 +1244,7 @@ class PdfDocument: ) ) annot = annot.next + self._remember_cache_item(self._annotation_cache, cache_key, list(items), max_items=96) return items def annotation_at_point( @@ -1339,30 +1401,35 @@ class PdfDocument: return None content = annot.info.get("content", "") if annot.info else "" style = self._annotation_visual_style_from_annot(annot) + checkpoint = self._mutation_checkpoint() self.snapshot() - page = self._page(page_index) - annot = page.first_annot - while annot and annot.xref != xref: - annot = annot.next - if not annot: - return None - target_rect = fitz.Rect(x0, y0, x1, y1) - if annot_type in self._TEXT_MARKUP_TYPES: - new_annot = self._replace_text_markup_annotation(page, annot, annot_type, target_rect, content, style) - if not new_annot: + try: + page = self._page(page_index) + annot = page.first_annot + while annot and annot.xref != xref: + annot = annot.next + if not annot: return None - annot = new_annot - else: - annot.set_rect(target_rect) - annot.update() - self.mark_changed() - return AnnotationInfo( - page_index=page_index, - xref=annot.xref, - annotation_type=annot.type[1], - content=annot.info.get("content", "") if annot.info else "", - rect=self._rect_tuple(annot.rect), - ) + target_rect = fitz.Rect(x0, y0, x1, y1) + if annot_type in self._TEXT_MARKUP_TYPES: + new_annot = self._replace_text_markup_annotation(page, annot, annot_type, target_rect, content, style) + if not new_annot: + return None + annot = new_annot + else: + annot.set_rect(target_rect) + annot.update() + self.mark_changed() + return AnnotationInfo( + page_index=page_index, + xref=annot.xref, + annotation_type=annot.type[1], + content=annot.info.get("content", "") if annot.info else "", + rect=self._rect_tuple(annot.rect), + ) + except Exception: + self._rollback_mutation(checkpoint) + raise def update_annotation_rects( self, @@ -1380,6 +1447,7 @@ class PdfDocument: if not normalized_updates: return {} + checkpoint = self._mutation_checkpoint() self.snapshot() page = self._page(page_index) targets = [] @@ -1391,30 +1459,34 @@ class PdfDocument: if not targets: return {} - updated: dict[int, AnnotationInfo] = {} - for original_xref, annot, rect in targets: - annot_type = annot.type[1].lower() - content = annot.info.get("content", "") if annot.info else "" - if annot_type not in self._TEXT_MARKUP_TYPES and (rect.width < 12 or rect.height < 12): - continue - if annot_type in self._TEXT_MARKUP_TYPES: - style = self._annotation_visual_style_from_annot(annot) - new_annot = self._replace_text_markup_annotation(page, annot, annot_type, rect, content, style) - if not new_annot: + try: + updated: dict[int, AnnotationInfo] = {} + for original_xref, annot, rect in targets: + annot_type = annot.type[1].lower() + content = annot.info.get("content", "") if annot.info else "" + if annot_type not in self._TEXT_MARKUP_TYPES and (rect.width < 12 or rect.height < 12): continue - annot = new_annot - else: - annot.set_rect(rect) - annot.update() - updated[original_xref] = AnnotationInfo( - page_index=page_index, - xref=annot.xref, - annotation_type=annot.type[1], - content=annot.info.get("content", "") if annot.info else "", - rect=self._rect_tuple(annot.rect), - ) - self.mark_changed() - return updated + if annot_type in self._TEXT_MARKUP_TYPES: + style = self._annotation_visual_style_from_annot(annot) + new_annot = self._replace_text_markup_annotation(page, annot, annot_type, rect, content, style) + if not new_annot: + continue + annot = new_annot + else: + annot.set_rect(rect) + annot.update() + updated[original_xref] = AnnotationInfo( + page_index=page_index, + xref=annot.xref, + annotation_type=annot.type[1], + content=annot.info.get("content", "") if annot.info else "", + rect=self._rect_tuple(annot.rect), + ) + self.mark_changed() + return updated + except Exception: + self._rollback_mutation(checkpoint) + raise def move_annotation(self, page_index: int, xref: int, dx: float, dy: float) -> bool: annot = self._annotation(page_index, xref) @@ -1516,36 +1588,41 @@ class PdfDocument: if not rects: return None + checkpoint = self._mutation_checkpoint() self.snapshot() - page = self._page(page_index) - annot = page.first_annot - while annot and annot.xref != xref: - annot = annot.next - if not annot: - return None - page.delete_annot(annot) - if annot_type == "highlight": - new_annot = page.add_highlight_annot(rects) - elif annot_type == "underline": - new_annot = page.add_underline_annot(rects) - elif annot_type == "strikeout": - new_annot = page.add_strikeout_annot(rects) - elif annot_type == "squiggly": - new_annot = page.add_squiggly_annot(rects) - else: - return None - new_annot.set_colors(stroke=color) - if content: - new_annot.set_info(content=content) - new_annot.update() - self.mark_changed() - return AnnotationInfo( - page_index=page_index, - xref=new_annot.xref, - annotation_type=new_annot.type[1], - content=new_annot.info.get("content", "") if new_annot.info else "", - rect=self._rect_tuple(new_annot.rect), - ) + try: + page = self._page(page_index) + annot = page.first_annot + while annot and annot.xref != xref: + annot = annot.next + if not annot: + return None + page.delete_annot(annot) + if annot_type == "highlight": + new_annot = page.add_highlight_annot(rects) + elif annot_type == "underline": + new_annot = page.add_underline_annot(rects) + elif annot_type == "strikeout": + new_annot = page.add_strikeout_annot(rects) + elif annot_type == "squiggly": + new_annot = page.add_squiggly_annot(rects) + else: + return None + new_annot.set_colors(stroke=color) + if content: + new_annot.set_info(content=content) + new_annot.update() + self.mark_changed() + return AnnotationInfo( + page_index=page_index, + xref=new_annot.xref, + annotation_type=new_annot.type[1], + content=new_annot.info.get("content", "") if new_annot.info else "", + rect=self._rect_tuple(new_annot.rect), + ) + except Exception: + self._rollback_mutation(checkpoint) + raise def update_freetext_annotation( self, @@ -1562,32 +1639,37 @@ class PdfDocument: if not annot or annot.type[1].lower() != "freetext": return None rect = self._rect_tuple(annot.rect) + checkpoint = self._mutation_checkpoint() self.snapshot() - page = self._page(page_index) - annot = page.first_annot - while annot and annot.xref != xref: - annot = annot.next - if not annot: - return None - page.delete_annot(annot) - new_annot = page.add_freetext_annot( - fitz.Rect(*rect), - content, - fontsize=max(8, min(72, int(font_size))), - fontname="china-s", - text_color=text_color, - border_width=0, - ) - new_annot.set_info(content=content) - new_annot.update() - self.mark_changed() - return AnnotationInfo( - page_index=page_index, - xref=new_annot.xref, - annotation_type=new_annot.type[1], - content=content, - rect=self._rect_tuple(new_annot.rect), - ) + try: + page = self._page(page_index) + annot = page.first_annot + while annot and annot.xref != xref: + annot = annot.next + if not annot: + return None + page.delete_annot(annot) + new_annot = page.add_freetext_annot( + fitz.Rect(*rect), + content, + fontsize=max(8, min(72, int(font_size))), + fontname="china-s", + text_color=text_color, + border_width=0, + ) + new_annot.set_info(content=content) + new_annot.update() + self.mark_changed() + return AnnotationInfo( + page_index=page_index, + xref=new_annot.xref, + annotation_type=new_annot.type[1], + content=content, + rect=self._rect_tuple(new_annot.rect), + ) + except Exception: + self._rollback_mutation(checkpoint) + raise def duplicate_annotation_info( self, @@ -1767,6 +1849,8 @@ class PdfDocument: def delete_page(self, page_index: int) -> None: if not self._doc: raise RuntimeError("没有打开 PDF") + if page_index < 0 or page_index >= self.page_count: + raise IndexError("页码超出范围") self.snapshot() self._doc.delete_page(page_index) self.mark_changed() @@ -1859,21 +1943,37 @@ class PdfDocument: raise RuntimeError("没有打开 PDF") target = Path(path) + original_path = self.path target.parent.mkdir(parents=True, exist_ok=True) with NamedTemporaryFile(delete=False, suffix=".pdf", dir=target.parent) as tmp: temp_path = Path(tmp.name) + backup_path: Path | None = None try: self._doc.save(temp_path, garbage=4, deflate=True) - if self._doc: - self._doc.close() + self._validate_saved_pdf(temp_path) + backup_path = self._write_recovery_copy(target.parent) + self._doc.close() + self._doc = None temp_path.replace(target) self.path = target - self._doc = fitz.open(target) + self._doc = fitz.open("pdf", target.read_bytes()) self.mark_saved() + except Exception: + if self._doc is None: + self.path = original_path + if original_path and original_path.exists(): + try: + self._doc = fitz.open("pdf", original_path.read_bytes()) + except Exception: + self._restore_from_recovery_copy(backup_path) + else: + self._restore_from_recovery_copy(backup_path) + raise finally: if temp_path.exists(): temp_path.unlink() + self._delete_temp_pdf(backup_path) def save_encrypted( self, @@ -1889,7 +1989,13 @@ class PdfDocument: raise ValueError("密码不能为空") target = Path(path) + original_path = self.path + original_dirty = self._dirty target.parent.mkdir(parents=True, exist_ok=True) + with NamedTemporaryFile(delete=False, suffix=".pdf", dir=target.parent) as tmp: + temp_path = Path(tmp.name) + backup_path: Path | None = None + permissions = fitz.PDF_PERM_ACCESSIBILITY if allow_print: permissions |= fitz.PDF_PERM_PRINT @@ -1897,16 +2003,85 @@ class PdfDocument: permissions |= fitz.PDF_PERM_COPY if allow_modify: permissions |= fitz.PDF_PERM_MODIFY - self._doc.save( - target, - garbage=4, - deflate=True, - encryption=fitz.PDF_ENCRYPT_AES_256, - owner_pw=password, - user_pw=password, - permissions=permissions, - ) - self._dirty = False + try: + self._doc.save( + temp_path, + garbage=4, + deflate=True, + encryption=fitz.PDF_ENCRYPT_AES_256, + owner_pw=password, + user_pw=password, + permissions=permissions, + ) + self._validate_saved_pdf(temp_path, password) + same_as_current = ( + original_path is not None + and target.resolve() == original_path.resolve() + ) + if same_as_current: + backup_path = self._write_recovery_copy(target.parent) + self._doc.close() + self._doc = None + temp_path.replace(target) + if same_as_current: + self.path = target + self._doc = fitz.open("pdf", target.read_bytes()) + if self._doc.needs_pass and not self._doc.authenticate(password): + raise EncryptedPdfError("无法重新打开加密 PDF。") + self.mark_saved() + else: + self._dirty = original_dirty + except Exception: + if self._doc is None: + self.path = original_path + self._restore_from_recovery_copy(backup_path) + self._dirty = original_dirty + raise + finally: + if temp_path.exists(): + temp_path.unlink() + self._delete_temp_pdf(backup_path) + + def to_bytes(self) -> bytes: + if not self._doc: + raise RuntimeError("没有打开 PDF") + return self._doc.tobytes(garbage=4, deflate=True) + + def save_copy(self, path: str | Path) -> None: + if not self._doc: + raise RuntimeError("没有打开 PDF") + target = Path(path) + target.parent.mkdir(parents=True, exist_ok=True) + self._doc.save(target, garbage=4, deflate=True) + self._validate_saved_pdf(target) + + def _write_recovery_copy(self, directory: Path) -> Path: + with NamedTemporaryFile(delete=False, suffix=".pdf", dir=directory) as tmp: + backup_path = Path(tmp.name) + self.save_copy(backup_path) + return backup_path + + def _restore_from_recovery_copy(self, backup_path: Path | None) -> None: + if not backup_path or not backup_path.exists(): + raise RuntimeError("无法恢复保存前的 PDF 内容") + self._doc = fitz.open("pdf", backup_path.read_bytes()) + + def _delete_temp_pdf(self, path: Path | None) -> None: + if not path: + return + try: + if path.exists(): + path.unlink() + except OSError: + pass + + def restore_bytes(self, data: bytes, dirty: bool = True) -> None: + if self._doc: + self._doc.close() + self._doc = fitz.open("pdf", data) + self._dirty = dirty + self._revision += 1 + self.clear_cache() def _page(self, page_index: int) -> fitz.Page: if not self._doc: @@ -1948,10 +2123,24 @@ class PdfDocument: def snapshot(self) -> None: if not self._doc: return - self._undo_stack.append(self._doc.tobytes(garbage=4, deflate=True)) - if len(self._undo_stack) > 20: - self._undo_stack.pop(0) + if self._should_skip_history_snapshot(): + self.clear_history() + return + data = self.to_bytes() + self._push_history(self._undo_stack, data, "undo") self._redo_stack.clear() + self._redo_stack_bytes = 0 + + def _should_skip_history_snapshot(self) -> bool: + if self.page_count >= self._MAX_SNAPSHOT_PAGES: + return True + if self.path and self.path.exists(): + try: + if self.path.stat().st_size >= self._MAX_SNAPSHOT_BYTES: + return True + except OSError: + return False + return False def can_undo(self) -> bool: return bool(self._undo_stack) @@ -1962,22 +2151,26 @@ class PdfDocument: def undo(self) -> bool: if not self._doc or not self._undo_stack: return False - self._redo_stack.append(self._doc.tobytes(garbage=4, deflate=True)) + self._push_history(self._redo_stack, self.to_bytes(), "redo") data = self._undo_stack.pop() + self._undo_stack_bytes -= len(data) self._replace_with_bytes(data) return True def redo(self) -> bool: if not self._doc or not self._redo_stack: return False - self._undo_stack.append(self._doc.tobytes(garbage=4, deflate=True)) + self._push_history(self._undo_stack, self.to_bytes(), "undo") data = self._redo_stack.pop() + self._redo_stack_bytes -= len(data) self._replace_with_bytes(data) return True def clear_history(self) -> None: self._undo_stack.clear() self._redo_stack.clear() + self._undo_stack_bytes = 0 + self._redo_stack_bytes = 0 def _replace_with_bytes(self, data: bytes) -> None: if self._doc: @@ -1985,9 +2178,78 @@ class PdfDocument: self._doc = fitz.open("pdf", data) self.mark_changed() + def _mutation_checkpoint(self) -> tuple[bytes, bool, list[bytes], list[bytes], int, int]: + return ( + self.to_bytes(), + self._dirty, + list(self._undo_stack), + list(self._redo_stack), + self._undo_stack_bytes, + self._redo_stack_bytes, + ) + + def _rollback_mutation(self, checkpoint: tuple[bytes, bool, list[bytes], list[bytes], int, int]) -> None: + data, dirty, undo_stack, redo_stack, undo_bytes, redo_bytes = checkpoint + self.restore_bytes(data, dirty=dirty) + self._undo_stack = undo_stack + self._redo_stack = redo_stack + self._undo_stack_bytes = undo_bytes + self._redo_stack_bytes = redo_bytes + + def _push_history(self, stack: list[bytes], data: bytes, stack_name: str) -> None: + if len(data) > self._MAX_HISTORY_BYTES: + return + stack.append(data) + if stack_name == "undo": + self._undo_stack_bytes += len(data) + self._trim_history_stack(stack, "undo") + else: + self._redo_stack_bytes += len(data) + self._trim_history_stack(stack, "redo") + + def _trim_history_stack(self, stack: list[bytes], stack_name: str) -> None: + if stack_name == "undo": + while ( + len(stack) > self._MAX_HISTORY_ITEMS + or self._undo_stack_bytes > self._MAX_HISTORY_BYTES + ) and stack: + self._undo_stack_bytes -= len(stack.pop(0)) + else: + while ( + len(stack) > self._MAX_HISTORY_ITEMS + or self._redo_stack_bytes > self._MAX_HISTORY_BYTES + ) and stack: + self._redo_stack_bytes -= len(stack.pop(0)) + + @staticmethod + def _validate_saved_pdf(path: Path, password: str | None = None) -> None: + with fitz.open(path) as check: + if check.needs_pass and (not password or not check.authenticate(password)): + raise EncryptedPdfError("保存后的 PDF 无法通过密码验证。") + _ = check.page_count + def clear_cache(self) -> None: self._render_cache.clear() + self._render_cache_bytes = 0 self._thumbnail_cache.clear() + self._text_char_cache.clear() + self._text_column_split_cache.clear() + self._annotation_cache.clear() + + def _remember_image_cache_item( + self, + cache: OrderedDict, + key: tuple, + image: QImage, + ) -> None: + if key in cache: + self._render_cache_bytes -= max(0, cache[key].sizeInBytes()) + cache[key] = image + cache.move_to_end(key) + self._render_cache_bytes += max(0, image.sizeInBytes()) + while cache and self._render_cache_bytes > self._MAX_RENDER_CACHE_BYTES: + _, removed = cache.popitem(last=False) + self._render_cache_bytes -= max(0, removed.sizeInBytes()) @staticmethod def _remember_cache_item( diff --git a/pdfreaderlite/core/file_association.py b/pdfreaderlite/core/file_association.py index 983514b..5717b94 100644 --- a/pdfreaderlite/core/file_association.py +++ b/pdfreaderlite/core/file_association.py @@ -38,6 +38,13 @@ def register_pdf_association(icon_path: str | Path) -> None: def unregister_pdf_association() -> None: + try: + with winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Classes\.pdf", 0, winreg.KEY_READ | winreg.KEY_WRITE) as key: + current_value, _ = winreg.QueryValueEx(key, "") + if current_value == PROG_ID: + winreg.DeleteValue(key, "") + except FileNotFoundError: + pass try: winreg.DeleteTree(winreg.HKEY_CURRENT_USER, rf"Software\Classes\{PROG_ID}") except FileNotFoundError: diff --git a/pdfreaderlite/ui/main_window.py b/pdfreaderlite/ui/main_window.py index e62f309..8aa4064 100644 --- a/pdfreaderlite/ui/main_window.py +++ b/pdfreaderlite/ui/main_window.py @@ -1,12 +1,16 @@ from __future__ import annotations import json +import logging import math +from collections.abc import Callable from dataclasses import dataclass -from datetime import datetime +from datetime import datetime, timedelta from pathlib import Path +from tempfile import NamedTemporaryFile -from PySide6.QtCore import QRect, QSize, QSignalBlocker, QSettings, QStandardPaths, Qt, QUrl +import fitz +from PySide6.QtCore import QObject, QRect, QSize, QSignalBlocker, QSettings, QStandardPaths, Qt, QThread, QUrl, Signal from PySide6.QtGui import ( QAction, QActionGroup, @@ -46,6 +50,7 @@ from PySide6.QtWidgets import ( QMainWindow, QMenu, QMessageBox, + QProgressDialog, QPushButton, QSplitter, QSlider, @@ -87,10 +92,119 @@ class DocumentSession: next_raster_id: int = 1 +class SearchWorker(QObject): + progress = Signal(int, int) + finished = Signal(int, object) + failed = Signal(int, str) + + def __init__(self, job_id: int, pdf_source: bytes | Path, query: str, limit: int = 200) -> None: + super().__init__() + self.job_id = job_id + self.pdf_source = pdf_source + self.query = query + self.limit = limit + self._cancelled = False + + def cancel(self) -> None: + self._cancelled = True + + def run(self) -> None: + matches: list[SearchMatch] = [] + try: + if isinstance(self.pdf_source, Path): + document = fitz.open(self.pdf_source) + else: + document = fitz.open("pdf", self.pdf_source) + with document: + total = document.page_count + query_lower = self.query.lower() + for page_index in range(total): + if self._cancelled: + break + self.progress.emit(page_index + 1, total) + page = document.load_page(page_index) + rects = page.search_for(self.query) + if not rects: + continue + page_text = page.get_text("text").replace("\n", " ") + snippet_index = page_text.lower().find(query_lower) + if snippet_index >= 0: + start = max(0, snippet_index - 24) + end = min(len(page_text), snippet_index + len(self.query) + 48) + snippet = page_text[start:end].strip() + else: + snippet = f"第 {page_index + 1} 页匹配" + matches.append( + SearchMatch( + page_index=page_index, + text=snippet, + rects=[ + (float(rect.x0), float(rect.y0), float(rect.x1), float(rect.y1)) + for rect in rects + ], + ) + ) + if len(matches) >= self.limit: + break + except Exception as exc: + self.failed.emit(self.job_id, str(exc)) + return + self.finished.emit(self.job_id, matches) + + +class BackgroundTaskWorker(QObject): + finished = Signal(int, object) + failed = Signal(int, str) + + def __init__(self, job_id: int, callback: Callable[[], object]) -> None: + super().__init__() + self.job_id = job_id + self.callback = callback + + def run(self) -> None: + try: + result = self.callback() + except Exception as exc: + self.failed.emit(self.job_id, str(exc)) + return + self.finished.emit(self.job_id, result) + + +class OpenPdfWorker(QObject): + finished = Signal(int, object, str, str) + encrypted = Signal(int) + failed = Signal(int, str) + + def __init__(self, job_id: int, path: Path, password: str | None = None) -> None: + super().__init__() + self.job_id = job_id + self.path = path + self.password = password or "" + + def run(self) -> None: + try: + data = self.path.read_bytes() + with fitz.open("pdf", data) as document: + if document.needs_pass: + if not self.password or not document.authenticate(self.password): + self.encrypted.emit(self.job_id) + return + _ = document.page_count + except Exception as exc: + self.failed.emit(self.job_id, str(exc)) + return + self.finished.emit(self.job_id, data, str(self.path), self.password) + + class MainWindow(QMainWindow): + _TRANSACTION_MEMORY_LIMIT = 128 * 1024 * 1024 + _TRANSACTION_PAGE_LIMIT = 300 + _BACKGROUND_OPEN_LIMIT = 32 * 1024 * 1024 + def __init__(self) -> None: super().__init__() self.settings = QSettings() + self._cleanup_temp_raster_files() self.recent_files: list[str] = self.settings.value("recentFiles", [], list) self.dark_mode = self.settings.value("darkMode", False, bool) self.annotation_color = QColor( @@ -128,6 +242,16 @@ class MainWindow(QMainWindow): self.annotation_property_font_size = QSpinBox() self.annotation_property_width = QSpinBox() self.annotation_property_opacity = QDoubleSpinBox() + self._search_thread: QThread | None = None + self._search_worker: SearchWorker | None = None + self._search_job_id = 0 + self._search_temp_path: Path | None = None + self._background_job_id = 0 + self._background_threads: set[QThread] = set() + self._background_workers: set[BackgroundTaskWorker] = set() + self._open_job_id = 0 + self._open_threads: set[QThread] = set() + self._open_workers: set[OpenPdfWorker] = set() self.annotation_property_apply_button = QPushButton("应用属性") self.mode_status_label = QLabel() self.right_tools = RightToolsPanel(self.search_box, self.search_results) @@ -158,9 +282,20 @@ class MainWindow(QMainWindow): self._update_status() def closeEvent(self, event) -> None: + if any(thread.isRunning() for thread in self._open_threads): + QMessageBox.information(self, "打开文件", "当前正在打开 PDF,请等待完成后再关闭软件。") + event.ignore() + return + if any(thread.isRunning() for thread in self._background_threads): + QMessageBox.information(self, "后台任务", "当前还有后台任务正在运行,请等待完成后再关闭软件。") + event.ignore() + return if not self._confirm_close_all_sessions(): event.ignore() return + for session in self.sessions: + session.viewer.stop_async_render() + self._stop_search_worker(wait_ms=1200) self.settings.setValue("windowGeometry", self.saveGeometry()) self.settings.setValue("windowState", self.saveState()) super().closeEvent(event) @@ -217,25 +352,40 @@ class MainWindow(QMainWindow): def _connect_session_signals(self, session: DocumentSession) -> None: session.sidebar.page_selected.connect(session.viewer.go_to_page) session.viewer.page_changed.connect(session.sidebar.select_page) - session.viewer.page_changed.connect(lambda _: self._update_status()) - session.viewer.page_changed.connect(lambda _: self._refresh_session_raster_overlays()) - session.viewer.page_changed.connect(lambda _: self._refresh_annotation_panel()) - session.viewer.zoom_changed.connect(lambda _: self._update_status()) + session.viewer.page_changed.connect(lambda _, watched=session: self._run_if_active_session(watched, self._update_status)) + session.viewer.page_changed.connect(lambda _, watched=session: self._run_if_active_session(watched, self._refresh_session_raster_overlays)) + session.viewer.page_changed.connect(lambda _, watched=session: self._run_if_active_session(watched, self._refresh_annotations_for_page_change)) + session.viewer.zoom_changed.connect(lambda _, watched=session: self._run_if_active_session(watched, self._update_status)) session.viewer.zoom_changed.connect(lambda zoom, watched=session: self._sync_zoom_controls(zoom, watched)) - session.viewer.ink_stroke_finished.connect(self.add_ink_stroke) - session.viewer.placement_requested.connect(self.place_pending_object) - session.viewer.area_selection_finished.connect(self.add_area_markup) - session.viewer.text_selection_preview_changed.connect(self.preview_text_selection) - session.viewer.text_selection_finished.connect(self.handle_text_selection) - session.viewer.text_selection_click_requested.connect(self.select_existing_text_markup_at_point) - session.viewer.text_selection_context_requested.connect(self.show_text_selection_context_menu) - session.viewer.shape_placement_finished.connect(self.add_shape_from_points) - session.viewer.object_select_requested.connect(self.select_object_at_point) - session.viewer.object_rect_changed.connect(self.update_selected_object_rect) - session.viewer.object_context_requested.connect(self.show_object_context_menu) - session.viewer.object_double_clicked.connect(self.edit_object_at_point) - session.viewer.annotation_double_clicked.connect(self.edit_annotation_at_point) - session.viewer.annotation_hover_requested.connect(self.show_annotation_tooltip) + session.viewer.ink_stroke_finished.connect(lambda page, stroke, watched=session: self._run_if_active_session(watched, self.add_ink_stroke, page, stroke)) + session.viewer.placement_requested.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.place_pending_object, page, point)) + session.viewer.area_selection_finished.connect(lambda page, rect, watched=session: self._run_if_active_session(watched, self.add_area_markup, page, rect)) + session.viewer.text_selection_preview_changed.connect(lambda page, rect, start, end, watched=session: self._run_if_active_session(watched, self.preview_text_selection, page, rect, start, end)) + session.viewer.text_selection_finished.connect(lambda page, rect, start, end, watched=session: self._run_if_active_session(watched, self.handle_text_selection, page, rect, start, end)) + session.viewer.text_selection_click_requested.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.select_existing_text_markup_at_point, page, point)) + session.viewer.text_selection_context_requested.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.show_text_selection_context_menu, page, point)) + session.viewer.shape_placement_finished.connect(lambda page, kind, start, end, watched=session: self._run_if_active_session(watched, self.add_shape_from_points, page, kind, start, end)) + session.viewer.object_select_requested.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.select_object_at_point, page, point)) + session.viewer.object_rect_changed.connect(lambda page, rect, watched=session: self._run_if_active_session(watched, self.update_selected_object_rect, page, rect)) + session.viewer.object_context_requested.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.show_object_context_menu, page, point)) + session.viewer.object_double_clicked.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.edit_object_at_point, page, point)) + session.viewer.annotation_double_clicked.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.edit_annotation_at_point, page, point)) + session.viewer.annotation_hover_requested.connect(lambda page, point, watched=session: self._run_if_active_session(watched, self.show_annotation_tooltip, page, point)) + + def _run_if_active_session(self, session: DocumentSession, callback, *args) -> None: + if session is self._current_session_or_none(): + callback(*args) + + def _run_ui_action(self, action_name: str, callback) -> None: + QApplication.setOverrideCursor(Qt.CursorShape.WaitCursor) + self.statusBar().showMessage(f"正在执行:{action_name}...") + try: + callback() + except Exception as exc: + logging.exception("UI action failed: %s", action_name) + QMessageBox.critical(self, f"{action_name}失败", f"操作未完成:\n{exc}") + finally: + QApplication.restoreOverrideCursor() def _persist_current_session_state(self) -> None: index = self.active_session_index @@ -264,13 +414,22 @@ class MainWindow(QMainWindow): self._update_title() self._update_status() - def _current_session(self) -> DocumentSession: + def _current_session_or_none(self) -> DocumentSession | None: index = self.tab_widget.currentIndex() - return self.sessions[index] + if 0 <= index < len(self.sessions): + return self.sessions[index] + return None + + def _current_session(self) -> DocumentSession: + session = self._current_session_or_none() + if session is None: + raise RuntimeError("没有活动文档会话") + return session def _on_tab_changed(self, index: int) -> None: self._persist_current_session_state() - self._activate_session(index) + if 0 <= index < len(self.sessions): + self._activate_session(index) def _close_tab(self, index: int) -> None: if not (0 <= index < len(self.sessions)): @@ -382,7 +541,7 @@ class MainWindow(QMainWindow): ) -> None: if not hasattr(self, "zoom_slider"): return - if watched is not None and watched is not self._current_session(): + if watched is not None and watched is not self._current_session_or_none(): return percent = max(20, min(300, round(zoom * 100))) with QSignalBlocker(self.zoom_slider), QSignalBlocker(self.zoom_percent_input): @@ -440,15 +599,28 @@ class MainWindow(QMainWindow): return path = selected + path_obj = Path(path) + if any(thread.isRunning() for thread in self._open_threads): + self.statusBar().showMessage("正在打开 PDF,请稍后再试。", 3000) + return + previous_index = self.active_session_index + created_index: int | None = None if self.document.is_open: - self._create_document_session(Path(path).name) + self._create_document_session(path_obj.name) + created_index = self.active_session_index + try: + if path_obj.stat().st_size >= self._BACKGROUND_OPEN_LIMIT: + self._start_open_file_background(path_obj, None, created_index, previous_index) + return + except OSError: + pass try: self._clear_session_raster_objects() - self.document.open(path) + self.document.open(path_obj) self.viewer.set_document(self.document) self._restore_primary_pointer_or_hand() self.sidebar.load_document(self.document) - self._remember_file(str(path)) + self._remember_file(str(path_obj)) self._update_current_tab_title() self._update_title() self._update_status() @@ -462,25 +634,126 @@ class MainWindow(QMainWindow): if ok and password: try: self._clear_session_raster_objects() - self.document.open(path, password) + self.document.open(path_obj, password) self.viewer.set_document(self.document) self._restore_primary_pointer_or_hand() self.sidebar.load_document(self.document) - self._remember_file(str(path)) + self._remember_file(str(path_obj)) self._update_current_tab_title() self._update_title() self._update_status() except Exception as exc: + self._discard_failed_open_session(created_index, previous_index) QMessageBox.critical(self, "打开失败", f"密码错误或无法打开 PDF:\n{exc}") + else: + self._discard_failed_open_session(created_index, previous_index) except Exception as exc: + self._discard_failed_open_session(created_index, previous_index) QMessageBox.critical(self, "打开失败", f"无法打开 PDF:\n{exc}") + def _start_open_file_background( + self, + path: Path, + password: str | None, + created_index: int | None, + previous_index: int, + ) -> None: + self._open_job_id += 1 + job_id = self._open_job_id + progress = QProgressDialog("正在打开 PDF...", "", 0, 0, self) + progress.setWindowTitle("打开 PDF") + progress.setWindowModality(Qt.WindowModality.WindowModal) + progress.setMinimumDuration(200) + progress.setCancelButton(None) + progress.show() + + target_session = self.sessions[created_index] if created_index is not None else self.sessions[self.active_session_index] + thread = QThread(self) + worker = OpenPdfWorker(job_id, path, password) + worker.moveToThread(thread) + self._open_threads.add(thread) + self._open_workers.add(worker) + + def finish_open(finished_job_id: int, data: bytes, file_path: str, used_password: str) -> None: + progress.close() + if finished_job_id == job_id and target_session in self.sessions: + self._apply_opened_pdf(target_session, data, Path(file_path), used_password or None) + thread.quit() + + def request_password(encrypted_job_id: int) -> None: + progress.close() + thread.quit() + if encrypted_job_id != job_id: + return + password_text, ok = QInputDialog.getText( + self, + "输入密码", + "该 PDF 需要打开密码:", + QLineEdit.EchoMode.Password, + ) + if ok and password_text: + self._start_open_file_background(path, password_text, created_index, previous_index) + else: + self._discard_failed_open_session(created_index, previous_index) + + def fail_open(failed_job_id: int, message_text: str) -> None: + progress.close() + thread.quit() + if failed_job_id == job_id: + self._discard_failed_open_session(created_index, previous_index) + QMessageBox.critical(self, "打开失败", f"无法打开 PDF:\n{message_text}") + + def cleanup_thread() -> None: + self._open_threads.discard(thread) + self._open_workers.discard(worker) + + thread.started.connect(worker.run) + worker.finished.connect(finish_open) + worker.encrypted.connect(request_password) + worker.failed.connect(fail_open) + worker.finished.connect(worker.deleteLater) + worker.encrypted.connect(worker.deleteLater) + worker.failed.connect(worker.deleteLater) + thread.finished.connect(cleanup_thread) + thread.finished.connect(thread.deleteLater) + thread.start() + + def _apply_opened_pdf( + self, + session: DocumentSession, + data: bytes, + path: Path, + password: str | None, + ) -> None: + index = self.sessions.index(session) + self._activate_session(index) + self._clear_session_raster_objects() + session.document.open_bytes(data, path, password) + session.viewer.set_document(session.document) + self._restore_primary_pointer_or_hand() + session.sidebar.load_document(session.document) + self._remember_file(str(path)) + self._update_current_tab_title() + self._update_title() + self._update_status() + + def _discard_failed_open_session(self, created_index: int | None, previous_index: int) -> None: + if created_index is None or not (0 <= created_index < len(self.sessions)): + return + session = self.sessions[created_index] + session.document.close() + self.tab_widget.removeTab(created_index) + self.sessions.pop(created_index) + if self.sessions: + self._activate_session(max(0, min(previous_index, len(self.sessions) - 1))) + else: + self._create_document_session("未打开") + def save_file(self) -> bool: if not self._ensure_document(): return False try: - self._flush_session_raster_objects() - self.document.save() + self._run_with_raster_flush(self.document.save) self._update_current_tab_title() self.statusBar().showMessage("已保存", 3000) return True @@ -499,8 +772,7 @@ class MainWindow(QMainWindow): if not selected.lower().endswith(".pdf"): selected += ".pdf" try: - self._flush_session_raster_objects() - self.document.save_as(selected) + self._run_with_raster_flush(lambda: self.document.save_as(selected)) self._remember_file(selected) self._update_current_tab_title() self._update_title() @@ -548,13 +820,14 @@ class MainWindow(QMainWindow): if not selected.lower().endswith(".pdf"): selected += ".pdf" try: - self._flush_session_raster_objects() - self.document.save_encrypted( - selected, - password, - allow_print=allow_print.isChecked(), - allow_copy=allow_copy.isChecked(), - allow_modify=allow_modify.isChecked(), + self._run_with_raster_flush( + lambda: self.document.save_encrypted( + selected, + password, + allow_print=allow_print.isChecked(), + allow_copy=allow_copy.isChecked(), + allow_modify=allow_modify.isChecked(), + ) ) self._remember_file(selected) self._update_current_tab_title() @@ -573,8 +846,7 @@ class MainWindow(QMainWindow): if not selected.lower().endswith(".pdf"): selected += ".pdf" try: - self._flush_session_raster_objects() - self.document.save_as(selected) + self._run_with_raster_flush(lambda: self.document.save_as(selected)) self._remember_file(selected) self._update_current_tab_title() self._update_title() @@ -595,8 +867,18 @@ class MainWindow(QMainWindow): if not painter.begin(printer): QMessageBox.critical(self, "打印失败", "无法启动打印任务。") return + progress = QProgressDialog("正在打印 PDF...", "取消", 0, self.document.page_count, self) + progress.setWindowTitle("打印") + progress.setWindowModality(Qt.WindowModality.WindowModal) + progress.setMinimumDuration(300) + canceled = False try: for page_index in range(self.document.page_count): + if progress.wasCanceled(): + canceled = True + break + progress.setValue(page_index) + QApplication.processEvents() if page_index > 0: printer.newPage() image = self.document.render_page(page_index, 2.0) @@ -609,17 +891,26 @@ class MainWindow(QMainWindow): x = int(page_rect.x() + (page_rect.width() - scaled.width()) / 2) y = int(page_rect.y() + (page_rect.height() - scaled.height()) / 2) painter.drawImage(x, y, scaled) + if not canceled: + progress.setValue(self.document.page_count) finally: painter.end() - self.statusBar().showMessage("打印任务已发送", 3000) + progress.close() + if canceled: + self.statusBar().showMessage("打印已取消,可能已有部分页面发送到打印机", 5000) + else: + self.statusBar().showMessage("打印任务已发送", 3000) def rotate_page(self) -> None: if not self._ensure_document(): return page_index = self.viewer.page_index - self._flush_session_raster_objects() - page_index = max(0, min(page_index, self.document.page_count - 1)) - self.document.rotate_page(page_index) + def operation() -> int: + target = max(0, min(page_index, self.document.page_count - 1)) + self.document.rotate_page(target) + return target + + page_index = self._run_document_transaction(operation) self._refresh_document_view(page_index) self.statusBar().showMessage("页面已旋转,记得保存", 3000) @@ -637,9 +928,8 @@ class MainWindow(QMainWindow): ) if reply != QMessageBox.StandardButton.Yes: return - self._flush_session_raster_objects() target_page = min(self.viewer.page_index, self.document.page_count - 2) - self.document.delete_page(self.viewer.page_index) + self._run_document_transaction(lambda: self.document.delete_page(self.viewer.page_index)) self._refresh_document_view(target_page) self.statusBar().showMessage("页面已删除,记得保存", 3000) @@ -669,8 +959,7 @@ class MainWindow(QMainWindow): ) if not ok: return - self._flush_session_raster_objects() - self.document.move_page(source_page - 1, target_page - 1) + self._run_document_transaction(lambda: self.document.move_page(source_page - 1, target_page - 1)) self._refresh_document_view(target_page - 1) self.statusBar().showMessage("页面已移动,记得保存", 3000) @@ -684,16 +973,19 @@ class MainWindow(QMainWindow): if dialog.exec() != QDialog.DialogCode.Accepted: return try: - self._flush_session_raster_objects() - original_page_count = self.document.page_count - rotated_pages = [page for page, degrees in dialog.rotations.items() if degrees % 360] - for page_index, degrees in dialog.rotations.items(): - if degrees % 360: - self.document.rotate_pages([page_index], degrees) page_plan = dialog.page_plan() current_page_before = self.viewer.page_index target_page = self._page_after_page_plan(current_page_before, page_plan) - self.document.apply_page_plan(page_plan) + original_page_count = self.document.page_count + rotated_pages = [page for page, degrees in dialog.rotations.items() if degrees % 360] + + def operation() -> None: + for page_index, degrees in dialog.rotations.items(): + if degrees % 360: + self.document.rotate_pages([page_index], degrees) + self.document.apply_page_plan(page_plan) + + self._run_document_transaction(operation) self._refresh_document_view(target_page) kept_count = sum(1 for entry in page_plan if entry.get("source") == "current") external_count = sum(1 for entry in page_plan if entry.get("source") == "external") @@ -729,8 +1021,7 @@ class MainWindow(QMainWindow): def insert_blank_page(self) -> None: if not self._ensure_document(): return - self._flush_session_raster_objects() - new_index = self.document.insert_blank_page(self.viewer.page_index) + new_index = self._run_document_transaction(lambda: self.document.insert_blank_page(self.viewer.page_index)) self._refresh_document_view(new_index) self.statusBar().showMessage("已插入空白页,记得保存", 3000) @@ -743,9 +1034,8 @@ class MainWindow(QMainWindow): if not selected: return try: - self._flush_session_raster_objects() insert_after = self.viewer.page_index - count = self.document.insert_pdf(selected, self.viewer.page_index) + count = self._run_document_transaction(lambda: self.document.insert_pdf(selected, self.viewer.page_index)) self._refresh_document_view(insert_after + 1) self.statusBar().showMessage(f"已插入 {count} 页,记得保存", 3000) except Exception as exc: @@ -774,10 +1064,25 @@ class MainWindow(QMainWindow): if not selected.lower().endswith(".pdf"): selected += ".pdf" try: - self.document.extract_pages(page_numbers, selected) - self.statusBar().showMessage("页面已提取", 3000) + source, title = self._current_pdf_source_for_worker() except Exception as exc: - QMessageBox.critical(self, "提取失败", f"无法提取页面:\n{exc}") + QMessageBox.critical(self, "提取失败", f"无法准备 PDF 内容:\n{exc}") + return + + def task() -> str: + document = self._open_worker_document(source, title) + try: + document.extract_pages(page_numbers, selected) + finally: + document.close() + return selected + + self._start_background_task( + "提取页面", + "正在提取页面...", + task, + lambda result: self.statusBar().showMessage(f"页面已提取:{result}", 3000), + ) def split_pdf(self) -> None: if not self._ensure_document(): @@ -786,10 +1091,25 @@ class MainWindow(QMainWindow): if not folder: return try: - self.document.split_to_folder(folder) - self.statusBar().showMessage("PDF 已按页拆分", 3000) + source, title = self._current_pdf_source_for_worker() except Exception as exc: - QMessageBox.critical(self, "拆分失败", f"无法拆分 PDF:\n{exc}") + QMessageBox.critical(self, "拆分失败", f"无法准备 PDF 内容:\n{exc}") + return + + def task() -> str: + document = self._open_worker_document(source, title) + try: + document.split_to_folder(folder) + finally: + document.close() + return folder + + self._start_background_task( + "拆分 PDF", + "正在按页拆分 PDF...", + task, + lambda result: self.statusBar().showMessage(f"PDF 已拆分:{result}", 3000), + ) def merge_pdfs(self) -> None: selected_files, _ = QFileDialog.getOpenFileNames( @@ -802,11 +1122,12 @@ class MainWindow(QMainWindow): return if not target.lower().endswith(".pdf"): target += ".pdf" - try: - PdfDocument.merge_pdfs(selected_files, target) - self.statusBar().showMessage("PDF 已合并", 3000) - except Exception as exc: - QMessageBox.critical(self, "合并失败", f"无法合并 PDF:\n{exc}") + self._start_background_task( + "合并 PDF", + "正在合并 PDF...", + lambda: (PdfDocument.merge_pdfs(selected_files, target), target)[1], + lambda result: self.statusBar().showMessage(f"PDF 已合并:{result}", 3000), + ) def export_current_page_image(self) -> None: if not self._ensure_document(): @@ -819,10 +1140,26 @@ class MainWindow(QMainWindow): if not selected.lower().endswith(".png"): selected += ".png" try: - self.document.export_page_image(self.viewer.page_index, selected) - self.statusBar().showMessage("当前页已导出为图片", 3000) + source, title = self._current_pdf_source_for_worker() + page_index = self.viewer.page_index except Exception as exc: - QMessageBox.critical(self, "导出失败", f"无法导出图片:\n{exc}") + QMessageBox.critical(self, "导出失败", f"无法准备 PDF 内容:\n{exc}") + return + + def task() -> str: + document = self._open_worker_document(source, title) + try: + document.export_page_image(page_index, selected) + finally: + document.close() + return selected + + self._start_background_task( + "导出图片", + "正在导出当前页图片...", + task, + lambda result: self.statusBar().showMessage(f"当前页已导出为图片:{result}", 3000), + ) def export_pages_images(self) -> None: if not self._ensure_document(): @@ -839,10 +1176,25 @@ class MainWindow(QMainWindow): if not folder: return try: - self.document.export_pages_images(page_numbers, folder) - self.statusBar().showMessage("页面图片已导出", 3000) + source, title = self._current_pdf_source_for_worker() except Exception as exc: - QMessageBox.critical(self, "导出失败", f"无法导出图片:\n{exc}") + QMessageBox.critical(self, "导出失败", f"无法准备 PDF 内容:\n{exc}") + return + + def task() -> str: + document = self._open_worker_document(source, title) + try: + document.export_pages_images(page_numbers, folder) + finally: + document.close() + return folder + + self._start_background_task( + "批量导出图片", + "正在批量导出页面图片...", + task, + lambda result: self.statusBar().showMessage(f"页面图片已导出:{result}", 3000), + ) def images_to_pdf(self) -> None: selected_files, _ = QFileDialog.getOpenFileNames( @@ -858,11 +1210,12 @@ class MainWindow(QMainWindow): return if not target.lower().endswith(".pdf"): target += ".pdf" - try: - PdfDocument.images_to_pdf(selected_files, target) - self.statusBar().showMessage("图片已转换为 PDF", 3000) - except Exception as exc: - QMessageBox.critical(self, "转换失败", f"无法生成 PDF:\n{exc}") + self._start_background_task( + "图片转 PDF", + "正在生成 PDF...", + lambda: (PdfDocument.images_to_pdf(selected_files, target), target)[1], + lambda result: self.statusBar().showMessage(f"图片已转换为 PDF:{result}", 3000), + ) def edit_metadata(self) -> None: if not self._ensure_document(): @@ -1022,7 +1375,175 @@ class MainWindow(QMainWindow): if not self._ensure_document() or not query: self.right_tools.set_search_results_visible(False) return - matches = self.document.search(query) + if self._search_worker: + self._stop_search_worker(wait_ms=1500) + if self._search_thread and self._search_thread.isRunning(): + self.statusBar().showMessage("正在取消上一次搜索,请稍后再试。", 3000) + return + progress = QProgressDialog("正在搜索 PDF...", "取消", 0, self.document.page_count, self) + progress.setWindowTitle("搜索") + progress.setWindowModality(Qt.WindowModality.WindowModal) + progress.setMinimumDuration(300) + + def update_progress(current: int, total: int) -> None: + progress.setMaximum(total) + progress.setValue(current) + + try: + pdf_source = self._prepare_search_source() + except Exception as exc: + progress.close() + QMessageBox.critical(self, "搜索失败", f"无法准备搜索内容:\n{exc}") + return + + thread = QThread(self) + self._search_job_id += 1 + job_id = self._search_job_id + worker = SearchWorker(job_id, pdf_source, query) + worker.moveToThread(thread) + self._search_thread = thread + self._search_worker = worker + + def finish_search(finished_job_id: int, matches: list[SearchMatch]) -> None: + progress.close() + if self._search_thread is thread: + self._search_worker = None + self._search_thread = None + self._clear_search_temp_path() + if finished_job_id == self._search_job_id: + self._populate_search_results(matches) + thread.quit() + + def fail_search(failed_job_id: int, message: str) -> None: + progress.close() + if self._search_thread is thread: + self._search_worker = None + self._search_thread = None + self._clear_search_temp_path() + if failed_job_id == self._search_job_id: + QMessageBox.critical(self, "搜索失败", f"无法搜索 PDF:\n{message}") + thread.quit() + + progress.canceled.connect(worker.cancel) + thread.started.connect(worker.run) + worker.progress.connect(update_progress) + worker.finished.connect(finish_search) + worker.failed.connect(fail_search) + worker.finished.connect(worker.deleteLater) + worker.failed.connect(worker.deleteLater) + thread.finished.connect(thread.deleteLater) + thread.start() + + def _prepare_search_source(self) -> bytes | Path: + if not self.document.path: + return self.document.to_bytes() + try: + source_size = self.document.path.stat().st_size + except OSError: + source_size = 0 + if not self.document.is_dirty and source_size >= self._TRANSACTION_MEMORY_LIMIT: + return self.document.path + if self.document.is_dirty and source_size >= self._TRANSACTION_MEMORY_LIMIT: + self._clear_search_temp_path() + temp_dir = Path(QStandardPaths.writableLocation(QStandardPaths.StandardLocation.TempLocation) or ".") + temp_dir = temp_dir / "PDFReaderLite" + temp_dir.mkdir(parents=True, exist_ok=True) + with NamedTemporaryFile(delete=False, suffix=".pdf", dir=temp_dir) as tmp: + temp_path = Path(tmp.name) + self.document.save_copy(temp_path) + self._search_temp_path = temp_path + return temp_path + return self.document.to_bytes() + + def _stop_search_worker(self, wait_ms: int = 0) -> None: + worker = self._search_worker + thread = self._search_thread + if worker: + worker.cancel() + self._search_job_id += 1 + if thread and thread.isRunning() and wait_ms > 0: + thread.quit() + thread.wait(wait_ms) + if not thread or not thread.isRunning(): + self._search_worker = None + self._search_thread = None + self._clear_search_temp_path() + + def _clear_search_temp_path(self) -> None: + temp_path = self._search_temp_path + self._search_temp_path = None + if not temp_path: + return + try: + if temp_path.exists(): + temp_path.unlink() + except OSError: + logging.warning("无法删除搜索临时文件:%s", temp_path) + + def _start_background_task( + self, + title: str, + message: str, + callback: Callable[[], object], + on_success: Callable[[object], None] | None = None, + ) -> None: + self._background_job_id += 1 + job_id = self._background_job_id + progress = QProgressDialog(message, "", 0, 0, self) + progress.setWindowTitle(title) + progress.setWindowModality(Qt.WindowModality.WindowModal) + progress.setMinimumDuration(200) + progress.setCancelButton(None) + progress.show() + + thread = QThread(self) + worker = BackgroundTaskWorker(job_id, callback) + worker.moveToThread(thread) + self._background_threads.add(thread) + self._background_workers.add(worker) + + def finish_task(finished_job_id: int, result: object) -> None: + progress.close() + if finished_job_id == job_id and on_success: + on_success(result) + thread.quit() + + def fail_task(failed_job_id: int, message_text: str) -> None: + progress.close() + if failed_job_id == job_id: + QMessageBox.critical(self, title, message_text) + thread.quit() + + def cleanup_thread() -> None: + self._background_threads.discard(thread) + self._background_workers.discard(worker) + + thread.started.connect(worker.run) + worker.finished.connect(finish_task) + worker.failed.connect(fail_task) + worker.finished.connect(worker.deleteLater) + worker.failed.connect(worker.deleteLater) + thread.finished.connect(cleanup_thread) + thread.finished.connect(thread.deleteLater) + thread.start() + + def _current_pdf_source_for_worker(self) -> tuple[bytes | Path, str | None]: + if self.document.path and not self.document.is_dirty: + return self.document.path, str(self.document.path) + title = str(self.document.path) if self.document.path else None + return self.document.to_bytes(), title + + @staticmethod + def _open_worker_document(source: bytes | Path, title: str | None = None) -> PdfDocument: + document = PdfDocument() + if isinstance(source, Path): + document.open(source) + else: + document.open_bytes(source, title) + return document + + def _populate_search_results(self, matches: list[SearchMatch]) -> None: + self.search_results.clear() for match in matches: item = QListWidgetItem(f"第 {match.page_index + 1} 页 {match.text}") item.setData(Qt.ItemDataRole.UserRole, match) @@ -1675,18 +2196,18 @@ class MainWindow(QMainWindow): self.fit_width_action.triggered.connect(self.fit_width) self.fit_page_action.triggered.connect(self.fit_page) self.go_to_page_action.triggered.connect(self.go_to_page_dialog) - self.rotate_action.triggered.connect(self.rotate_page) - self.delete_action.triggered.connect(self.delete_page) - self.move_page_action.triggered.connect(self.move_page_dialog) - self.page_manager_action.triggered.connect(self.open_page_manager) - self.insert_blank_action.triggered.connect(self.insert_blank_page) - self.insert_pdf_action.triggered.connect(self.insert_pdf) - self.extract_pages_action.triggered.connect(self.extract_pages) - self.split_pdf_action.triggered.connect(self.split_pdf) - self.merge_pdfs_action.triggered.connect(self.merge_pdfs) - self.export_current_image_action.triggered.connect(self.export_current_page_image) - self.export_pages_images_action.triggered.connect(self.export_pages_images) - self.images_to_pdf_action.triggered.connect(self.images_to_pdf) + self.rotate_action.triggered.connect(lambda: self._run_ui_action("旋转页面", self.rotate_page)) + self.delete_action.triggered.connect(lambda: self._run_ui_action("删除页面", self.delete_page)) + self.move_page_action.triggered.connect(lambda: self._run_ui_action("移动页面", self.move_page_dialog)) + self.page_manager_action.triggered.connect(lambda: self._run_ui_action("页面管理", self.open_page_manager)) + self.insert_blank_action.triggered.connect(lambda: self._run_ui_action("插入空白页", self.insert_blank_page)) + self.insert_pdf_action.triggered.connect(lambda: self._run_ui_action("插入 PDF", self.insert_pdf)) + self.extract_pages_action.triggered.connect(lambda: self._run_ui_action("提取页面", self.extract_pages)) + self.split_pdf_action.triggered.connect(lambda: self._run_ui_action("拆分 PDF", self.split_pdf)) + self.merge_pdfs_action.triggered.connect(lambda: self._run_ui_action("合并 PDF", self.merge_pdfs)) + self.export_current_image_action.triggered.connect(lambda: self._run_ui_action("导出当前页图片", self.export_current_page_image)) + self.export_pages_images_action.triggered.connect(lambda: self._run_ui_action("批量导出图片", self.export_pages_images)) + self.images_to_pdf_action.triggered.connect(lambda: self._run_ui_action("图片转 PDF", self.images_to_pdf)) self.metadata_action.triggered.connect(self.edit_metadata) self.form_fill_action.triggered.connect(self.fill_form_field) self.annotation_list_action.triggered.connect(self.show_annotations) @@ -1873,6 +2394,11 @@ class MainWindow(QMainWindow): ).lower() return query in haystack + def _refresh_annotations_for_page_change(self) -> None: + self._refresh_page_object_list() + if self.annotation_current_page_only.isChecked(): + self._refresh_annotation_panel() + def _refresh_annotation_panel(self) -> None: if not hasattr(self, "right_annotation_list"): return @@ -1884,7 +2410,10 @@ class MainWindow(QMainWindow): self._refresh_page_object_list() return - annotations = self.document.annotations() + if self.annotation_current_page_only.isChecked(): + annotations = self.document.annotations(self.viewer.page_index) + else: + annotations = self.document.annotations() if not annotations: item = QListWidgetItem("当前 PDF 没有注释") item.setFlags(item.flags() & ~Qt.ItemFlag.ItemIsEnabled) @@ -2005,7 +2534,7 @@ class MainWindow(QMainWindow): self.right_object_list.addItem(item) count += 1 - for annotation in self.document.annotations(): + for annotation in self.document.annotations(page_index): if annotation.page_index != page_index: continue content = annotation.content or annotation.annotation_type @@ -3214,7 +3743,7 @@ class MainWindow(QMainWindow): rotation_input = QComboBox() for value in [0, 90, 180, 270]: - rotation_input.addItem(f"{value}掳", value) + rotation_input.addItem(f"{value}度", value) rotation_index = rotation_input.findData(int(raster.get("rotation", 0)) % 360) rotation_input.setCurrentIndex(max(0, rotation_index)) @@ -3762,7 +4291,87 @@ class MainWindow(QMainWindow): image.save(str(temp_path), "PNG") return str(temp_path) - def _flush_session_raster_objects(self) -> None: + def _run_with_raster_flush(self, save_callback) -> None: + if not self.session_raster_objects: + save_callback() + return + checkpoint = self._make_document_transaction_checkpoint() + raster_backup = [dict(item) for item in self.session_raster_objects] + try: + self._flush_session_raster_objects(clear_after=False) + save_callback() + except Exception: + self._restore_document_transaction_checkpoint(checkpoint) + self.session_raster_objects = raster_backup + self._refresh_session_raster_overlays() + self._update_current_tab_title() + raise + finally: + self._cleanup_document_transaction_checkpoint(checkpoint) + self._clear_session_raster_objects() + self._update_current_tab_title() + + def _run_document_transaction(self, callback): + checkpoint = self._make_document_transaction_checkpoint() + raster_backup = [dict(item) for item in self.session_raster_objects] + try: + self._flush_session_raster_objects() + return callback() + except Exception: + self._restore_document_transaction_checkpoint(checkpoint) + self.session_raster_objects = raster_backup + self._refresh_session_raster_overlays() + self._update_current_tab_title() + raise + finally: + self._cleanup_document_transaction_checkpoint(checkpoint) + + def _make_document_transaction_checkpoint(self) -> dict[str, object]: + dirty = self.document.is_dirty + source_size = 0 + if self.document.path and self.document.path.exists(): + try: + source_size = self.document.path.stat().st_size + except OSError: + source_size = 0 + if ( + source_size >= self._TRANSACTION_MEMORY_LIMIT + or self.document.page_count >= self._TRANSACTION_PAGE_LIMIT + ): + return self._make_file_document_transaction_checkpoint(dirty) + try: + return {"type": "memory", "data": self.document.to_bytes(), "dirty": dirty} + except MemoryError: + return self._make_file_document_transaction_checkpoint(dirty) + + def _make_file_document_transaction_checkpoint(self, dirty: bool) -> dict[str, object]: + temp_dir = Path(QStandardPaths.writableLocation(QStandardPaths.StandardLocation.TempLocation) or ".") + temp_dir = temp_dir / "PDFReaderLite" + temp_dir.mkdir(parents=True, exist_ok=True) + with NamedTemporaryFile(delete=False, suffix=".pdf", dir=temp_dir) as tmp: + backup_path = Path(tmp.name) + self.document.save_copy(backup_path) + return {"type": "file", "path": backup_path, "dirty": dirty} + + def _restore_document_transaction_checkpoint(self, checkpoint: dict[str, object]) -> None: + dirty = bool(checkpoint.get("dirty", True)) + if checkpoint.get("type") == "file": + backup_path = Path(str(checkpoint["path"])) + self.document.restore_bytes(backup_path.read_bytes(), dirty=dirty) + return + self.document.restore_bytes(bytes(checkpoint["data"]), dirty=dirty) + + def _cleanup_document_transaction_checkpoint(self, checkpoint: dict[str, object]) -> None: + if checkpoint.get("type") != "file": + return + backup_path = Path(str(checkpoint["path"])) + try: + if backup_path.exists(): + backup_path.unlink() + except OSError: + logging.warning("无法删除事务备份文件:%s", backup_path) + + def _flush_session_raster_objects(self, clear_after: bool = True) -> None: if not self.session_raster_objects: return for item in list(self.session_raster_objects): @@ -3772,8 +4381,9 @@ class MainWindow(QMainWindow): self.document.add_signature_rect(int(item["page_index"]), image_path, rect) else: self.document.insert_image_rect(int(item["page_index"]), image_path, rect) - self._clear_session_raster_objects() - self._update_current_tab_title() + if clear_after: + self._clear_session_raster_objects() + self._update_current_tab_title() def _start_placement(self, payload: dict[str, object], message: str) -> None: if not self._ensure_can_edit("点击放置"): @@ -4465,6 +5075,20 @@ class MainWindow(QMainWindow): def log_dir(self) -> Path: return Path(QStandardPaths.writableLocation(QStandardPaths.StandardLocation.AppDataLocation)) + def _cleanup_temp_raster_files(self) -> None: + temp_root = Path(QStandardPaths.writableLocation(QStandardPaths.StandardLocation.TempLocation) or ".") + temp_dir = temp_root / "PDFReaderLite" + if not temp_dir.exists(): + return + cutoff = datetime.now() - timedelta(days=2) + for path in temp_dir.glob("raster_*.png"): + try: + modified = datetime.fromtimestamp(path.stat().st_mtime) + if modified < cutoff: + path.unlink() + except OSError: + continue + def open_log_dir(self) -> None: log_dir = self.log_dir() log_dir.mkdir(parents=True, exist_ok=True) @@ -4534,7 +5158,6 @@ class MainWindow(QMainWindow): self._update_current_tab_title() self._sync_zoom_controls(self.viewer.zoom) self._sync_page_controls() - self._refresh_annotation_panel() self._sync_mode_status() if not self.document.is_open: self.statusBar().showMessage("就绪") diff --git a/pdfreaderlite/ui/page_manager.py b/pdfreaderlite/ui/page_manager.py index 84bb518..862b193 100644 --- a/pdfreaderlite/ui/page_manager.py +++ b/pdfreaderlite/ui/page_manager.py @@ -3,7 +3,7 @@ from __future__ import annotations from pathlib import Path import fitz -from PySide6.QtCore import QSize, Qt, Signal +from PySide6.QtCore import QSize, Qt, QTimer, Signal from PySide6.QtGui import QDragEnterEvent, QDropEvent, QIcon, QImage, QPixmap from PySide6.QtWidgets import ( QAbstractItemView, @@ -91,6 +91,10 @@ class PageManagerDialog(QDialog): super().__init__(parent) self.document = document self.rotations: dict[int, int] = {} + self._thumbnail_queue: list[QListWidgetItem] = [] + self._external_thumbnail_docs: dict[str, fitz.Document] = {} + self._thumbnail_timer = QTimer(self) + self._thumbnail_timer.timeout.connect(self._render_next_thumbnail) self.setWindowTitle("页面管理") self.resize(920, 680) @@ -129,6 +133,19 @@ class PageManagerDialog(QDialog): self._load_pages() + def closeEvent(self, event) -> None: + self._stop_thumbnail_rendering() + super().closeEvent(event) + + def done(self, result: int) -> None: + self._stop_thumbnail_rendering() + super().done(result) + + def _stop_thumbnail_rendering(self) -> None: + self._thumbnail_timer.stop() + self._thumbnail_queue.clear() + self._close_external_thumbnail_docs() + def page_order(self) -> list[int]: return [ self.grid.item(row).data(Qt.ItemDataRole.UserRole) @@ -180,13 +197,15 @@ class PageManagerDialog(QDialog): try: with fitz.open(path) as source: for page_index in range(source.page_count): - item = self._external_page_item(path, source, page_index) + item = self._external_page_item(path, page_index) self.grid.insertItem(row + inserted, item) + self._thumbnail_queue.append(item) inserted += 1 except Exception as exc: QMessageBox.warning(self, "插入 PDF", f"无法读取外部 PDF:\n{path}\n\n{exc}") if inserted: self.grid._renumber_items() + self._thumbnail_timer.start(15) def rotate_selected_pages(self, degrees: int) -> None: pages = self.selected_pages() @@ -227,16 +246,41 @@ class PageManagerDialog(QDialog): def _load_pages(self) -> None: for page_index in range(self.document.page_count): - image = self.document.render_thumbnail(page_index, width=150) item = QListWidgetItem( - QIcon(QPixmap.fromImage(image)), + QIcon(), f"位置 {page_index + 1}\n原第 {page_index + 1} 页", ) item.setData(Qt.ItemDataRole.UserRole, page_index) item.setTextAlignment(Qt.AlignmentFlag.AlignCenter) self.grid.addItem(item) + self._thumbnail_queue.append(item) + if self._thumbnail_queue: + self._thumbnail_timer.start(15) - def _external_page_item(self, path: str, source: fitz.Document, page_index: int) -> QListWidgetItem: + def _render_next_thumbnail(self) -> None: + if not self._thumbnail_queue: + self._thumbnail_timer.stop() + return + item = self._thumbnail_queue.pop(0) + if self.grid.row(item) < 0: + return + entry = item.data(Qt.ItemDataRole.UserRole) + try: + if isinstance(entry, int): + image = self.document.render_thumbnail(entry, width=150) + elif isinstance(entry, dict) and entry.get("source") == "external": + image = self._render_external_thumbnail(str(entry["path"]), int(entry["page_index"])) + else: + return + except Exception: + return + item.setIcon(QIcon(QPixmap.fromImage(image))) + + def _render_external_thumbnail(self, path: str, page_index: int) -> QImage: + source = self._external_thumbnail_docs.get(path) + if source is None: + source = fitz.open(path) + self._external_thumbnail_docs[path] = source page = source.load_page(page_index) zoom = 150 / page.rect.width pixmap = page.get_pixmap(matrix=fitz.Matrix(zoom, zoom), alpha=False) @@ -247,8 +291,19 @@ class PageManagerDialog(QDialog): pixmap.stride, QImage.Format.Format_RGB888, ).copy() + return image + + def _close_external_thumbnail_docs(self) -> None: + for source in self._external_thumbnail_docs.values(): + try: + source.close() + except Exception: + pass + self._external_thumbnail_docs.clear() + + def _external_page_item(self, path: str, page_index: int) -> QListWidgetItem: item = QListWidgetItem( - QIcon(QPixmap.fromImage(image)), + QIcon(), f"插入 {Path(path).name}\n第 {page_index + 1} 页", ) item.setData( diff --git a/pdfreaderlite/ui/pdf_viewer.py b/pdfreaderlite/ui/pdf_viewer.py index d06c59e..666f43c 100644 --- a/pdfreaderlite/ui/pdf_viewer.py +++ b/pdfreaderlite/ui/pdf_viewer.py @@ -1,12 +1,49 @@ from __future__ import annotations -from PySide6.QtCore import QPoint, QPointF, QRectF, Qt, QTimer, Signal -from PySide6.QtGui import QColor, QContextMenuEvent, QMouseEvent, QPainter, QPen, QPixmap, QWheelEvent +from bisect import bisect_left, bisect_right +from pathlib import Path + +import fitz +from PySide6.QtCore import QObject, QElapsedTimer, QPoint, QPointF, QRectF, Qt, QThread, QTimer, Signal +from PySide6.QtGui import QColor, QContextMenuEvent, QImage, QMouseEvent, QPainter, QPen, QPixmap, QWheelEvent from PySide6.QtWidgets import QGraphicsDropShadowEffect, QLabel, QScrollArea, QSizePolicy, QVBoxLayout, QWidget from pdfreaderlite.core.document import PdfDocument +class PageRenderWorker(QObject): + finished = Signal(int, int, int, float, QImage) + failed = Signal(int, int, int, str) + + def __init__(self, generation: int, request_id: int, source: bytes | Path, page_index: int, zoom: float) -> None: + super().__init__() + self.generation = generation + self.request_id = request_id + self.source = source + self.page_index = page_index + self.zoom = zoom + + def run(self) -> None: + try: + if isinstance(self.source, Path): + document = fitz.open(self.source) + else: + document = fitz.open("pdf", self.source) + with document: + page = document.load_page(self.page_index) + pixmap = page.get_pixmap(matrix=fitz.Matrix(self.zoom, self.zoom), alpha=False) + image = QImage( + pixmap.samples, + pixmap.width, + pixmap.height, + pixmap.stride, + QImage.Format.Format_RGB888, + ).copy() + self.finished.emit(self.generation, self.request_id, self.page_index, self.zoom, image) + except Exception as exc: + self.failed.emit(self.generation, self.request_id, self.page_index, str(exc)) + + class PageLabel(QLabel): stroke_finished = Signal(list) placement_requested = Signal(QPointF) @@ -37,6 +74,7 @@ class PageLabel(QLabel): self.selected_rect: QRectF | None = None self.selected_rects: list[QRectF] = [] self.overlay_images: list[dict[str, object]] = [] + self._overlay_pixmap_cache: dict[tuple[str, int], QPixmap] = {} self.search_highlights: list[tuple[float, float, float, float]] = [] self.text_selection_highlights: list[tuple[float, float, float, float]] = [] self._drawing = False @@ -54,6 +92,8 @@ class PageLabel(QLabel): self._drag_start = QPointF() self._drag_origin_rect = QRectF() self._hand_last_pos = QPointF() + self._text_preview_timer = QElapsedTimer() + self._text_preview_timer.start() def mousePressEvent(self, event: QMouseEvent) -> None: if self.hand_pan_enabled and event.button() == Qt.MouseButton.LeftButton: @@ -152,7 +192,9 @@ class PageLabel(QLabel): 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()) + if self._text_preview_timer.elapsed() >= 70: + self._text_preview_timer.restart() + self.text_selection_preview_changed.emit(self._area_rect, self._area_start, event.position()) self.update() return if self._placing_shape: @@ -222,7 +264,7 @@ class PageLabel(QLabel): painter = QPainter(self) painter.setRenderHint(QPainter.RenderHint.Antialiasing) for overlay in self.overlay_images: - pixmap = QPixmap(str(overlay["path"])) + pixmap = self._overlay_pixmap(str(overlay["path"])) if pixmap.isNull(): continue x0, y0, x1, y1 = overlay["rect"] @@ -267,6 +309,20 @@ class PageLabel(QLabel): else: painter.drawRect(rect) + def _overlay_pixmap(self, path: str) -> QPixmap: + try: + mtime = Path(path).stat().st_mtime_ns + except OSError: + return QPixmap() + cache_key = (path, mtime) + pixmap = self._overlay_pixmap_cache.get(cache_key) + if pixmap is None: + pixmap = QPixmap(path) + if not pixmap.isNull(): + self._overlay_pixmap_cache.clear() + self._overlay_pixmap_cache[cache_key] = pixmap + return pixmap + def _resize_handle_rect(self) -> QRectF: if not self.selected_rect: return QRectF() @@ -337,6 +393,34 @@ class PdfViewer(QScrollArea): self._selected_object_rects: list[tuple[float, float, float, float]] = [] self._selected_object_page_index: int | None = None self._updating_scroll_page = False + self._rendered_pages: set[int] = set() + self._queued_render_pages: set[int] = set() + self._render_queue: list[int] = [] + self._render_threads: set[QThread] = set() + self._render_workers: set[PageRenderWorker] = set() + self._render_busy = False + self._render_request_id = 0 + self._render_source_revision: int | None = None + self._render_source: bytes | Path | None = None + self._render_generation = 0 + self._scroll_generation = 0 + self._page_position_token = 0 + self._page_position_cache_token = -1 + self._page_tops: list[int] = [] + self._page_bottoms: list[int] = [] + self._page_centers: list[int] = [] + self._lazy_render_timer = QTimer(self) + self._lazy_render_timer.setSingleShot(True) + self._lazy_render_timer.timeout.connect(self._render_visible_pages) + self._hover_timer = QTimer(self) + self._hover_timer.setSingleShot(True) + self._hover_timer.timeout.connect(self._emit_pending_annotation_hover) + self._pending_annotation_hover: tuple[int, QPointF] | None = None + self._zoom_render_timer = QTimer(self) + self._zoom_render_timer.setSingleShot(True) + self._zoom_render_timer.timeout.connect(self._apply_pending_zoom_render) + self._pending_zoom_anchor: tuple[int, float, float] | None = None + self._pending_zoom_viewport_point: QPointF | None = None self.content_widget = QWidget() self.content_widget.setObjectName("pdfContinuousContent") @@ -355,10 +439,23 @@ class PdfViewer(QScrollArea): self.verticalScrollBar().valueChanged.connect(self._update_current_page_from_scroll) def set_document(self, document: PdfDocument) -> None: + self._invalidate_async_render_state() self.document = document self.page_index = 0 self.render() + def closeEvent(self, event) -> None: + self.stop_async_render() + super().closeEvent(event) + + def stop_async_render(self, wait_ms: int = 2000) -> None: + self._invalidate_async_render_state() + self._render_busy = False + for thread in list(self._render_threads): + if thread.isRunning(): + thread.quit() + thread.wait(wait_ms) + def render(self, scroll_to_page: bool = True) -> None: if not self.document or not self.document.is_open: self._clear_page_labels() @@ -367,18 +464,25 @@ class PdfViewer(QScrollArea): return previous_page = min(self.page_index, self.document.page_count - 1) + self._render_generation += 1 + generation = self._render_generation + self._rendered_pages.clear() + self._queued_render_pages.clear() + self._render_queue.clear() + self._prepare_render_source() 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) - image = self.document.render_page(page_index, self.zoom) - label.setPixmap(QPixmap.fromImage(image)) - label.adjustSize() + self._apply_page_placeholder(label, page_index) self._page_labels.append(label) self.content_layout.addWidget(label) + self._invalidate_page_position_cache() self.page_index = previous_page self.page_label = self._page_labels[self.page_index] + for page_index in self._initial_render_pages(self.page_index): + self._render_page_label(page_index) self.content_layout.activate() self.content_widget.adjustSize() self._refresh_overlay_zoom() @@ -389,6 +493,7 @@ class PdfViewer(QScrollArea): self._scroll_to_page(self.page_index) else: QTimer.singleShot(0, self._finish_programmatic_scroll) + QTimer.singleShot(0, lambda saved_generation=generation: self._render_visible_pages(saved_generation)) self.page_changed.emit(self.page_index) self.zoom_changed.emit(self.zoom) @@ -413,9 +518,7 @@ class PdfViewer(QScrollArea): 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._render_page_label(page_index, force=True) self.page_index = page_index self.page_label = label self.content_layout.activate() @@ -442,13 +545,13 @@ class PdfViewer(QScrollArea): self._scroll_to_page(page_index) self.page_changed.emit(self.page_index) - def zoom_in(self) -> None: - self.set_zoom(min(3.0, self.zoom + 0.15)) + def zoom_in(self, viewport_anchor: QPointF | None = None) -> None: + self.set_zoom(min(3.0, self.zoom + 0.15), viewport_anchor) - def zoom_out(self) -> None: - self.set_zoom(max(0.2, self.zoom - 0.15)) + def zoom_out(self, viewport_anchor: QPointF | None = None) -> None: + self.set_zoom(max(0.2, self.zoom - 0.15), viewport_anchor) - def set_zoom(self, zoom: float) -> None: + def set_zoom(self, zoom: float, viewport_anchor: QPointF | None = None) -> None: new_zoom = max(0.2, min(3.0, zoom)) if abs(new_zoom - self.zoom) < 0.001: return @@ -457,31 +560,66 @@ class PdfViewer(QScrollArea): self.render() return - anchor = self._viewport_pdf_anchor() - if anchor is not None: - self.page_index = anchor[0] + anchor = self._viewport_pdf_anchor(viewport_anchor) + if anchor is None or anchor[0] != self.page_index: + anchor = self._current_page_pdf_anchor() + viewport_anchor = None self.zoom = new_zoom + self._pending_zoom_anchor = anchor + self._pending_zoom_viewport_point = QPointF(viewport_anchor) if viewport_anchor is not None else None + self.zoom_changed.emit(self.zoom) + if self._zoom_render_timer.isActive(): + self._zoom_render_timer.stop() + self._zoom_render_timer.start(70) + + def _apply_pending_zoom_render(self) -> None: + if not self.document or not self.document.is_open: + return + anchor = self._pending_zoom_anchor + viewport_point = self._pending_zoom_viewport_point + if anchor is not None: + self.page_index = anchor[0] 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)) + self._restore_pdf_anchor(anchor, viewport_point) + QTimer.singleShot( + 0, + lambda saved_anchor=anchor, saved_point=viewport_point: self._restore_pdf_anchor(saved_anchor, saved_point), + ) + self._pending_zoom_anchor = None + self._pending_zoom_viewport_point = None + + def _current_page_pdf_anchor(self) -> tuple[int, float, float] | None: + if not self.document or not self.document.is_open: + return None + if self.page_index < 0 or self.page_index >= self.document.page_count: + return None + x0, y0, x1, y1 = self.document.page_rect(self.page_index) + return ( + self.page_index, + (x1 - x0) / 2, + (y1 - y0) / 2, + ) def wheelEvent(self, event: QWheelEvent) -> None: if event.modifiers() & Qt.KeyboardModifier.ControlModifier: + anchor = QPointF(event.position()) if event.angleDelta().y() > 0: - self.zoom_in() + self.zoom_in(anchor) else: - self.zoom_out() + self.zoom_out(anchor) event.accept() return super().wheelEvent(event) - def _viewport_pdf_anchor(self) -> tuple[int, float, float] | None: + def _viewport_pdf_anchor(self, viewport_point: QPointF | None = None) -> 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)) + if viewport_point is None: + viewport_point = QPointF(self.viewport().width() / 2, self.viewport().height() / 2) + viewport_pos = QPoint(int(viewport_point.x()), int(viewport_point.y())) + content_point = self.content_widget.mapFromGlobal(self.viewport().mapToGlobal(viewport_pos)) best_index = self.page_index best_distance: int | None = None @@ -503,7 +641,7 @@ class PdfViewer(QScrollArea): return best_index, local_x / self.zoom, local_y / self.zoom return None - def _restore_pdf_anchor(self, anchor: tuple[int, float, float]) -> None: + def _restore_pdf_anchor(self, anchor: tuple[int, float, float], viewport_point: QPointF | None = None) -> None: page_index, pdf_x, pdf_y = anchor if not (0 <= page_index < len(self._page_labels)): self._finish_programmatic_scroll() @@ -512,8 +650,10 @@ class PdfViewer(QScrollArea): 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 + anchor_x = viewport_point.x() if viewport_point is not None else self.viewport().width() / 2 + anchor_y = viewport_point.y() if viewport_point is not None else self.viewport().height() / 2 + target_x = geometry.x() + pdf_x * self.zoom - anchor_x + target_y = geometry.y() + pdf_y * self.zoom - anchor_y hbar = self.horizontalScrollBar() vbar = self.verticalScrollBar() hbar.setValue(max(hbar.minimum(), min(hbar.maximum(), int(target_x)))) @@ -737,6 +877,137 @@ class PdfViewer(QScrollArea): self._connect_page_label(label, page_index) return label + def _apply_page_placeholder(self, label: PageLabel, page_index: int) -> None: + if not self.document: + return + x0, y0, x1, y1 = self.document.page_rect(page_index) + width = max(1, int((x1 - x0) * self.zoom)) + height = max(1, int((y1 - y0) * self.zoom)) + label.clear() + label.setText("") + label.setFixedSize(width, height) + + def _initial_render_pages(self, center_page: int) -> list[int]: + if not self.document: + return [] + first = max(0, center_page - 1) + last = min(self.document.page_count - 1, center_page + 1) + return list(range(first, last + 1)) + + def _invalidate_async_render_state(self) -> None: + self._render_queue.clear() + self._queued_render_pages.clear() + self._rendered_pages.clear() + self._render_source_revision = None + self._render_source = None + self._render_generation += 1 + + def _prepare_render_source(self) -> None: + if not self.document or not self.document.is_open: + self._render_source = None + self._render_source_revision = None + return + if self._render_source_revision == self.document.revision and self._render_source is not None: + return + self._render_source_revision = self.document.revision + if self.document.path and not self.document.is_dirty: + self._render_source = self.document.path + else: + self._render_source = self.document.to_bytes() + + def _render_page_label(self, page_index: int, force: bool = False) -> None: + if ( + not self.document + or not self.document.is_open + or page_index < 0 + or page_index >= len(self._page_labels) + ): + return + if not force and page_index in self._rendered_pages: + return + if force: + self._rendered_pages.discard(page_index) + if not self._render_source: + self._render_page_label_sync(page_index) + return + if page_index in self._queued_render_pages: + return + self._queued_render_pages.add(page_index) + self._render_queue.append(page_index) + self._start_next_page_render() + + def _render_page_label_sync(self, page_index: int) -> None: + if not self.document or not self.document.is_open or page_index >= len(self._page_labels): + return + label = self._page_labels[page_index] + image = self.document.render_page(page_index, self.zoom) + label.setPixmap(QPixmap.fromImage(image)) + label.adjustSize() + self._rendered_pages.add(page_index) + self._invalidate_page_position_cache() + + def _start_next_page_render(self) -> None: + if self._render_busy or not self._render_queue or not self._render_source: + return + while self._render_queue: + page_index = self._render_queue.pop(0) + if page_index not in self._rendered_pages and 0 <= page_index < len(self._page_labels): + break + self._queued_render_pages.discard(page_index) + else: + return + self._render_busy = True + self._render_request_id += 1 + request_id = self._render_request_id + thread = QThread(self) + worker = PageRenderWorker(self._render_generation, request_id, self._render_source, page_index, self.zoom) + worker.moveToThread(thread) + self._render_threads.add(thread) + self._render_workers.add(worker) + + def finish_render(generation: int, finished_request_id: int, rendered_page: int, zoom: float, image: QImage) -> None: + self._render_busy = False + self._queued_render_pages.discard(rendered_page) + if ( + generation == self._render_generation + and finished_request_id <= self._render_request_id + and abs(zoom - self.zoom) < 0.0001 + and 0 <= rendered_page < len(self._page_labels) + ): + label = self._page_labels[rendered_page] + label.setPixmap(QPixmap.fromImage(image)) + label.adjustSize() + self._rendered_pages.add(rendered_page) + self._invalidate_page_position_cache() + thread.quit() + QTimer.singleShot(0, self._start_next_page_render) + + def fail_render(generation: int, failed_request_id: int, failed_page: int, _message: str) -> None: + self._render_busy = False + self._queued_render_pages.discard(failed_page) + if generation == self._render_generation and failed_request_id <= self._render_request_id: + self._render_page_label_sync(failed_page) + thread.quit() + QTimer.singleShot(0, self._start_next_page_render) + + def cleanup_thread() -> None: + self._render_threads.discard(thread) + self._render_workers.discard(worker) + + thread.started.connect(worker.run) + worker.finished.connect(finish_render) + worker.failed.connect(fail_render) + worker.finished.connect(worker.deleteLater) + worker.failed.connect(worker.deleteLater) + thread.finished.connect(cleanup_thread) + thread.finished.connect(thread.deleteLater) + thread.start() + + def _schedule_visible_render(self) -> None: + if self._lazy_render_timer.isActive(): + self._lazy_render_timer.stop() + self._lazy_render_timer.start(80) + def _apply_page_shadow(self, label: PageLabel) -> None: shadow = QGraphicsDropShadowEffect(label) shadow.setBlurRadius(22) @@ -775,17 +1046,32 @@ class PdfViewer(QScrollArea): widget = item.widget() if widget: widget.setParent(None) + widget.deleteLater() self._page_labels.clear() def _scroll_to_page(self, page_index: int) -> None: if not self._page_labels or page_index < 0 or page_index >= len(self._page_labels): return + self._scroll_generation += 1 self._updating_scroll_page = True 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: + generation = self._render_generation + scroll_generation = self._scroll_generation + self._apply_scroll_to_page_generation(page_index, attempts, generation, scroll_generation) + + def _apply_scroll_to_page_generation( + self, + page_index: int, + attempts: int, + generation: int, + scroll_generation: int, + ) -> None: + if generation != self._render_generation or scroll_generation != self._scroll_generation: + return if not self._page_labels or page_index < 0 or page_index >= len(self._page_labels): self._finish_programmatic_scroll() return @@ -795,29 +1081,76 @@ class PdfViewer(QScrollArea): 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)) + QTimer.singleShot( + 0, + lambda: self._apply_scroll_to_page_generation( + page_index, + attempts - 1, + generation, + scroll_generation, + ), + ) else: QTimer.singleShot(0, self._finish_programmatic_scroll) def _finish_programmatic_scroll(self) -> None: self._updating_scroll_page = False + def _invalidate_page_position_cache(self) -> None: + self._page_position_token += 1 + + def _page_positions(self) -> tuple[list[int], list[int], list[int]]: + if self._page_position_cache_token == self._page_position_token: + return self._page_tops, self._page_bottoms, self._page_centers + self._page_tops = [] + self._page_bottoms = [] + self._page_centers = [] + for label in self._page_labels: + geometry = label.geometry() + self._page_tops.append(geometry.top()) + self._page_bottoms.append(geometry.bottom()) + self._page_centers.append(geometry.center().y()) + self._page_position_cache_token = self._page_position_token + return self._page_tops, self._page_bottoms, self._page_centers + def _update_current_page_from_scroll(self) -> None: if self._updating_scroll_page or not self._page_labels: return viewport_center = QPoint(self.viewport().width() // 2, self.viewport().height() // 2) content_point = self.content_widget.mapFromGlobal(self.viewport().mapToGlobal(viewport_center)) - closest_index = self.page_index - closest_distance = None - for index, label in enumerate(self._page_labels): - distance = abs(label.geometry().center().y() - content_point.y()) - if closest_distance is None or distance < closest_distance: - closest_distance = distance - closest_index = index + _tops, _bottoms, centers = self._page_positions() + if not centers: + return + insert_at = bisect_left(centers, content_point.y()) + candidates = [index for index in (insert_at - 1, insert_at) if 0 <= index < len(centers)] + closest_index = min(candidates or [self.page_index], key=lambda index: abs(centers[index] - content_point.y())) if closest_index != self.page_index: self.page_index = closest_index self.page_label = self._page_labels[closest_index] self.page_changed.emit(self.page_index) + self._schedule_visible_render() + + def _render_visible_pages(self, generation: int | None = None) -> None: + if generation is not None and generation != self._render_generation: + return + if not self.document or not self.document.is_open or not self._page_labels: + return + viewport_rect = self.viewport().rect() + top_left = self.content_widget.mapFromGlobal(self.viewport().mapToGlobal(viewport_rect.topLeft())) + bottom_right = self.content_widget.mapFromGlobal(self.viewport().mapToGlobal(viewport_rect.bottomRight())) + visible_top = min(top_left.y(), bottom_right.y()) + visible_bottom = max(top_left.y(), bottom_right.y()) + tops, bottoms, _centers = self._page_positions() + if not tops or not bottoms: + return + margin = max(240, self.viewport().height()) + first = max(0, bisect_left(bottoms, visible_top - margin)) + last = min(len(tops), bisect_right(tops, visible_bottom + margin)) + pages = list(range(first, last)) + if not pages: + pages = self._initial_render_pages(self.page_index) + for page_index in pages: + self._render_page_label(page_index) def _refresh_overlay_zoom(self) -> None: for page_index, label in enumerate(self._labels()): @@ -881,6 +1214,8 @@ class PdfViewer(QScrollArea): label.update() def _set_current_page_from_interaction(self, page_index: int) -> None: + if page_index < 0 or page_index >= len(self._page_labels): + return if page_index != self.page_index: self.page_index = page_index if self._page_labels: @@ -1004,4 +1339,14 @@ class PdfViewer(QScrollArea): 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._pending_annotation_hover = (page_index, QPointF(point)) + if self._hover_timer.isActive(): + self._hover_timer.stop() + self._hover_timer.start(240) + + def _emit_pending_annotation_hover(self) -> None: + if not self._pending_annotation_hover: + return + page_index, point = self._pending_annotation_hover + self._pending_annotation_hover = None self.annotation_hover_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom)) diff --git a/pdfreaderlite/ui/sidebar.py b/pdfreaderlite/ui/sidebar.py index 191fdf2..2af1de8 100644 --- a/pdfreaderlite/ui/sidebar.py +++ b/pdfreaderlite/ui/sidebar.py @@ -138,8 +138,10 @@ class ThumbnailList(QListWidget): self.page_selected.emit(page_index) def _render_next_thumbnail(self) -> None: - if not self.document or not self._thumbnail_queue: + if not self.document or not self.document.is_open or not self._thumbnail_queue: self._thumbnail_timer.stop() + self._thumbnail_queue.clear() + self._queued_pages.clear() return page_index = self._thumbnail_queue.popleft() diff --git a/pyproject.toml b/pyproject.toml index 4fe60de..3d3d411 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,7 +1,7 @@ [project] name = "PDFReaderLite" -version = "0.2.2" -description = "A lightweight Windows PDF reader and editor inspired by common Adobe Acrobat workflows." +version = "0.2.3" +description = "面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,参考 Adobe Acrobat 常用工作流。" requires-python = ">=3.10" dependencies = [ "PySide6>=6.7", diff --git a/scripts/stability_regression_test.py b/scripts/stability_regression_test.py new file mode 100644 index 0000000..6867423 --- /dev/null +++ b/scripts/stability_regression_test.py @@ -0,0 +1,487 @@ +from __future__ import annotations + +import os +import shutil +import sys +import tempfile +from pathlib import Path + +os.environ.setdefault("QT_QPA_PLATFORM", "offscreen") + +import fitz +from PySide6.QtCore import QEventLoop, QSettings, QThread, QTimer +from PySide6.QtWidgets import QApplication + +PROJECT_ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(PROJECT_ROOT)) + +from pdfreaderlite.core.document import PdfDocument +from pdfreaderlite.ui.main_window import MainWindow, OpenPdfWorker +from pdfreaderlite.ui.page_manager import PageManagerDialog + + +def create_multi_page_pdf(path: Path, page_count: int = 5) -> None: + doc = fitz.open() + try: + for page_index in range(page_count): + page = doc.new_page(width=420, height=560) + page.insert_text((72, 72), f"Page {page_index + 1}") + page.insert_text((72, 120), "left column alpha beta gamma") + page.insert_text((250, 120), "right column delta epsilon zeta") + doc.save(path) + finally: + doc.close() + + +def create_line_number_pdf(path: Path) -> None: + doc = fitz.open() + try: + page = doc.new_page(width=420, height=560) + for line in range(1, 8): + y = 72 + line * 22 + page.insert_text((18, y), str(line)) + page.insert_text((64, y), f"body text line {line} selectable content") + page.insert_text((150, 260), "WATERMARK") + doc.save(path) + finally: + doc.close() + + +def assert_save_failure_keeps_document_open(path: Path, temp_dir: Path) -> None: + document = PdfDocument() + document.open(path) + document.add_note(0, "dirty note") + assert document.is_dirty + invalid_target = temp_dir / "target_is_directory" + invalid_target.mkdir() + try: + document.save_as(invalid_target) + except Exception: + pass + else: + raise AssertionError("save_as should fail when target is a directory") + assert document.is_open + assert document.is_dirty + assert document.render_page(0, 0.5).width() > 0 + document.save_as(temp_dir / "recovered.pdf") + assert not document.is_dirty + document.close() + + +def assert_repeated_save_keeps_file_unlocked(path: Path) -> None: + document = PdfDocument() + document.open(path) + document.add_note(0, "first") + document.save() + document.add_note(0, "second") + document.save() + assert document.is_open + assert not document.is_dirty + document.close() + + +def assert_render_cache_respects_memory_limit(path: Path) -> None: + document = PdfDocument() + document.open(path) + original_limit = document._MAX_RENDER_CACHE_BYTES + try: + document._MAX_RENDER_CACHE_BYTES = 1 + image = document.render_page(0, 1.0) + assert image.width() > 0 + assert document._render_cache_bytes <= document._MAX_RENDER_CACHE_BYTES + assert len(document._render_cache) == 0 + finally: + document._MAX_RENDER_CACHE_BYTES = original_limit + document.close() + + +def assert_large_snapshot_is_skipped(path: Path) -> None: + document = PdfDocument() + document.open(path) + original_limit = document._MAX_SNAPSHOT_BYTES + try: + document._MAX_SNAPSHOT_BYTES = 1 + document.add_note(0, "large snapshot skip") + assert not document.can_undo() + finally: + document._MAX_SNAPSHOT_BYTES = original_limit + document.close() + + +def assert_save_avoids_memory_backup(path: Path, temp_dir: Path) -> None: + document = PdfDocument() + document.open(path) + document.add_note(0, "no memory backup") + document.to_bytes = lambda: (_ for _ in ()).throw( + AssertionError("save_as should not require an in-memory recovery copy") + ) + document.save_as(temp_dir / "saved_without_memory_backup.pdf") + assert document.is_open + assert not document.is_dirty + document.close() + + +def assert_text_selection_stays_in_column(path: Path) -> None: + document = PdfDocument() + document.open(path) + text, _rects = document.text_selection(0, (60, 105, 220, 145), (70, 115), (210, 135)) + assert "left column" in text + assert "right column" not in text + document.close() + + +def assert_line_numbers_are_filtered(path: Path) -> None: + document = PdfDocument() + document.open(path) + text, _rects = document.text_selection(0, (10, 80, 330, 160), (12, 80), (330, 160)) + assert "body text line" in text + assert "\n1\n" not in f"\n{text}\n" + assert "WATERMARK" not in text + document.close() + + +def assert_annotation_editing_is_stable(path: Path) -> None: + document = PdfDocument() + document.open(path) + text, rects = document.text_selection(0, (60, 105, 220, 145), (70, 115), (210, 135)) + assert text and rects + markup = document.add_text_markup(0, rects, "highlight", content="review") + assert markup is not None + recolored = document.update_text_markup_color(0, markup.xref, (1.0, 0.45, 0.0)) + assert recolored is not None + freetext = document.add_text(0, "old") + edited = document.update_freetext_annotation(0, freetext.xref, "new", 16, (0.1, 0.2, 0.3)) + assert edited is not None and edited.content == "new" + document.save() + document.close() + + reopened = PdfDocument() + reopened.open(path) + annotations = reopened.annotations() + assert any(item.content == "review" for item in annotations) + assert any(item.content == "new" for item in annotations) + reopened.close() + + +def assert_open_bytes_and_annotation_cache_are_stable(path: Path) -> None: + document = PdfDocument() + document.open_bytes(path.read_bytes(), path) + first = document.annotations() + second = document.annotations() + assert first == second + document.add_note(0, "cache invalidation") + updated = document.annotations() + assert len(updated) >= len(first) + 1 + assert any(item.content == "cache invalidation" for item in updated) + document.close() + + +def assert_page_operations_keep_view(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + window = MainWindow() + try: + window.open_file(path) + window.viewer.go_to_page(2) + app.processEvents() + window.viewer.set_zoom(1.6) + app.processEvents() + assert window.viewer.page_index == 2 + window.rotate_page() + app.processEvents() + assert window.viewer.page_index == 2 + window.insert_blank_page() + app.processEvents() + assert window.viewer.page_index == 3 + finally: + for session in list(window.sessions): + session.document.close() + window.close() + + +def assert_async_viewer_render_finishes(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + window = MainWindow() + try: + window.open_file(path) + for _ in range(160): + if window.viewer._rendered_pages: + break + loop = QEventLoop() + QTimer.singleShot(10, loop.quit) + loop.exec() + app.processEvents() + assert window.viewer._rendered_pages + finally: + window.viewer.stop_async_render() + for session in list(window.sessions): + session.document.close() + window.close() + + +def assert_background_open_large_pdf(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + window = MainWindow() + thread = QThread() + worker = OpenPdfWorker(1, path) + result: dict[str, object] = {} + try: + worker.moveToThread(thread) + + def finish_open(job_id: int, data: bytes, file_path: str, password: str) -> None: + result["data"] = data + result["file_path"] = file_path + result["password"] = password + thread.quit() + + def fail_open(_job_id: int, message: str) -> None: + result["error"] = message + thread.quit() + + thread.started.connect(worker.run) + worker.finished.connect(finish_open) + worker.failed.connect(fail_open) + worker.encrypted.connect(lambda _job_id: result.setdefault("encrypted", True)) + worker.encrypted.connect(thread.quit) + thread.start() + for _ in range(200): + if not thread.isRunning(): + break + loop = QEventLoop() + QTimer.singleShot(10, loop.quit) + loop.exec() + app.processEvents() + assert not thread.isRunning() + assert "error" not in result + assert not result.get("encrypted") + data = result.get("data") + assert isinstance(data, bytes) and data + window._apply_opened_pdf( + window.sessions[window.active_session_index], + data, + Path(str(result["file_path"])), + str(result.get("password") or "") or None, + ) + assert window.document.is_open + assert window.document.page_count > 0 + app.processEvents() + finally: + if thread.isRunning(): + thread.quit() + thread.wait(1000) + worker.deleteLater() + thread.deleteLater() + for session in list(window.sessions): + session.viewer.stop_async_render() + session.document.close() + window.close() + + +def assert_missing_raster_fails_before_mutation(path: Path) -> None: + document = PdfDocument() + document.open(path) + try: + document.insert_image_rect(0, path.parent / "missing.png", (72, 72, 140, 120)) + except FileNotFoundError: + pass + else: + raise AssertionError("missing image should fail before mutating the PDF") + assert not document.can_undo() + document.save() + document.close() + + +def assert_background_search_returns_results(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + window = MainWindow() + try: + window.open_file(path) + window._TRANSACTION_MEMORY_LIMIT = 1 + window.search_box.setText("left column") + window.search() + for _ in range(100): + if window._search_worker is None: + break + loop = QEventLoop() + QTimer.singleShot(10, loop.quit) + loop.exec() + app.processEvents() + assert window._search_worker is None + assert window.search_results.count() > 0 + finally: + for session in list(window.sessions): + session.document.close() + window.close() + + +def assert_consecutive_searches_do_not_keep_stale_worker(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + window = MainWindow() + try: + window.open_file(path) + window.search_box.setText("left column") + window.search() + window.search_box.setText("right column") + window.search() + for _ in range(160): + if window._search_worker is None: + break + loop = QEventLoop() + QTimer.singleShot(10, loop.quit) + loop.exec() + app.processEvents() + assert window._search_worker is None + assert window._search_thread is None + assert window.search_results.count() > 0 + finally: + window._stop_search_worker(wait_ms=1000) + for session in list(window.sessions): + session.document.close() + window.close() + + +def assert_page_manager_external_thumbnails_are_queued(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + document = PdfDocument() + document.open(path) + dialog = PageManagerDialog(document) + try: + before = dialog.grid.count() + dialog.insert_external_pdfs([str(path)], before) + assert dialog.grid.count() == before + document.page_count + loop = QEventLoop() + QTimer.singleShot(250, loop.quit) + loop.exec() + app.processEvents() + assert not dialog.grid.item(before).icon().isNull() + finally: + dialog.close() + document.close() + + +def assert_page_manager_close_clears_thumbnail_queue(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + document = PdfDocument() + document.open(path) + dialog = PageManagerDialog(document) + try: + dialog.insert_external_pdfs([str(path)], dialog.grid.count()) + assert dialog._thumbnail_queue + dialog.done(0) + app.processEvents() + assert not dialog._thumbnail_timer.isActive() + assert not dialog._thumbnail_queue + assert not dialog._external_thumbnail_docs + finally: + document.close() + + +def assert_large_transaction_uses_file_checkpoint(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + window = MainWindow() + try: + window.open_file(path) + original_limit = window._TRANSACTION_PAGE_LIMIT + window._TRANSACTION_PAGE_LIMIT = 1 + checkpoint = window._make_document_transaction_checkpoint() + try: + assert checkpoint["type"] == "file" + assert Path(str(checkpoint["path"])).exists() + finally: + window._cleanup_document_transaction_checkpoint(checkpoint) + window._TRANSACTION_PAGE_LIMIT = original_limit + finally: + for session in list(window.sessions): + session.document.close() + window.close() + + +def assert_multi_tab_delayed_signal_is_ignored(path: Path, settings_dir: Path) -> None: + QSettings.setDefaultFormat(QSettings.Format.IniFormat) + QSettings.setPath(QSettings.Format.IniFormat, QSettings.Scope.UserScope, str(settings_dir)) + app = QApplication.instance() or QApplication([]) + second = path.parent / "second.pdf" + shutil.copy2(path, second) + window = MainWindow() + try: + window.open_file(path) + window.open_file(second) + assert len(window.sessions) >= 2 + window.tab_widget.setCurrentIndex(1) + app.processEvents() + current_page = window.viewer.page_index + hidden_viewer = window.sessions[0].viewer + hidden_viewer.page_changed.emit(3) + app.processEvents() + assert window.viewer is window.sessions[1].viewer + assert window.viewer.page_index == current_page + finally: + for session in list(window.sessions): + session.document.close() + window.close() + + +def assert_undo_history_is_limited(path: Path) -> None: + document = PdfDocument() + document.open(path) + for index in range(30): + document.add_note(0, f"note {index}", (72, 72 + index)) + assert len(document._undo_stack) <= document._MAX_HISTORY_ITEMS + assert document._undo_stack_bytes <= document._MAX_HISTORY_BYTES + document.close() + + +def main() -> int: + temp_dir = Path(tempfile.mkdtemp(prefix="pdfreaderlite_stability_")) + try: + settings_dir = temp_dir / "settings" + settings_dir.mkdir() + pdf_path = temp_dir / "source.pdf" + editable_pdf = temp_dir / "editable.pdf" + line_number_pdf = temp_dir / "line_numbers.pdf" + create_multi_page_pdf(pdf_path) + create_line_number_pdf(line_number_pdf) + shutil.copy2(pdf_path, editable_pdf) + + assert_save_failure_keeps_document_open(pdf_path, temp_dir) + assert_repeated_save_keeps_file_unlocked(pdf_path) + assert_render_cache_respects_memory_limit(pdf_path) + assert_large_snapshot_is_skipped(pdf_path) + assert_save_avoids_memory_backup(pdf_path, temp_dir) + assert_text_selection_stays_in_column(pdf_path) + assert_line_numbers_are_filtered(line_number_pdf) + assert_annotation_editing_is_stable(editable_pdf) + assert_open_bytes_and_annotation_cache_are_stable(pdf_path) + assert_page_operations_keep_view(pdf_path, settings_dir) + assert_async_viewer_render_finishes(pdf_path, settings_dir) + assert_background_open_large_pdf(pdf_path, settings_dir) + assert_background_search_returns_results(pdf_path, settings_dir) + assert_consecutive_searches_do_not_keep_stale_worker(pdf_path, settings_dir) + assert_page_manager_external_thumbnails_are_queued(pdf_path, settings_dir) + assert_page_manager_close_clears_thumbnail_queue(pdf_path, settings_dir) + assert_large_transaction_uses_file_checkpoint(pdf_path, settings_dir) + assert_missing_raster_fails_before_mutation(pdf_path) + assert_multi_tab_delayed_signal_is_ignored(pdf_path, settings_dir) + assert_undo_history_is_limited(pdf_path) + print("PDFReaderLite stability regression test passed.") + return 0 + finally: + shutil.rmtree(temp_dir, ignore_errors=True) + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/todo.md b/todo.md new file mode 100644 index 0000000..87447be --- /dev/null +++ b/todo.md @@ -0,0 +1,58 @@ +# PDFReaderLite 0.2.3 稳定性待办 + +0.2.3 只做稳定性增强,不新增业务功能。 + +## P0:优先修复 + +- [x] 将“另存为”改为事务式保存:先写入临时文件并验证可打开,再替换目标文件,失败时保持当前文档可继续使用。 +- [x] 将“加密另存为”改为事务式保存:失败时不破坏目标文件,不错误清除未保存状态。 +- [x] 为撤销/重做快照增加总内存上限:大 PDF 超出限制时自动减少快照数量或禁用新增快照。 +- [x] 调整快照创建时机:所有编辑操作先完成参数校验,确认会修改文档后再创建快照。 +- [x] 修复批量写入临时图片对象的失败处理:中途失败时不得重复插入已写入的图片对象。 +- [x] 保存成功后再清空临时图片对象:保存失败时保留对象状态,允许用户重试。 +- [x] 将页面缩放渲染改为防抖处理:连续滚轮缩放时不反复触发全量页面渲染。 +- [x] 将 PDF 主视图改为优先渲染可见页:大文档打开、缩放、刷新时避免一次性渲染全部页面。 +- [x] 为文本选择预览增加节流:鼠标移动时不得高频重复解析页面文字。 +- [x] 为注释悬停提示增加延迟和节流:鼠标移动时不得高频扫描页面注释。 + +## P1:状态一致性 + +- [x] 为多标签页信号增加会话校验:隐藏标签页的延迟信号不得影响当前标签页。 +- [x] 修复打开文件失败后的空标签页问题:文件无法打开或取消密码输入时自动恢复原标签状态。 +- [x] 为页面旋转增加视图保持测试和修复:旋转后不得跳转到首页。 +- [x] 为页面插入、删除、移动增加视图保持测试和修复:操作后保持在合理的当前页附近。 +- [x] 将页面管理应用流程改为可回滚:旋转、重排、插入 PDF 其中一步失败时不得留下半完成状态。 +- [x] 修复注释替换的失败风险:修改高亮、下划线、删除线、文本框时,创建新注释失败不得丢失旧注释。 +- [x] 为批量注释移动/缩放增加回滚保护:任一注释更新失败时不得留下部分更新状态。 +- [x] 修复旧页面控件延迟信号风险:页面刷新后旧控件发出的信号不得再访问已失效页面。 +- [x] 为延迟滚动定时器增加版本校验:旧的滚动请求不得覆盖新的页面定位。 +- [x] 修复关闭最后一个标签页时的空状态访问风险:没有活动会话时所有状态刷新都应安全返回。 + +## P2:性能和诊断 + +- [x] 注释列表刷新改为按需触发:普通翻页、缩放、状态栏刷新不得全量扫描所有页面注释。 +- [x] 当前页对象列表改为只读取当前页注释:避免每次刷新都遍历整份 PDF。 +- [x] 为页面覆盖图片增加像素缓存:绘制页面时不得每次从磁盘重新加载同一图片。 +- [x] 清理页面控件时调用安全释放流程:反复缩放和刷新后不应持续累积旧控件。 +- [x] 页面管理缩略图改为分批渲染:打开大文档页面管理时界面不应长时间无响应。 +- [x] 搜索功能增加进度和取消机制:大文档搜索期间界面应保持可响应。 +- [x] 导出、拆分、合并 PDF 增加忙碌提示:长时间文件操作期间避免用户重复触发操作。 +- [x] 为临时图片目录增加清理策略:启动或退出时清理过期临时文件。 +- [x] 补全 PDF 文件关联卸载逻辑:卸载关联后不得留下指向 PDFReaderLite 的失效注册项。 +- [x] 增加统一的界面操作异常保护:高风险按钮、右键菜单、拖拽操作失败时记录日志并给出中文提示。 +- [x] 增加 Qt 警告日志捕获:将常见界面警告写入日志,便于定位偶发问题。 +- [x] 修复界面乱码风险:检查并替换残留的异常字符显示。 + +## 回归测试 + +- [x] 增加保存失败恢复测试:模拟目标文件不可写,确认当前文档仍可继续编辑。 +- [x] 增加撤销内存限制测试:大 PDF 连续编辑时快照数量和内存占用受控。 +- [x] 增加 Ctrl+滚轮缩放测试:缩放后当前页不得跳转首页。 +- [x] 增加页面操作视图保持测试:旋转、删除、插入、移动页面后位置保持稳定。 +- [x] 增加双栏文本选择测试:拖选左栏或右栏时不得跨栏选中。 +- [x] 增加水印和行号文本选择测试:选择正文时尽量过滤水印和行号。 +- [x] 增加注释颜色修改测试:选中已有高亮后更改颜色应立即生效并可保存。 +- [x] 增加注释内容编辑测试:双击注释图标修改内容后可保存并重新打开查看。 +- [x] 增加临时图片保存失败测试:失败后重试不得重复插入图片。 +- [x] 增加多标签页隔离测试:非当前标签页的延迟刷新不得改变当前标签页状态。 +