Files
iBook/release_notes_v1.2.md
douboer 17907d4290 🎉 Release v1.2: CFI排序系统与界面优化
🎯 主要更新:
-  EPUB CFI 排序: 完整实现 IDPF 规范,笔记按真实位置排序
-  阅读统计修复: 修复数据结构变更导致的计算错误
-  界面优化: 清理 CSS 警告,改进按钮交互效果
-  测试覆盖: CFI 解析、排序、导出全面验证
-  文档更新: todolist.md, readme.md, release.md

📊 验证数据:
- 书籍处理: 660+ 本
- 笔记排序: 232 条按 CFI 正确排序
- 阅读统计: 7天70分钟,30天159分钟,年度12313分钟

🔧 技术改进:
- 新增 epub_cfi_parser.py 核心模块
- 数据结构优化: 嵌套字典 → CFI排序列表
- 向后兼容: 平滑升级,不破坏现有功能
2025-10-21 10:57:20 +08:00

2.1 KiB
Raw Blame History

🎉 iBooks 笔记专家 v1.2 发布

发布时间: 2025-10-21
版本代号: CFI 排序与优化版本

🎯 重大更新

1. EPUB CFI 排序系统

  • 完整实现 IDPF EPUB CFI 规范: 按真实文档位置排序笔记,解决之前字符串排序的错误
  • 智能章节识别: 自动提取章节信息,支持复杂的 CFI 格式
  • 降级处理机制: CFI 解析失败时自动使用物理位置和创建时间排序
  • 测试覆盖: 全面的 CFI 解析、排序、导出验证测试

2. 阅读统计修复

  • 数据结构适配: 修复 CFI 实现后的数据兼容性问题
  • 统计准确性: 7天/30天/年度阅读时长计算恢复正常
  • 图表显示: 阅读统计图表数据源修复

3. 界面与体验优化

  • 样式修复: 清理 4 个 "Unknown property filter" CSS 警告
  • 按钮交互: 使用原生 Qt 渐变替代不支持的 CSS3 属性
  • 调试信息: 禁用冗余的控制台输出,保持界面清洁

4. 技术架构

  • 新增模块: epub_cfi_parser.py - 专门的 CFI 解析引擎
  • 向后兼容: 保持所有现有功能的完整性
  • 性能优化: 优化数据处理流程,减少不必要的计算

📊 验证数据

  • 书籍处理: 660+ 本书籍元数据正常
  • 笔记排序: 232 条笔记按 CFI 位置正确排序
  • 阅读统计: 7天70分钟30天159分钟年度12313分钟
  • 功能验证: 所有核心功能测试通过

🔧 技术细节

# CFI 排序示例
原始顺序: ["/6/22", "/6/18", "/6/22", "/6/18"]
CFI 排序: ["/6/18", "/6/18", "/6/22", "/6/22"]  
字符串排序: ["/6/18", "/6/2", "/6/22"]  错误

🚀 升级指南

v1.1 → v1.2 升级自动兼容,无需额外配置:

  1. 笔记排序自动切换到 CFI 模式
  2. 阅读统计自动修复数据获取
  3. 界面样式自动更新

🔗 相关链接


下载: 克隆此仓库或下载源码包
运行: python ibook_export_app.py
要求: Python 3.12+, PyQt6, beautifulsoup4