TomoRead 0.4.1

TomoRead 0.4.1

本次更新重点优化移动端阅读体验与稳定性，并新增 Android 音量键翻页功能。

新功能

• Android 端支持使用音量键翻页。
  • 音量上键：上一页
  • 音量下键：下一页
  • 可在“默认阅读”设置中开启或关闭。
• EPUB、TXT/Markdown 与 PDF 阅读器均支持音量键翻页。
• 书架的筛选条件、排序方式和视图模式会在重启后保留。

优化与修复

• 优化移动端设置页面和阅读控制的紧凑布局。
• 改善阅读进度保存与恢复的可靠性。
• 提升 Android 端 EPUB 章节切换的稳定性。
• 修复移动端部分状态在切换页面后丢失的问题。
• 改善大字号下的阅读器控制显示效果。

说明

• 音量键翻页仅在 Android 端显示和生效，桌面端不受影响。

fix issue-1 #1

Full Changelog: v0.4.0...v0.4.1

TomoRead 0.4.0

中文

本版本聚焦阅读器稳定性与跨平台体验，重点修复 Android EPUB 的阅读进度与文本选择问题，并完善主题与 Windows EPUB 诊断。

主要更新

• 修复 Android EPUB 阅读位置与章节进度更新不稳定的问题。
• 退出阅读页时可靠保存最后阅读位置，减少重开书籍后进度丢失。
• 优化 Android 文本选择：保留选区拖动手柄，避免选区菜单重复弹出，并让长按或调整手柄后可稳定进入阅读器操作菜单。
• EPUB 初次定位期间显示“正在定位”，避免误显示为本章 0% 。
• 新增阅读器独立主题，并提供纸张、白色等更适合长时间阅读的配色。
• 完善章节进度展示。
• 改进 Windows EPUB WebView 的平台隔离与错误提示，便于诊断 WebView2、图形捕获等启动问题。
• 补充阅读器生命周期与 locator 回归测试。

升级说明

• 版本号：0.4.0（build 5）。
• 升级后建议重新打开正在阅读的 EPUB，以确认阅读位置和章节进度正常恢复。

English

This release focuses on reader stability and cross-platform polish. It improves Android EPUB progress tracking and text selection, while expanding themes and Windows EPUB diagnostics.

Highlights

• Fixed unreliable reading-position and chapter-progress updates in Android EPUB.
• Reliably saves the latest reading position when leaving the reader, reducing lost progress after reopening a book.
• Improved Android text selection: preserves draggable selection handles, prevents duplicate reader menus, and reliably opens the reader action menu after long-press selection or handle adjustments.
• Shows “Locating…” while EPUB position measurement is pending instead of incorrectly displaying 0% chapter progress.
• Added independent reader themes, including paper-like and white palettes for comfortable long reading sessions.
• Improved chapter-progress presentation.
• Improved platform isolation and diagnostics for Windows EPUB WebView startup issues, including WebView2 and graphics-capture failures.
• Added reader lifecycle and locator regression coverage.

Upgrade Notes

• Version: 0.4.0 (build 5).
• After upgrading, reopen any active EPUB once to verify that the reading position and chapter progress are restored correctly.

Full Changelog: v0.3.0...v0.4.0

TomoRead 0.3.0

TomoRead 0.3.0

中文

0.3.0 版本聚焦阅读器稳定性、跨平台兼容性和阅读体验优化。

新功能与改进

• 新增独立于应用界面的阅读主题。
• 支持白色、纸张、雾绿、护眼、深色和 AMOLED 等阅读配色。
• 支持自定义背景色、正文色和强调色三色主题。
• EPUB 阅读进度改为章节进度显示，显示当前章节及本章阅读比例。
• 改进 EPUB 分页、定位和进度保存逻辑。
• 优化 Android EPUB 文本选择，保留选择手柄并支持阅读器内操作菜单。
• 改进 Windows EPUB WebView2 启动失败提示和兼容性处理。
• EPUB、PDF、TXT 和 Markdown 阅读器统一应用阅读主题。
• 补充中英文项目说明和发布文档。

修复

• 修复 Windows 端 WebView 插件实现冲突。
• 修复 EPUB 渲染器启动时错误信息不明确的问题。
• 修复阅读主题颜色混合导致的分析错误。
• 修复部分 Android EPUB 选择和进度同步问题。

已知限制

• Android 版本仍处于实验阶段，部分 EPUB 的 WebView 渲染兼容性可能存在差异。
• Windows 端需要系统安装 WebView2 Runtime。

English

Version 0.3.0 focuses on reader stability, cross-platform compatibility, and reading experience improvements.

New Features and Improvements

• Added reader-specific themes independent from the application theme.
• Added white, paper, mist, eye-care, dark, and AMOLED reading palettes.
• Added custom three-color themes for background, text, and accent colors.
• EPUB progress now displays the current chapter and chapter-level progress.
• Improved EPUB pagination, location tracking, and progress persistence.
• Improved Android EPUB text selection with preserved selection handles and in-reader actions.
• Improved Windows EPUB WebView2 startup diagnostics and compatibility handling.
• Applied reader themes consistently to EPUB, PDF, TXT, and Markdown readers.
• Added bilingual project documentation and release guidance.

