Release PDFReaderLite 0.2.4

This commit is contained in:
2026-07-02 14:11:30 +08:00
parent a2efb40459
commit 44bc33a5e3
83 changed files with 873 additions and 102 deletions
+7 -7
View File
@@ -62,17 +62,17 @@ V3 已并入 `v0.2.2`。目标是让高频工作流更接近 Acrobat,同时继
- 鼠标悬停注释符号时显示注释内容;双击注释符号可编辑注释。
- 已有文本高亮支持重新选中并修改颜色。
## 当前版本:0.2.3 稳定性增强
## 当前版本:0.2.4 图标与工具栏可读性增强
0.2.3 只做稳定性增强,不新增业务功能。完整待办见根目录 [todo.md](../todo.md)。
0.2.4 只做视觉一致性和打包优化,不改变核心 PDF 编辑逻辑。完整方案见 [图标方案](icon.md)。
当前重点:
- 保存、另存为、加密另存为等写文件操作尽量事务化。
- 撤销/重做、渲染缓存、缩略图缓存、搜索、打印等长耗时或高内存流程需要可控。
- 大文档打开、页面管理、搜索、打印等操作要有进度提示或后台处理。
- 多标签页、延迟信号、旧页面控件、关闭空状态等边界要避免互相污染。
- 所有高风险界面操作要有异常保护、中文提示和日志。
- 所有高频按钮统一使用 Lucide 风格项目自绘 SVG 图标。
- 顶部工具栏、右侧工具面板、右键菜单和页面管理窗口保持图标风格一致。
- 图标资源集中在 `resources/icons/actions/`,业务代码通过统一入口读取。
- 图标缺失时安全降级,不影响软件启动和使用。
- 打包时继续保持单文件 exe,并尽量降低文件体积。
## 后续可选方向
+258
View File
@@ -0,0 +1,258 @@
# PDFReaderLite 0.2.4 图标方案
## 版本目标
`0.2.4` 定位为“图标与工具栏可读性增强版”,只做视觉和交互一致性优化,不改核心 PDF 功能。
目标:
- 为所有按钮补充统一风格图标。
- 提升顶部工具栏、右侧工具面板、状态栏按钮的可读性。
- 保持中文界面和 Acrobat 常用操作习惯。
- 图标缺失时不影响软件使用。
## 设计原则
- 图标风格统一:线性、简洁、单色为主。
- 常用按钮可使用“图标 + 短文字”,低频按钮优先使用“图标 + tooltip”。
- 选中状态使用蓝色强调,禁用状态降低透明度。
- 浅色和深色模式都要清晰可见。
- 工具栏图标建议 `16px` 或 `18px`,右侧工具面板建议 `18px`。
- 不使用过度彩色、复杂拟物图标,避免界面显得凌乱。
- 所有图标资源集中管理,不在业务代码里分散硬编码路径。
## 资源结构建议
```text
resources/
icons/
icon_software_multisize.ico
icon_pdf_multisize.ico
actions/
file-open.svg
file-save.svg
file-save-as.svg
...
```
建议新增统一图标注册模块:
```text
pdfreaderlite/ui/icons.py
```
职责:
- 根据图标名称返回 `QIcon`。
- 统一处理图标路径。
- 图标缺失时返回空图标或降级图标。
- 后续支持深色模式图标切换。
## 图标来源建议
优先级:
1. PySide6 / Qt 内置标准图标。
2. 一套许可证清晰的开源 SVG 图标库。
3. 必要时自绘少量项目专属 SVG。
候选风格:
- Lucide 风格:线条清晰,适合工具软件。
- Material Symbols 风格:覆盖面广,容易找到对应动作。
- Remix Icon 风格:中文软件里辨识度也较好。
注意事项:
- 选定图标库后,在文档中记录许可证和来源。
- 不混用多套视觉差异明显的图标。
- 不使用来源不明的网络图标。
当前已落地方案:
- 首批图标为 PDFReaderLite 项目自绘 SVG。
- 风格参考 Lucide 的线性工具图标语言,但不直接复制第三方图标文件。
- 统一使用 `24x24` 画布、`fill="none"`、`stroke="currentColor"`、`stroke-width="2"`、圆角端点和圆角连接。
- 文件位置:`resources/icons/actions/`。
## 按钮图标规划
### 文件类
| 按钮 | 建议图标 | 备注 |
| --- | --- | --- |
| 打开 | 文件夹 | 高频,保留文字 |
| 保存 | 软盘 | 高频,保留文字 |
| 另存为 | 软盘 + 铅笔/箭头 | 需要区别于保存 |
| 打印 | 打印机 | 菜单和工具栏一致 |
| 最近文件 | 时钟 | 菜单项可选 |
| 文档信息 | 信息圆圈 | 右侧工具面板 |
### 导航与视图
| 按钮 | 建议图标 | 备注 |
| --- | --- | --- |
| 指针 | 鼠标箭头 | 与手形互斥 |
| 手形 | 手掌 | 默认状态 |
| 阅读 | 眼睛/书本 | 右侧模式按钮 |
| 缩小 | 减号放大镜 | 状态栏 |
| 放大 | 加号放大镜 | 状态栏 |
| 适应宽度 | 左右箭头 | 状态栏 |
| 适应页面 | 页面框 | 状态栏 |
| 上一页 | 左箭头 | 如后续恢复按钮使用 |
| 下一页 | 右箭头 | 如后续恢复按钮使用 |
| 页码输入 | 页面 + 数字 | 输入框不强制加图标 |
### 注释
| 按钮 | 建议图标 | 备注 |
| --- | --- | --- |
| 注释 | 气泡列表 | 顶部模式按钮 |
| 高亮 | 荧光笔 | 支持多色菜单 |
| 下划线 | 带下划线的 U | |
| 删除线 | 带横线的 S | |
| 批注 | 对话气泡 | |
| 自由画笔 | 笔 | |
| 矩形 | 矩形框 | |
| 圆形 | 圆圈 | |
| 线条 | 斜线 | |
| 箭头 | 箭头线 | |
| 注释列表 | 列表 + 气泡 | |
| 注释属性 | 滑杆/调节 | |
### 编辑 PDF
| 按钮 | 建议图标 | 备注 |
| --- | --- | --- |
| 编辑 PDF | 页面 + 铅笔 | 顶部模式按钮 |
| 添加文本 | T | |
| 插入图片 | 图片框 | |
| 遮盖 | 黑色矩形/遮罩 | 需提示不是永久擦除 |
| 图片签名 | 图片 + 笔 | |
| 点击放置签名 | 签字笔 | |
| 手写签名 | 手写线条 | |
| 复制 | 双页 | 右键菜单也可用 |
| 粘贴 | 剪贴板 | 右键菜单也可用 |
| 删除 | 垃圾桶 | |
| 置顶 | 图层 + 上箭头 | |
| 置底 | 图层 + 下箭头 | |
| 上移一层 | 图层上移 | |
| 下移一层 | 图层下移 | |
| 对齐 | 对齐线条 | 根据方向细分 |
| 分布 | 等距线条 | 根据方向细分 |
### 页面
| 按钮 | 建议图标 | 备注 |
| --- | --- | --- |
| 页面 | 页面信息圆圈 | 顶部模式按钮 |
| 旋转 | 旋转箭头 | |
| 删除页 | 页面 + 垃圾桶 | |
| 移动页面 | 页面 + 箭头 | |
| 页面管理 | 页面网格 | |
| 插入空白页 | 页面 + 加号 | |
| 插入 PDF | PDF + 加号 | |
| 提取页面 | 页面 + 外箭头 | |
| 拆分 PDF | 分割线 | |
| 合并 PDF | 合并箭头 | |
### 工具与导出
| 按钮 | 建议图标 | 备注 |
| --- | --- | --- |
| 工具 | 工具箱 | 顶部模式按钮 |
| 导出当前页图片 | 图片 + 外箭头 | |
| 批量导出图片 | 多图片 + 外箭头 | |
| 图片转 PDF | 图片 + PDF | |
| 填写表单 | 表单/勾选框 | |
| 加密另存为 | 锁 | |
| 移除密码另存为 | 解锁 | |
| 注册 PDF 文件关联 | 链条 | |
| 打开系统默认应用设置 | 设置齿轮 | |
| 打开日志目录 | 文件夹 + 文档 | |
| 深色模式 | 月亮 | |
## 实施计划
### 第一步:整理按钮清单
输出一份完整按钮清单,至少包含:
- 顶部工具栏按钮。
- 状态栏按钮。
- 右侧工具面板按钮。
- 右键菜单动作。
- 页面管理窗口按钮。
- 签名、表单、属性面板中的按钮。
分类结果:
- 已有图标。
- 需要新增图标。
- 可复用图标。
- 不需要图标,只保留文字。
- 可考虑合并或调整命名的按钮。
### 第二步:建立图标注册表
新增 `pdfreaderlite/ui/icons.py`:
- 定义图标名称常量。
- 提供 `icon(name: str) -> QIcon`。
- 统一处理资源路径。
- 缺失图标时安全降级。
### 第三步:补齐核心区域图标
优先级:
1. 顶部工具栏。
2. 状态栏视图控制。
3. 右侧模式面板。
4. 页面管理窗口。
5. 右键菜单。
6. 低频设置类按钮。
### 第四步:统一 tooltip 和按钮展示方式
规则:
- 所有图标按钮必须有中文 tooltip。
- 高频操作可保留短文字。
- 低频按钮可只显示图标,但 tooltip 必须清楚。
- 禁用功能必须变灰,不支持的右键菜单项也要变灰或隐藏。
### 第五步:适配深色模式
检查内容:
- 图标在浅色背景可见。
- 图标在深色背景可见。
- 选中、悬停、禁用状态有明显差异。
- 不出现图标和文字重叠。
### 第六步:验收与回归
验收清单:
- 所有按钮均有图标或明确说明“不需要图标”。
- 所有图标按钮均有中文 tooltip。
- 顶部工具栏没有明显拥挤、错位、重叠。
- 右侧工具面板图标风格一致。
- 深色模式下图标可读。
- 打包后图标资源完整。
- 图标缺失不会导致程序启动失败。
建议新增测试:
- 图标资源存在性检查。
- 图标注册表缺失降级检查。
- 打包后资源路径检查。
## 不在 0.2.4 范围内
- 不重做整体 UI 布局。
- 不引入复杂 Ribbon。
- 不改核心 PDF 编辑逻辑。
- 不新增大型业务功能。
- 不为了图标牺牲中文可读性。
+41
View File
@@ -2,6 +2,47 @@
本文档合并历史发布说明,作为后续唯一版本记录入口。
## v0.2.4
发布日期:2026-07-02
### 版本定位
`0.2.4` 是图标与工具栏可读性增强版本,重点统一按钮图标、右侧工具面板和右键菜单的视觉表达,不改变核心 PDF 编辑逻辑。
### 发布产物
```text
dist\PDFReaderLite.exe
```
版本信息:
- 应用版本:`0.2.4`
- exe 版本:`0.2.4`
- 文件大小:`48,942,346 bytes`
- SHA256:`E5DFE6339329D9F022AA3F05A973B1828D3F372C11AE86600C32CD100E367B9E`
### 主要变化
- 新增 Lucide 风格项目自绘 SVG 图标,统一存放在 `resources/icons/actions/`。
- 新增图标注册入口 `pdfreaderlite/ui/icons.py`,统一处理图标路径、缓存和缺失降级。
- 顶部工具栏、菜单、右侧工具面板统一接入新图标。
- 页面管理窗口补充删除、旋转、提取等操作图标。
- 文本选择、注释、对象编辑等右键菜单补充常用图标。
- 图标按蒙版方式加载,便于浅色/深色模式下跟随界面颜色显示。
- 打包配置继续压缩单文件 exe,并排除更多无关模块以降低体积。
### 已验证
- 源码烟雾测试通过。
- Python 编译检查通过。
- 71 个 SVG 图标资源均可加载,且没有空白图标。
### 已知边界
- 当前图标为项目自绘 SVG,后续仍可继续微调个别按钮语义和视觉细节。
- 当前版本不引入 Ribbon,不重做整体 UI 布局。
## v0.2.3
发布日期:2026-07-02