This commit is contained in:
douboer
2025-10-21 10:46:03 +08:00
parent db9be32815
commit fb0f5ed9c5
20 changed files with 1869 additions and 103 deletions

60
release.md Normal file
View File

@@ -0,0 +1,60 @@
# 版本信息
## v1.0
**发布时间**: 2025-08
初版,框架,可视化
## v1.1
**发布时间**: 2025-09
重组目录新增模块拆分、UML、AI 简评与可视化章节整理
## 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分钟
- **功能验证**: 所有核心功能测试通过
### 🔧 技术细节
```python
# 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. 界面样式自动更新