Fixes

• Fixed conflicts between Windows WebView plugin implementations.
• Improved error reporting when the EPUB renderer fails to start.
• Fixed theme color blending that caused static analysis failures.
• Fixed several Android EPUB selection and progress synchronization issues.

Known Limitations

• Android remains experimental; rendering compatibility may vary for some EPUB files.
• WebView2 Runtime is required on Windows.

Full Changelog: v0.2.0...v0.3.0

TomoRead 0.2.0

TomoRead v0.2.0

TomoRead 的第二个版本，重点完善阅读体验、AI 能力与数据安全。
The second release of TomoRead, focusing on a richer reading experience, AI capabilities, and data safety.

TomoRead 是一款面向本地书库的跨平台 AI 阅读器：导入 EPUB/PDF/TXT/Markdown，在沉浸式阅读中记录书签、标注与笔记，并可基于原文与 AI 对话、整理知识。
TomoRead is a cross-platform AI reading app for local libraries. Import EPUB/PDF/TXT/Markdown books, read immersively, capture annotations and notes, and discuss or organize knowledge with AI based on the source text.

本次包含 / Highlights

阅读与书库 / Reader & Library

• 新增 TXT 与 Markdown 导入与阅读，支持章节解析、滚动阅读和进度保存
  Import and read TXT and Markdown files with chapter parsing, scrolling, and persistent progress.
• EPUB 阅读定位改进：跨格式定位契约、逻辑位置追踪，重启或改布局后更可靠地回到原文
  Improved EPUB location tracking with cross-format locator contracts, so reopening or relayout returns to the same passage more reliably.
• 统一桌面与移动端阅读界面，稳定移动端阅读与目录操作
  Unified reader chrome across desktop and mobile with stabilized mobile reading and table of contents.
• 新增自动滚动与可配置的桌面快捷键
  Added automatic scrolling and configurable desktop keyboard bindings.
• EPUB 脚注、图片与链接交互更安全，支持无 <head> 等异常章节
  Safer EPUB footnote, image, and link interactions, with support for spine documents without a <head>.
• 导入流程升级：可取消的扫描预览、桌面拖放与 Android 分享导入
  Upgraded import with a cancellable scan preview and desktop/Android file ingress.

标注与正文增强 / Annotation & Text Enhancement

• EPUB 文字前景着色（按词条规则为正文上色）
  EPUB text foreground coloring with configurable term rules.
• TXT/Markdown 显示投影与着色，安全的原文字符串映射
  Safe display projection and coloring for TXT/Markdown.
• EPUB 下划线标注，与高亮/彩色标注共存
  EPUB underline annotations alongside highlights and colored marks.
• 系统字体与导入字体（本地字体文件）
  System and imported fonts, including local font files.

语音与专注 / TTS & Focus

• 结构化 TTS 播放队列与阅读器内控制条，支持逐句朗读与句子强调
  Structured TTS playback queue with in-reader controls, sentence emphasis, and wake locks.
• 持久化的番茄专注会话与阅读统计
  Persisted Pomodoro focus sessions and reading statistics.

AI 与语义检索 / AI & Semantic Search

• Provider 预设与配置管理，API Key 仍保存在系统安全存储
  Provider presets and profile management; API keys stay in system secure storage.
• 可信内容索引与上下文组装，词云与 AI 思维导图
  Trusted content indexing with context assembly, word clouds, and AI mind maps.
• 独立的向量化数据层、增量索引与关键词/向量混合检索，始终保留无模型降级路径
  Independent embedding data foundation, incremental indexing, and hybrid keyword/vector retrieval with a model-free fallback.

数据安全 / Data Safety

• 校验的本地备份与恢复，存储诊断
  Validated local backup/restore and storage diagnostics.
• 同步数据模型基础：实体版本、删除墓碑与冲突合并，为后续同步铺路
  Sync data model foundation: revisions, tombstones, and merge semantics for future sync.
• PDF 文本选区校验与可回跳的标注引用
  Verified PDF text selection locators with annotation references that link back to the source.

支持平台 / Supported Platforms

• Windows x64
• Linux x64
• Android（实验性支持 / experimental）

已知限制 / Known Limitations

• Android 的 WebView 渲染与低端设备性能仍在持续优化。
  Android WebView rendering and low-end-device performance are still being improved.
• 复杂 EPUB 的分页、定位和样式兼容性仍可能存在问题。
  Complex EPUB files may still have pagination, location, or styling compatibility issues.
• WebDAV 手动同步尚未交付；备份/恢复与同步数据契约已就绪。
  WebDAV manual sync is not yet available; backup/restore and the sync data contract are ready.
• 暂未提供云同步、自动更新及 macOS/iOS 支持。
  Cloud sync, auto-update, and macOS/iOS support are not available yet.

下载与使用 / Download & Run

• Windows：下载 ZIP，解压后运行 tomoread.exe
  Windows: Download the ZIP, extract it, then run tomoread.exe.
• Linux：下载并解压 tar.gz，运行 bundle 中的 TomoRead
  Linux: Download and extract the tar.gz, then run TomoRead from the bundle.
