# 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 编辑逻辑。 - 不新增大型业务功能。 - 不为了图标牺牲中文可读性。