Document V2 annotation and editing roadmap

This commit is contained in:
2026-06-30 12:40:10 +08:00
parent 6c48c63907
commit 27fe99a435
5 changed files with 452 additions and 152 deletions
+73 -76
View File
@@ -1,111 +1,108 @@
# PDFReaderLite
PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与编辑工具,目标是实现 Adobe Acrobat 常用功能的轻量替代版。
PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,目标是提供 Adobe Acrobat 常用功能的轻量替代版。
## 第一版范围
当前稳定版本:`0.2.1`
- 打开 PDF
- 阅读、翻页、缩放
- 连续阅读模式,页面上下自动衔接并保留页间缝隙
- 鼠标滚轮优先在文档内容窗口内上下滚动
- 键盘左右键翻页,上下键滚动阅读区
- 状态栏三段式页面显示区:页码输入、对数型缩放滑条与 20%-300% 缩放文本框、适应宽度/适应页面
- 适应宽度、适应页面
- 页码跳转(已支持状态栏页码输入框,失焦后自动跳转并校验非法输入)
- 左侧缩略图
- 文本搜索
- 页面旋转
- 页面删除
- 保存
- 另存为
- 最近打开文件
- 拖拽 PDF 文件到软件窗口打开
- 中文界面
- Acrobat 风格布局(已完成第二轮界面优化:图标化顶部工具栏、加深阅读画布、可收起右侧工具面板)
## 当前能力
## 已加入的增强功能
- 多标签打开 PDF。
- 连续阅读、缩放、适应宽度、适应页面、页码跳转。
- 左侧自适应缩略图。
- 阅读、编辑PDF、页面、工具、注释模式切换。
- 文本搜索。
- 高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。
- 注释列表、注释跳转、注释删除。
- 添加文本、放置文本、插入图片、放置图片、遮盖区域。
- 图片签名、放置签名、手写签名。
- 页面旋转、删除、移动、插入、提取、拆分、合并。
- 基础表单填写。
- 导出页面图片、批量导出图片、图片合成 PDF。
- 保存、另存为、加密另存为、移除密码另存为。
- 打印、最近文件、拖拽打开。
- 深色模式、窗口状态记忆、异常日志。
- 单文件 exe 打包。
- 下划线、删除线
- 矩形、圆形、线条、箭头
- 遮盖区域
- 插入空白页
- 插入其他 PDF
- 提取指定页面
- 按页拆分 PDF
- 合并多个 PDF
- 程序图标
- PDF 文档图标资源
- 多尺寸 ico 图标资源
- 当前页导出为 PNG 图片
- 批量导出页面图片
- 图片合成为 PDF
- 文档信息查看与编辑
- 密码保护另存为
- 打开加密 PDF
- 移除密码另存为
- 打印
- 基础表单填写
- 注释列表与删除注释
- 撤销、重做
- 页面移动重排
- 独立页面管理视图
- 网格缩略图拖拽重排页面
- 页面自由画笔
- 手写签名
- 点击页面放置文本、图片、签名
- 图片/签名当前会话内拖动缩放,保存时固化写入 PDF
- 选择对象、拖动、右下角缩放、Delete/右键删除注释对象
- 加密 PDF 权限选项
- 页面渲染缓存
- 分批加载缩略图
- 大文件缩略图按可见区域懒加载
- 异常日志
- 窗口大小与布局记忆
- 启动时恢复上次文件提示
- 清空最近文件
- 关于窗口
- 快捷键说明
- 打开日志目录
- exe 版本资源
- 设置中注册 PDF 文件关联
- Acrobat 风格右侧工具面板(已完成可折叠分类、搜索结果默认收起、整栏收起/展开)
- 缩略图单列卡片式显示与克制选中态,支持随左侧栏拖拽宽度自适应缩放并限制最大栏宽,横向缩略图格子高度已压缩
- 顶部与右侧常用工具图标化,另存为/缩放/适应宽度图标已区分,状态栏页面按钮已加宽
- 图片签名
- 多标签页打开、切换、关闭 PDF
- 未保存更改星号提示,关闭标签/窗口时保存确认
- 深色模式
- 常用快捷键
## 第二版计划
## 本地开发
第二版重点提升注释和编辑能力:
- 鼠标选择文本后直接标注。
- 注释属性面板。
- 注释列表筛选和搜索。
- 图章工具。
- 文本框二次编辑。
- 文本、图片、签名、遮盖、图形注释统一对象选择。
- 右键菜单、Esc 取消、Delete 删除、方向键微调。
- 未保存状态进一步完善。
文档入口:
- [开发计划](docs/development_plan.md)
- [V2 注释与编辑专项计划](docs/v2_annotation_edit_plan.md)
- [V2 需求清单](docs/v2_requirements_checklist.md)
- [V1 发布说明](docs/release_v0.2.1.md)
## 本地运行
创建虚拟环境:
```powershell
python -m venv .venv
```
如果 PowerShell 禁止运行激活脚本,可以使用:
```powershell
powershell -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1
```
安装依赖:
```powershell
python -m pip install -r requirements.txt
```
运行:
```powershell
python main.py
```
运行烟测:
## 测试
```powershell
python scripts\smoke_test.py
```
## 打包
打包单文件 exe:
```powershell
.\build.ps1
```
如果当前 PowerShell 禁止直接运行脚本,可以使用:
如果 PowerShell 禁止直接运行脚本:
```powershell
powershell -ExecutionPolicy Bypass -File .\build.ps1
```
打包产物位于:
产物位置:
```text
dist\PDFReaderLite.exe
```
## 不纳入范围
- PDF 转 Word 并保持原排版。
- PDF 转 Excel 并保持表格结构。
- OCR 生成高质量可搜索 PDF。
- 扫描件自动版面分析。
- 数字证书签名。
- 敏感信息真正永久擦除。
- 自动更新。
- 单 exe 内置完整 OCR。
+63 -76
View File
@@ -2,89 +2,76 @@
## 产品定位
PDFReaderLite 是 Windows 平台的轻量 PDF 阅读与编辑工具。功能重点是阅读、注释、覆盖式编辑、页面管理、基础表单、视觉签名、导出和密码保护。
PDFReaderLite 是面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,目标是提供 Adobe Acrobat 常用功能的轻量替代版。
## V1:基础可用版
核心边界:
- 打开 PDF
- 阅读、翻页、缩放(已支持连续阅读、页间缝隙、鼠标滚轮页内/文档内滚动、键盘左右翻页、键盘上下滚动、状态栏三段式页面控件、对数型缩放滑条,缩放范围 20%-300%)
- 适应宽度、适应页面
- 页码跳转(已支持状态栏无上下按钮页码输入框,失焦后自动跳转并校验非法输入)
- 左侧缩略图
- 文本搜索
- 高亮
- 批注
- 添加文本(已支持默认位置与鼠标点击放置)
- 插入图片(已支持默认位置与鼠标点击放置)
- 页面旋转
- 页面删除
- 保存
- 另存为
- 最近打开文件
- 拖拽 PDF 文件到软件窗口打开(已完成)
- 中文界面
- Acrobat 风格布局(已完成第二轮界面优化:图标化顶部工具栏、加深阅读画布、可收起右侧工具面板)
- 重点做阅读、注释、覆盖式编辑、页面管理、基础表单、视觉签名、导出、密码保护。
- 不做复杂 OCR、PDF 原文重排编辑、数字证书签名、真正永久擦除敏感信息。
- 打包形态以单文件 exe 为主。
## V2:编辑增强版
## V1:稳定可用版
- 撤销/重做(已完成基础快照)
- 下划线、删除线
- 画笔(已完成页面自由画笔,画完后作为墨迹注释)
- 矩形、圆形、线条、箭头
- 注释列表(已完成)
- 删除注释(已完成)
- 移动、缩放、删除新增对象(已完成注释对象选择、拖动、右下角缩放、Delete/右键删除;图片/签名按稳定路线保存后固化)
- 遮盖区域
- 插入空白页
- 插入其他 PDF 页面
- 提取页面
- 拆分 PDF
- 合并 PDF
- 页面拖拽重排(已完成独立页面管理视图)
V1 已发布为 `v0.2.1`,发布产物为 `dist/PDFReaderLite.exe`。
## V3:实用工具版
已完成能力:
- 填写已有 PDF 表单(已完成基础字段填写)
- 基础文本框、复选框、单选按钮
- 手写签名(已完成)
- 图片签名(已完成基础放置、鼠标点击放置、当前会话拖动缩放;保存后固化进 PDF)
- 签名拖拽移动/缩放(已完成当前会话调整层;重新打开后作为页面内容固定)
- 导出页面为图片(已完成)
- 导出指定页面(已完成)
- 图片转 PDF(已完成)
- 查看、修改文档信息(已完成)
- 设置打开密码(已完成密码另存为)
- 移除密码(已完成另存为无密码 PDF)
- 基础权限设置(已完成加密保存权限选项)
- 打印(已完成)
- 多标签页(已完成多文档标签打开、切换、关闭)
- 深色模式(已完成)
- PDF 文件关联(已完成当前用户级注册与系统默认应用入口)
- 多标签 PDF 打开、切换、关闭。
- 连续阅读、鼠标滚轮滚动、键盘左右翻页、键盘上下滚动。
- 状态栏页码输入、缩放滑条、缩放百分比输入、适应宽度、适应页面。
- 阅读、编辑PDF、页面、工具、注释模式切换。
- 阅读模式下退出对象选择、画笔、放置等编辑状态。
- 左侧缩略图懒加载,支持横屏/竖屏自适应布局。
- 右侧工具面板按模式显示。
- 文本搜索与搜索结果跳转。
- 页面旋转、删除、移动、插入空白页、插入 PDF、提取、拆分、合并。
- 高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。
- 注释列表展示、点击跳转、删除。
- 添加文本、点击放置文本、插入图片、点击放置图片、遮盖区域。
- 图片签名、点击放置签名、手写签名。
- 新增图片/签名对象在当前会话内可拖动、缩放、删除,保存时写入 PDF。
- 保存、另存为、加密另存为、移除密码另存为。
- 打开加密 PDF。
- 基础表单字段填写。
- 当前页导出图片、批量导出图片、图片合成 PDF。
- 文档信息查看与修改。
- 打印。
- 未保存星号提示,关闭标签/窗口时保存确认。
- 最近文件、拖拽 PDF 到窗口打开。
- 深色模式、窗口状态记忆、异常日志、打开日志目录。
- PDF 文件关联入口。
- PyInstaller 单文件 exe 打包,含图标与版本资源。
## V4:打包与体验优化
## V2:注释与编辑增强版
- 大文件性能优化(已完成缩略图可见区域懒加载与缩略图独立缓存)
- Acrobat 风格右侧工具面板(已完成可折叠分类、搜索结果默认收起、整栏收起/展开)
- 缩略图单列卡片式显示与克制选中态(已完成随左侧栏拖拽宽度自适应缩放、限制最大栏宽、压缩横向缩略图格子高度)
- 顶部与右侧常用工具图标化(已完成另存为、缩小、放大、适应宽度图标区分,状态栏页面按钮已加宽)
- 页面缓存(已完成基础缓存)
- 后台渲染(已完成缩略图分批加载)
- 快捷键(已完成常用快捷键与说明)
- 配置保存(已完成窗口状态、主题、最近文件)
- 未保存更改保护(已完成标签星号提示、保存状态跟踪、关闭标签/窗口确认)
- 异常恢复(已完成异常日志、日志目录入口与上次文件恢复提示)
- PyInstaller 打包(已完成并通过构建实测)
- 单文件 exe(已完成并通过启动实测)
- 程序图标(已完成)
- 版本号(已完成应用版本与 exe 版本资源)
V2 目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。
## 不纳入范围
主线:
- PDF 转 Word 并保持原排版
- PDF 转 Excel 并保持表格结构
- OCR 生成高质量可搜索 PDF
- 扫描件自动版面分析
- 数字证书签名
- 敏感信息真正永久擦除
- 自动更新
- 单 exe 内置完整 OCR
- 注释主线:文本选择标注、注释属性、注释列表筛选搜索、图章。
- 编辑主线:文本框二次编辑、对象属性、统一对象选择、复制删除移动缩放。
- 交互主线:右键菜单、Esc 取消、模式状态清晰、未保存提示完善。
优先功能包见 [V2 注释与编辑专项计划](v2_annotation_edit_plan.md)。
## V3:实用工具增强版
候选方向:
- 水印工具:文字水印、图片水印,支持全部页/指定页。
- 图像编辑增强:裁剪、替换、透明度、旋转。
- 页面对象列表:显示当前页新增对象,点击选中。
- 注释导出:导出为 txt/html/json。
- 简单测量工具:两点距离、线段长度。
- 更完整的表单支持。
## 长期不纳入范围
- PDF 转 Word 并保持原排版。
- PDF 转 Excel 并保持表格结构。
- OCR 生成高质量可搜索 PDF。
- 扫描件自动版面分析。
- 数字证书签名。
- 敏感信息真正永久擦除。
- 自动更新。
- 单 exe 内置完整 OCR。
+53
View File
@@ -0,0 +1,53 @@
# 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 重点增强。
+180
View File
@@ -0,0 +1,180 @@
# V2 注释与编辑专项计划
## 目标
V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”进入“审阅和覆盖式编辑顺手”的阶段。
设计原则:
- 参考 Acrobat 的常用工作流,但保持轻量。
- 优先增强已有能力,不引入高风险的大型功能。
- 编辑方式仍以覆盖式编辑为主,不做 PDF 原文重排编辑。
- 所有新增编辑都必须有清晰的选中、取消、删除、保存提示。
## 第一优先级
### 1. 文本选择后直接标注
现状:高亮、下划线、删除线主要通过输入文字查找后标注。
目标:
- 鼠标选中页面文字后,可直接执行高亮、下划线、删除线。
- 选中文本后可出现迷你工具条,提供高亮、下划线、删除线、复制、添加批注。
- 对无法识别文本的扫描页,保留现有输入文字标注方式。
验收标准:
- 可在普通文本 PDF 中选中一段文字并直接添加标注。
- 标注后注释列表自动刷新。
- Esc 可取消当前选区或迷你工具条。
### 2. 注释属性面板
目标:
- 选中注释后,右侧显示属性区。
- 支持查看页码、类型、内容。
- 支持修改颜色、线宽、透明度。
- 对便签/批注支持修改内容。
验收标准:
- 选中高亮、图形、画笔、便签时,属性面板显示对应可编辑项。
- 修改属性后页面立即刷新,并标记文档未保存。
### 3. 注释列表筛选与搜索
目标:
- 注释列表支持按类型筛选:全部、高亮、文本标记、便签、图形、画笔。
- 支持搜索注释内容。
- 支持点击跳转、右键删除、双击编辑内容。
验收标准:
- 筛选不改变 PDF 内容,只影响列表显示。
- 删除或修改注释后列表和页面同步刷新。
### 4. 文本框对象化与二次编辑
现状:添加文本后可写入 PDF,但二次编辑能力有限。
目标:
- 添加文本后自动选中文本框。
- 支持拖动、缩放、删除。
- 双击文本框可修改内容。
- 属性面板支持字号、颜色、加粗。
验收标准:
- 添加文本后可立即调整位置和大小。
- 双击后修改文字内容,保存后写入 PDF。
- Delete 删除文本框,Esc 取消选择。
### 5. 统一对象选择体验
目标:
- 文本、图片、签名、遮盖、图形注释使用统一选择框和控制点。
- 右键菜单支持删除、复制、属性。
- 键盘 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. 遮盖、图片、水印等编辑增强。
+83
View File
@@ -0,0 +1,83 @@
# V2 需求清单
## 注释:新增功能
- [ ] 鼠标选择文本后直接高亮。
- [ ] 鼠标选择文本后直接下划线。
- [ ] 鼠标选择文本后直接删除线。
- [ ] 选中文本后的迷你工具条。
- [ ] 注释属性面板。
- [ ] 注释颜色设置。
- [ ] 注释线宽设置。
- [ ] 注释透明度设置。
- [ ] 便签/批注内容二次编辑。
- [ ] 注释列表按类型筛选。
- [ ] 注释列表搜索。
- [ ] 注释列表右键删除。
- [ ] 注释列表双击编辑内容。
- [ ] 图章工具。
- [ ] 常用中文图章预设。
- [ ] 自定义图片图章。
- [ ] 注释样式预设。
## 注释:旧功能完善
- [ ] 高亮、下划线、删除线保留“输入文字查找后标注”的备用方式。
- [ ] 图形注释支持修改颜色、线宽、透明度。
- [ ] 自由画笔支持颜色、线宽、透明度。
- [ ] 注释创建后自动刷新右侧注释列表。
- [ ] 注释删除后自动刷新右侧注释列表。
- [ ] 阅读模式下禁止选中注释对象。
## 编辑:新增功能
- [ ] 文本框双击编辑内容。
- [ ] 文本框字号设置。
- [ ] 文本框颜色设置。
- [ ] 文本框加粗设置。
- [ ] 添加文本后自动选中新对象。
- [ ] 图片替换。
- [ ] 图片旋转。
- [ ] 图片透明度。
- [ ] 图片裁剪。
- [ ] 遮盖颜色设置。
- [ ] 遮盖透明度。
- [ ] 遮盖后添加文字。
- [ ] 对象复制。
- [ ] 对象粘贴。
- [ ] 方向键微调对象。
- [ ] Shift+方向键大步移动对象。
- [ ] 对象图层顺序:置顶、置底、上移、下移。
- [ ] 页面内对象列表。
## 编辑:旧功能完善
- [ ] 文本、图片、签名、遮盖、图形注释使用统一选择框。
- [ ] Delete 删除选中对象。
- [ ] Esc 取消当前选择。
- [ ] 右键菜单支持删除、复制、属性。
- [ ] 保存前正确固化当前会话对象。
- [ ] 所有对象变更触发未保存状态。
## 交互体验
- [ ] 当前模式在状态栏显示。
- [ ] 阅读、编辑PDF、页面、工具、注释模式互斥。
- [ ] 鼠标光标随模式变化。
- [ ] Esc 取消放置文本。
- [ ] Esc 取消放置图片。
- [ ] Esc 取消放置签名。
- [ ] Esc 取消画笔。
- [ ] Esc 取消当前选中对象。
- [ ] 顶部工具栏只保留模式和常用基础动作。
- [ ] 复杂设置放在右侧面板或右键菜单中。
## 验收测试建议
- [ ] 普通文本 PDF:选择文字后高亮、下划线、删除线。
- [ ] 扫描/图片型 PDF:区域高亮、图章、画笔仍可使用。
- [ ] 多页 PDF:注释列表筛选、搜索、跳转正确。
- [ ] 多标签 PDF:每个标签的未保存状态独立。
- [ ] 保存后重新打开:新增文本、图片、图章、遮盖、注释存在。
- [ ] 阅读模式:不能选中页面对象,右侧工具窗口关闭。
- [ ] 大文件:缩略图和页面滚动不卡死。