'update'

detaildesign.md

@@ -1,3 +1,24 @@
+# 2025年阅读统计功能设计补充
+
+## 书籍阅读时长统计
+
+1. `readtime30d`：每本书最近30天每天的阅读时长（分钟），索引0为今天，索引29为30天前。
+2. `readtime12m`：每本书今年每月的累计阅读时长（分钟），索引0为1月，索引11为12月。统计逻辑为遍历今年每一天，按月累计。
+3. `readtime_year`：每本书今年总阅读时长（分钟），为`readtime12m`各月之和。
+4. 支持无笔记但当天有打开书籍时，阅读时长设为`READ_TIME_OPEN_DAY`（config.py配置，默认30分钟）。
+5. 多条笔记时，统计相邻笔记时间差（仅累加小于3小时的部分），更真实反映实际阅读行为。
+
+## 全局统计函数
+
+1. `get_total_readtime_year()`：返回全年所有书的累计阅读时间（分钟）。
+2. `get_total_readtime12m()`：返回全年所有书的月度累计阅读时间（长度12的列表，单位：分钟）。
+3. `get_total_readtime(days=30)`：返回最近days天每天所有书籍的总阅读时间（分钟），索引0为今天。
+
+## 设计说明
+
+- 所有统计均以“分钟”为单位，便于可视化和分析。
+- 年度统计遍历今年每一天，保证月度和年度数据完整。
+- 统计逻辑与实际阅读行为高度贴合，支持无笔记但有打开书籍的场景。
 # iBooks 笔记导出工具 详细设计文档
 
 ## 1. 概述