read-aware

ahpxexAGPL-3.0活跃维护

带自进化智能体的电子书阅读器,能跨书记住你的阅读进度和笔记,还支持插件同时扩展阅读器与智能体能力。

An ebook reader with a self-evolving agent: it remembers your reading across books, and plugins extend the reader and the agent alike.

v0.6.9发布于 2026-10-28 16:07 UTC500star +5 / 7 天46fork同步于 2026-11-10 06:02 UTC

怎么上手

由 README 提炼,执行前请确认
从 https://github.com/ahpxex/read-aware/releases/latest 下载对应平台安装包;命令行版可运行 cargo run -p read-aware-cli -- --help
硬件要求按 README 说明

README 未说明硬件要求;支持 macOS、Windows、Linux、Android,iOS 仅通过 TestFlight 公测,未提及显存或 GPU 型号

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

带自进化 Agent 的离线电子书阅读器,跨书记住你的阅读轨迹,插件同时扩展阅读器和 Agent

带自进化智能体的电子书阅读器,能跨书记住你的阅读进度和笔记,还支持插件同时扩展阅读器与智能体能力。

核心能力

  • 逐句阅读模式,保持页面专注、适合 ADHD 读者
  • 在书页内直接向 AI 提问、追问思路或查词
  • 沙箱化插件市场,可装语音、主题、词典、RSS 和 Agent 新工具
  • 用 SQLite FTS 加范围、时效、重要性信号做检索,无需向量库
  • 端到端加密同步书籍、进度、批注、对话和记忆,支持自建 WebDAV

容易踩的坑