• Android：根据设备架构下载对应 APK（armeabi-v7a / arm64-v8a），或使用 AAB 提交商店
  Android: Download the APK matching your device architecture (armeabi-v7a / arm64-v8a), or use the AAB for store submission.

TomoRead 仍处于积极开发阶段。升级前建议导出重要笔记，保留 Markdown 或 JSON 备份文件。
TomoRead is under active development. Before upgrading, consider exporting important notes as Markdown or JSON backups.

欢迎提交 Issue 和建议，帮助 TomoRead 变得更好。
Issues and feedback are welcome—thank you for helping make TomoRead better.

Full Changelog: v0.1.0...v0.2.0

TomoRead 0.1.0

TomoRead v0.1.0

TomoRead 的首个公开预览版本。
The first public preview release of TomoRead.

TomoRead 是一款面向本地书库的跨平台 AI 阅读器：导入 EPUB/PDF，在沉浸式阅读中记录书签、标注与笔记，并可基于原文与 AI 对话、整理知识。
TomoRead is a cross-platform AI reading app for local libraries. Import EPUB/PDF books, read immersively, capture annotations and notes, and discuss or organize knowledge with AI based on the source text.

本次包含 / Highlights

阅读与书库 / Reader & Library

• 导入本地 EPUB、PDF，自动去重并托管保存
  Import local EPUB and PDF files with deduplication and managed storage.
• EPUB 目录、封面、章节解析与阅读进度保存
  EPUB table of contents, cover art, chapter parsing, and persistent reading progress.
• EPUB 分页/滚动阅读，支持单栏、双栏、滚轮与点击翻页
  EPUB paginated and scrolling modes, with single/double-column layouts, wheel navigation, and tap-to-turn.
• PDF 渲染、目录导航与阅读位置保存
  PDF rendering, table-of-contents navigation, and persistent reading positions.
• 字体、字号、行距、边距、配色、阅读方向和翻页方式设置
  Configurable fonts, font size, line height, margins, colors, reading direction, and page transitions.
• 书库搜索、筛选、分类、标签、收藏和批量管理
  Library search, filtering, categories, tags, favorites, and batch management.

笔记与阅读记录 / Notes & Reading History

• 书签、高亮、彩色标注与笔记
  Bookmarks, highlights, colored annotations, and notes.
• 全局笔记搜索、筛选、Markdown 编辑/预览与自动保存
  Global note search and filtering, Markdown editing/preview, and autosave.
• 笔记导出为 Markdown 或 JSON，并可跳回原文位置
  Export notes to Markdown or JSON and jump back to the original text.
• 阅读时长、活跃天数、连续阅读和书籍排行等统计
  Reading time, active days, streaks, and book rankings.

AI 阅读助手 / AI Reading Assistant

• 配置 OpenAI 兼容接口及模型
  Configure OpenAI-compatible endpoints and models.
• API Key 使用系统安全存储，不写入本地 SQLite 数据库
  API keys are kept in system secure storage, never in the local SQLite database.
• 通用对话与按书籍保存的对话
  General conversations and book-specific persistent chats.
• 流式回复、停止生成、Markdown 展示和失败恢复
  Streaming responses, stop generation, Markdown rendering, and error recovery.
• 针对选中文本提问、解释或总结，并保留可回跳原文的引用
  Ask about, explain, or summarize selected text with references that link back to the source.
• 支持结构化 Agent 对话与 Skills
  Structured agent conversations and Skills support.

支持平台 / Supported Platforms

• Windows x64
• Linux x64
• Android（实验性支持 / experimental）

已知限制 / Known Limitations

• Android 的构建、WebView 渲染和低端设备性能仍在持续优化。
  Android builds, WebView rendering, and low-end-device performance are still being improved.
• 复杂 EPUB 的分页、定位和样式兼容性仍可能存在问题。
  Complex EPUB files may still have pagination, location, or styling compatibility issues.
• PDF 的标注、文本选择和阅读控制能力尚在完善。
  PDF annotation, text selection, and reading controls are still under development.
• 暂未提供云同步、备份恢复及 macOS/iOS 支持。
  Cloud sync, backup/restore, and macOS/iOS support are not available yet.

下载与使用 / Download & Run

• Windows：下载 ZIP，解压后运行 tomoread.exe
  Windows: Download the ZIP, extract it, then run tomoread.exe.
• Linux：下载并解压 tar.gz，运行 bundle 中的 TomoRead
  Linux: Download and extract the tar.gz, then run TomoRead from the bundle.
• Android：根据设备架构下载对应 APK
  Android: Download the APK matching your device architecture.

TomoRead 仍处于积极开发阶段。升级前建议导出重要笔记，保留 Markdown 或 JSON 备份文件。
TomoRead is under active development. Before upgrading, consider exporting important notes as Markdown or JSON backups.

欢迎提交 Issue 和建议，帮助 TomoRead 变得更好。
Issues and feedback are welcome—thank you for helping make TomoRead better.

Full Changelog: https://github.com/bbdd2729/TomoRead/commits/v0.1.0