Release v0.2.3

This commit is contained in:
2026-07-02 12:12:22 +08:00
parent a76d2dfea7
commit a2efb40459
22 changed files with 2364 additions and 1078 deletions
+36 -47
View File
@@ -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 并保持表格结构。
+157
View File
@@ -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、数字证书签名、自动更新不在当前范围。
-53
View File
@@ -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 重点增强。
-54
View File
@@ -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、数字证书签名、自动更新不在当前版本范围。
-205
View File
@@ -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. 遮盖、图片、水印等编辑增强。
-93
View File
@@ -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 页面渲染和缩略图基础验收通过。
-182
View File
@@ -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. 对象对齐、样式复制等增强。
-116
View File
@@ -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 文本导出。