🎉 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排序列表 - 向后兼容: 平滑升级,不破坏现有功能
This commit is contained in:
67
MANUAL_RELEASE_GUIDE.md
Normal file
67
MANUAL_RELEASE_GUIDE.md
Normal file
@@ -0,0 +1,67 @@
|
|||||||
|
# 🎉 v1.2 Release 创建指南
|
||||||
|
|
||||||
|
## ✅ 已完成的操作
|
||||||
|
|
||||||
|
✅ **代码推送**: 所有v1.2代码已推送到 `main` 分支
|
||||||
|
✅ **版本标签**: `v1.2` 标签已创建并推送到远程仓库
|
||||||
|
✅ **Release Notes**: 详细的发布说明已生成 (`release_notes_v1.2.md`)
|
||||||
|
✅ **提交信息**: 包含完整的更新说明和技术细节
|
||||||
|
|
||||||
|
## 🌐 手动创建Gitea Release
|
||||||
|
|
||||||
|
由于API自动创建时遇到数据库编码问题,请按以下步骤手动创建Release:
|
||||||
|
|
||||||
|
### 步骤 1: 访问Release页面
|
||||||
|
```
|
||||||
|
https://biboer.cn/gitea/gavin/iBook/releases
|
||||||
|
```
|
||||||
|
|
||||||
|
### 步骤 2: 创建新Release
|
||||||
|
1. 点击 **"New Release"** 按钮
|
||||||
|
2. 选择已存在的标签:**`v1.2`**
|
||||||
|
3. Release标题:**`v1.2 CFI排序与优化版本`**
|
||||||
|
|
||||||
|
### 步骤 3: 复制Release描述
|
||||||
|
将 `release_notes_v1.2.md` 文件的内容完整复制到描述框中。
|
||||||
|
|
||||||
|
### 步骤 4: 发布设置
|
||||||
|
- ☑️ **标记为最新版本**
|
||||||
|
- ☐ 预发布版本 (取消勾选)
|
||||||
|
- ☐ 草稿 (取消勾选)
|
||||||
|
|
||||||
|
## 📊 Release 内容摘要
|
||||||
|
|
||||||
|
### 🎯 核心特性
|
||||||
|
- **EPUB CFI 排序**: 完整实现IDPF标准,笔记按真实位置排序
|
||||||
|
- **阅读统计修复**: 7天/30天/年度统计准确性提升
|
||||||
|
- **界面优化**: 清理CSS警告,改进交互效果
|
||||||
|
- **测试覆盖**: 全面验证,660本书籍,232条笔记正常
|
||||||
|
|
||||||
|
### 🔧 技术更新
|
||||||
|
- 新增 `epub_cfi_parser.py` 核心模块
|
||||||
|
- 数据结构优化:嵌套字典 → CFI排序列表
|
||||||
|
- 向后兼容:平滑升级,不破坏现有功能
|
||||||
|
|
||||||
|
### 📈 验证数据
|
||||||
|
- 书籍处理:660+ 本
|
||||||
|
- 笔记排序:232 条按CFI正确排序
|
||||||
|
- 阅读统计:7天70分钟,30天159分钟,年度12313分钟
|
||||||
|
|
||||||
|
## 🔗 相关链接
|
||||||
|
|
||||||
|
- **仓库主页**: https://biboer.cn/gitea/gavin/iBook
|
||||||
|
- **标签页面**: https://biboer.cn/gitea/gavin/iBook/src/tag/v1.2
|
||||||
|
- **提交历史**: https://biboer.cn/gitea/gavin/iBook/commits/main
|
||||||
|
|
||||||
|
## 📝 后续操作
|
||||||
|
|
||||||
|
Release创建完成后,v1.2版本将正式发布,用户可以:
|
||||||
|
1. 下载源码包或克隆仓库
|
||||||
|
2. 查看详细的更新日志和技术文档
|
||||||
|
3. 按照升级指南从v1.1平滑升级到v1.2
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**状态**: ✅ 准备就绪,等待手动创建Release
|
||||||
|
**优先级**: 🔥 高 (建议立即完成)
|
||||||
|
**预计时间**: 2-3分钟
|
||||||
63
release_notes_v1.2.md
Normal file
63
release_notes_v1.2.md
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
## 🎉 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分钟
|
||||||
|
- **功能验证**: 所有核心功能测试通过
|
||||||
|
|
||||||
|
### 🔧 技术细节
|
||||||
|
|
||||||
|
```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. 界面样式自动更新
|
||||||
|
|
||||||
|
### 🔗 相关链接
|
||||||
|
|
||||||
|
- [详细技术文档](readme.md)
|
||||||
|
- [CFI 实现总结](CFI_IMPLEMENTATION_SUMMARY.md)
|
||||||
|
- [修复总结](FIX_SUMMARY.md)
|
||||||
|
- [版本变更](release.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**下载**: 克隆此仓库或下载源码包
|
||||||
|
**运行**: `python ibook_export_app.py`
|
||||||
|
**要求**: Python 3.12+, PyQt6, beautifulsoup4
|
||||||
Reference in New Issue
Block a user