릴리즈 노트

새 기능 — 책별 독서 타이머 (Reading Timer)

핵심

• EPUB과 TXT 두 리더 모두에서 책을 펼치는 순간부터 독서 시간이 자동 누적됩니다.
• 누적 시간은 책의 캐시 디렉터리(.crosspoint//reading_stats.bin)에 16바이트 바이너리로 저장되어, 책을 닫고 다시 열어도 이어서 계산됩니다.
• 리더 메뉴 상단 진행률 라인 우측에 누적 시간 칩이 표시됩니다 (Reading Time: 1h 23m).
• 메뉴에 독서 타이머 초기화 / Reset Reading Timer 항목이 추가되었습니다 — 두 단계 확인 후에만 누적 값이 0으로 리셋됩니다.

동작 디테일

기술 내용

• 신규 모듈: src/util/ReadingStats.{h,cpp}, src/util/ReadingTimer.{h,cpp}
• 저장 포맷: 16바이트 (magic 'TIME', version=1, totalSeconds u32, sessionCount u32, little-endian)
• 시간 누적은 millis() 기반이며 49.7일 롤오버에 안전한 uint32_t 차감을 사용합니다.
• 단일 tick이 2초를 초과하면 서브 액티비티/슬립 갭으로 간주하여 누적에서 제외합니다.
• uint32 초 단위 카운터로 약 136년치 시간을 다룰 수 있습니다.

i18n

• STR_READING_TIME — 독서 시간 / Reading Time
• STR_RESET_READING_TIMER — 독서 타이머 초기화 / Reset Reading Timer
• STR_RESET_READING_TIMER_PROMPT — 이 책의 독서 시간을 초기화할까요? / Reset this book's reading time?

호환성

• 기존 progress.bin, book.bin, section.bin 캐시 포맷에는 영향 없음.
• reading_stats.bin은 책당 새로 생성되는 파일이며, 없으면 0초로 시작합니다.
• 기존에 읽던 책의 누적 시간은 이 빌드를 처음 켠 시점부터 0초로 시작합니다.

빌드 정보

• 환경: ESP32-C3 (Xteink X4)
• Flash 사용량: ~99.7%
• DRAM 사용량: ~51.2%

변경 파일

• src/util/ReadingStats.{h,cpp} (신규)
• src/util/ReadingTimer.{h,cpp} (신규)
• src/activities/reader/{Epub,Txt}Reader{,Menu}Activity.{h,cpp}
• lib/I18n/translations/{english,korean}.yaml
• platformio.ini (버전 범프)

TXT 리더 옵션 적용 + 설정 변경 시 첫 페이지 회귀 버그 수정

개선 사항

TXT 리더에 누락되어 있던 옵션 두 가지 적용

• 추가 단락 간격 (extraParagraphSpacing) — 단락 사이에 약 반 줄 높이의 여백을 추가합니다. 페이지의 첫 단락 앞에는 적용되지 않아 위쪽 여백이 어색하게 늘어나지 않습니다.
• 단락 들여쓰기 (paragraphIndent) — 각 단락의 첫 줄에 1em 만큼 들여쓰기를 적용합니다.

페이지 분할 방식 개선

정렬 동작 개선

버그 수정

설정 변경 시 첫 페이지로 돌아가는 문제 ([현상 #1])

• initializeReader()를 recomputeLayout() (레이아웃 재계산)과 진행률 로드로 분리
• progressLoaded 플래그를 추가하여 진행률은 파일을 열 때 한 번만 로드
• 설정 변경 분기에서는 recomputeLayout()만 호출, currentOffset은 유지하고 라인 경계로 스냅
• loadProgress()의 layout 검증 제거 — byte offset은 layout-독립적이라 폰트/여백을 바꿔도 그대로 유효

진행률 파일 포맷 변경

적용 옵션 현황