AI 推理需自行选择模型提供方,阅读上下文会发送给该提供方;同步加密口令忘记后无法恢复,且需在所有设备保持一致;iOS 目前只有 TestFlight 测试版,未上架 App Store

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.6.9
  1. v0.6.9v0.6.9 「Cambria」最新正式版2026-10-28 · 2026-10-28 16:07 UTC

    New

    • Reader header and footer. Show the chapter, book title, reading progress, page numbers, time and battery level in thin strips above and below the page. Arrange them in Settings → Customize: drag each item to the left, center or right of the header or footer, reorder items that share a spot, or hide them. On Android and iOS, where the reader hides the system status bar, they are on by default so you can still see the time and battery; on desktop they are off until you turn them on.
    • Advanced typography. A new "Advanced typography" switch lets you set exact values for font size, line height, paragraph spacing, margins and weight instead of preset steps. First-line indent can now follow the book, be turned off, or be set yourself.
    • Searchable font picker. Curated, plugin, imported and installed fonts now share one list with section headings, and you can search it by name.
    • Xiaomi MiMo read-aloud voices. Xiaomi MiMo is now available as a text-to-speech provider for reading aloud.

    Improved

    • More text per page on phones. The safe area around the notch and home indicator now counts toward the page margins in paginated mode, so iPhones no longer lose about three lines of text per page.
    • Calmer appearance controls. Typography choices come first and sliders after, and the page color picker is a dropdown once plugin themes make the list long.
    • No font flash between chapters. A new chapter appears only after its font has loaded, instead of briefly showing a fallback font.

    Fixed

    • Exports on iOS. Exporting files on iPhone and iPad no longer produces empty files or fails.
    • iOS 16.0–16.3 and older Safari. The app and EPUB loading now work on these versions. The minimum supported iOS version is now 16.0.
    • Inline glyph images in CJK books. Small images used as substitute characters stay on their line of text instead of breaking the sentence apart.
    • Menus stay on screen. Popovers such as the selection menu no longer run past the bottom of the screen, for example in landscape.
    • Desktop startup. The app no longer fails to start when file-association registration fails, or when opening a book whose file name is not valid Unicode.
    • Reader appearance popover layout. Option groups no longer grow extra space after relayout in the desktop app.
    • Mobile settings. The "launch at startup" setting no longer appears on Android and iOS, where it is not supported.

    Full Changelog: https://github.com/ahpxex/read-aware/compare/v0.6.8...v0.6.9

  2. v0.6.8v0.6.8 「Cambria」2026-10-21 · 2026-10-21 15:45 UTC
    查看更新说明

    New

    • Image backgrounds for reading. The built-in Image Background plugin turns any local PNG, JPEG or WebP into a reading theme. Pick an image, see a preview, then choose a base theme for colors and typography and set the image's opacity and dimming. You can keep up to twelve named themes, and the plugin page has its own Page color picker, so you can switch between image themes and regular page colors without leaving it.
    • Tap zones and volume keys turn pages. Settings → Reading → Page Turning adds tapping the sides of the page (or a one-handed forward zone) in three widths, and on Android the volume keys, with a choice of which key reads on. Both are off by default, and the Agent can change them for you.
    • Import a whole folder. Add every book in a folder at once on desktop, Android and iOS from the shelf menu, the command palette or the empty shelf. On desktop you can also drop a folder onto the window. Each book remembers which folder it came from, so you can ask the Agent to group your shelf by folder.
    • Your own fonts on every platform. Import TTF, OTF, WOFF, WOFF2 or TTC font files from the reading font menu on desktop, Android and iOS. Imported fonts sync to your other devices, and removing one sends affected settings back to their defaults.

    Improved

    • One dropdown for reading fonts. Importing and removing fonts now happens inside the font dropdown, instead of in a separate list below it.
    • Plugin toolbars hide less. A plugin's "More" menu no longer appears with just one item; that action is shown as a button instead.

    Fixed

    • Sentence mode picks up where you left off on another device. After a sync, sentence and paragraph mode resume at the position you reached on the other device, instead of jumping back to an old chapter.
    • Swipe back in iOS Settings. The edge-swipe gesture now goes back a level in Settings on iPhone and iPad.
    • Agent menu entries respond across the whole row. Items in the Agent's overflow menu can be tapped anywhere on the row, not just on the label.

    Full Changelog: https://github.com/ahpxex/read-aware/compare/v0.6.7...v0.6.8

  3. v0.6.7v0.6.7 「Cambria」2026-10-13 · 2026-10-13 01:33 UTC
    查看更新说明

    Fixed

    • Short swipes turn the page. In page-turn mode on phones and tablets, a quick flick now turns the page even when your finger slows down before lifting, and a slower drag turns it once it covers a quarter of the page. Before, a page turned only after dragging past half the screen, and a hard flick could skip a page; now a swipe moves exactly one page.
    • The app no longer zooms like a web page. A two-finger pinch or a double tap no longer magnifies the whole app on Android and iOS. PDFs and comics still zoom with a pinch, and text size stays in the reader's font settings.
    • The model list stays open on Android. In Settings → AI, the model picker no longer closes the moment you open it when the on-screen keyboard appears; the field moves above the keyboard so you can search and pick.

    Full Changelog: https://github.com/ahpxex/read-aware/compare/v0.6.6...v0.6.7

  4. v0.6.6v0.6.6 「Cambria」2026-10-11 · 2026-10-11 20:37 UTC
    查看更新说明

    New

    • Plugins update themselves. Plugins you install or update from the marketplace now keep themselves current — checked once a day, and right away after ReadAware itself updates. An update keeps the plugin's book access and whether it is turned on, and a plugin you turned off is updated without running. Updates that ask for new permissions, settings access or network sites wait for your approval in Settings → Plugins, and plugins you installed from a folder or zip are never replaced by a marketplace listing. Plugins installed before 0.6.6 announce their next update once; update them in Settings → Plugins → Marketplace and they update automatically from then on.

    Improved

    • A plugin that can't run tells you why. Instead of "Activation failed. Details are in the app log", the plugin's row explains whether the plugin was built for an older ReadAware or needs a newer one — with an Update to vX button when the marketplace has a compatible release, or a shortcut to check for app updates.
    • Plugin number settings stay in range. A value outside the range a plugin declares is refused on its settings page with a clear message, the same rule the assistant already followed.
    • Sync waits as long as the server asks. When the sync server is busy, the next attempt is scheduled at the time it requests instead of a ten-minute backoff.
    • Plugin developer docs and kit. The plugin repository's template, typings and validator now match this release, it has a single-file guide for coding agents (AGENTS.md), and the website's API reference lists every capability and method with its signature, documentation and released version.

    Fixed

    • Footnote citations in AI replies now jump to their note within the reply and back, instead of opening an external-link prompt.
    • Links in Chinese and Japanese replies no longer swallow the punctuation and text after a bare URL, such as a closing full-width parenthesis.

    Full Changelog: https://github.com/ahpxex/read-aware/compare/v0.6.5...v0.6.6

  5. v0.6.5v0.6.5 「Cambria」2026-09-29 · 2026-09-29 19:20 UTC
    查看更新说明

    New

    • Zoom for PDFs and comics. Pinch on the trackpad or touch screen, hold the zoom chord on the mouse wheel, or press ⌘= / ⌘− / ⌘0 (Ctrl elsewhere; rebindable in Settings → Shortcuts). The point under your fingers or cursor stays put, and pages zoomed past the window scroll in every direction. Reading appearance lets you choose what 100% means — the page's width or the whole page.
    • The percentage shows as you zoom, and while the reader controls are up a zoomed page keeps it on screen with a one-click way back to the fit.
    • Each book remembers its zoom and your place on the page on this device, so a zoomed page reopens on the passage you were reading instead of its corner.
    • Lock a zoomed view for page turns. In single- and two-page modes, lock the view from the zoom pill or with ⌘L: the wheel, arrow keys and swipes turn pages again, and every page opens on the same part — handy for reading one column of a paper page after page.
    • Tables of contents rebuilt for books that barely have one. Sets whose contents list only their volumes, and PDFs without an outline, get a nested contents list recovered from their headings, remembered for the next open. Very long contents lists stay fast.

    Improved

    • Zoomed pages stay sharp: past the render budget, the visible part of a PDF page is drawn again at full resolution.
    • In a paged layout, a zoomed page pans before it turns — the wheel, arrow keys and swipes first move across the page, and a new gesture at its edge turns it.
    • Chapters are worked out once for both the reader and the assistant, so chapter summaries of book sets and multi-part books follow the real chapters.
    • Large and slightly damaged Kindle (KF8/AZW3) books open reliably, and jumps inside a big bundle take milliseconds instead of seconds.
    • Covers, code, wide tables and positioned blocks from the publisher stay inside the text column instead of rendering blank or spilling onto the next page.
    • On a cold start the first page appears in your reading font, without flashing the publisher's styles first.
    • Backups use the complete encrypted archive only. An old v1 .json backup is recognized and explained instead of being reported as a wrong password.

    Fixed

    • EPUB covers named by file path (for example Refactoring) now appear on the shelf.
    • A book whose cover never reached this device — with sync off, or after a restore — gets it back from the book file here.
    • Jumping with the progress bar while a chapter change was still animating no longer gets lost.
    • A sync upload over your storage quota no longer removes the copy already stored.
    • Local storage recovers by itself after an internal error instead of failing until restart, and a chat's messages are saved in one step.
    • Exports on mobile are written only to the location you chose in the save dialog.

    Full Changelog: https://github.com/ahpxex/read-aware/compare/v0.6.4...v0.6.5

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    ReadAware is free and built in the open. If it makes your reading better, give it a star — stars are how new readers find the project.

    One reader. One agent. Open-ended plugins.

    ReadAware is a free and open-source reader for macOS, Windows, Linux, Android, and iOS. At its center is a single agent that can use tools, answer questions in context, and build an evolving memory from the books, passages, notes, and conversations that matter to you. Around it is a sandboxed plugin system that extends the reader — and the agent — from the inside.

    • Stay with the sentence. Sentence-by-sentence reading keeps the page calm, focused, and ADHD-friendly.
    • Mark things your way. Underline, highlight, and write notes without breaking your reading flow.
    • Ask from the page. Chat with AI about an unfamiliar passage, follow an idea further, or look up a word without leaving the book.
    • Extend it from the inside. Install sandboxed plugins from the built-in marketplace: read-aloud voices, reading themes, dictionaries, feeds that read like books, new commands — and new tools the agent picks up and uses.
    • Keep words for later. Annotate vocabulary as you read so it can become useful review material instead of a one-off lookup.
    • Make the page yours. Switch languages, color themes, fonts, type sizes, spacing, and other reading settings.
    • See the habit forming. Reading-time statistics make progress visible across books and sessions.
    • Pick up on another device. Sync books, reading progress, annotations, conversations, and memory with end-to-end encryption, through the ReadAware relay or your own WebDAV server.
    • Bring almost any book. EPUB, MOBI, AZW3, FB2, PDF, TXT, HTML, CBZ, and CBR share one reading, selection, annotation, and progress model, with no format conversion.

    Why it feels different

    Most apps bolt AI onto a sidebar. ReadAware is built the other way around: one agent orchestrates retrieval, context assembly, tool use, and memory, and the interface is a surface it can act on. Plugins extend the same seams from the outside — sandboxed and permission-gated, they add voices, themes, dictionaries, feeds, commands, and tools the agent immediately knows how to use.

    That combination is the long game: an agent that operates the app through the same contracts plugins are written against can, eventually, extend the app for you. The reader is designed to evolve itself.

    The craft underneath is the floor, not the pitch. The interface stays quiet, coherent, and tuned to the pixel — typography first, controls only when they are useful, no AI slop — and the agent stays beside the reading experience rather than taking it over, because a reader earns attention with the page, not the chrome.

    Platforms

    PlatformStatus
    macOSAvailable
    AndroidAvailable
    WindowsAvailable; broader real-world testing is welcome
    LinuxAvailable; broader real-world testing is welcome
    iOSSupported via the public TestFlight beta; App Store distribution is not available yet

    Cross-device sync

    Cross-device sync is available now. Books, reading progress, highlights, notes, conversations, and memory sync between your devices. Supported app, AI, and plugin preferences roam too; device-specific settings such as reading typography stay local. Choose where your encrypted data is stored:

    • ReadAware relay. Connect your ReadAware account in Settings > Data & Sync. See pricing for storage allowances and plans.
    • Your own WebDAV server. Install the WebDAV Sync plugin from the marketplace, configure its server URL, username, password (or app password), and folder, then connect WebDAV in Settings > Data & Sync. This uses your WebDAV storage instead of the ReadAware relay and does not require a ReadAware sync account.

    Both options use the same sync engine: data is encrypted on your device before upload, and the remote stores ciphertext. Use the same encryption passphrase on every device connected to the same account or WebDAV folder. Keep it safe: it cannot be recovered if forgotten. The WebDAV login password and the encryption passphrase serve different purposes.

    ReadAware remains local-first: reading and writing notes work offline, changes merge when you reconnect, and disconnecting sync keeps your local data. Optional AI inference is separate from sync encryption: relevant reading context is sent to your chosen model provider.

    Architecture

    ReadAware uses one agent to orchestrate retrieval, context assembly, tool use, and memory updates. Chat transcripts are source material rather than the memory system itself: durable context is built from the reader's ongoing trace across books.

    ReadAware app
    ├── React interface          shelf, reader, annotations, chat, settings
    ├── Local agent runtime      tools, retrieval, context, memory updates
    ├── Plugin runtime           sandboxed workers, marketplace, contribution points
    ├── SQLite                   product data, event log, FTS, projections
    └── Native filesystem        imported books and large blobs
    
    Remote services
    ├── Model provider           optional inference through the reader's account
    └── Sync storage             ReadAware relay or WebDAV; encrypted events and blobs
    

    The source of truth is local. Raw domain events form the syncable record; memory and search state are rebuildable projections. Retrieval uses SQLite FTS plus scope, recency, and importance signals rather than requiring a vector database.

    Plugins and the agent reach the product through the same domain API layer, and every read, write, and event carries its origin — the user, a plugin, or the agent. What the agent can do today, a plugin can extend tomorrow, and vice versa.

    The repository itself is a Bun workspace monorepo orchestrated by Turborepo.

    PathResponsibility
    apps/webReact 19 interface, TanStack Router, Jotai, Tailwind CSS v4
    apps/desktopTauri 2 shell: IPC commands, OS integration and full backups
    crates/storeOn-device store shared by the app and the CLI: SQLite, event log, projections, blobs, import
    apps/landingPublic website and release downloads
    apps/clira, headless ReadAware without the agent: reads and writes the desktop app's library and imports books, with or without the app running (cargo run -p read-aware-cli -- --help)
    packages/agentAgent runtime, model adapters, retrieval, and memory pipelines
    packages/coreDomain entities, events, and storage contracts
    packages/uiShared design system and co-located Storybook stories
    packages/plugin-typesThe public plugin API surface
    plugins/First-party plugins: dictionary, TTS voices, themes, RSS reader, sentence reader, WebDAV sync, jumper, annotations, reading goals

    Architecture decisions and target data contracts live in docs/architecture/agent-architecture.md and docs/architecture/data-model.md. The plugin API reference and publishing guide live at readaware.app/docs/plugins.

    Browse the documentation index for current contracts, verification and historical archives.

    Releases

    Version tags build macOS, Windows, Linux, Android, and iOS (unsigned, for sideloading) artifacts through .github/workflows/release.yml. See the latest release for current downloads and installation files.

    Sponsors

    ReadAware is free and open source. A heartfelt thank-you to the sponsors who help keep it that way:

    • ikeba Inc. — a Tokyo-based technology company building AI and medical businesses.

    Interested in sponsoring ReadAware? Say hello on the ReadAware Discord.

    Community

    Questions, ideas, bug reports, and reading stories are welcome on the ReadAware Discord.

    License

    ReadAware is free and open source under the GNU AGPL-3.0.

    The public plugin API, @read-aware/plugin-types, is MIT-licensed so third-party plugins can use any license they like.