codedogQBY/ReadAny
codedogQBY/ReadAny has 2,930 GitHub stars and 241 forks. GitHot measured +5 stars in 24 hours and +28 in 7 days. Last checked 2026-11-04 09:19 UTC. Last push 2026-11-02.
AI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.
实测星标增长
- 24小时
- +5
- 7天
- +28
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
README_CN.md
原文
ReadAny
本地优先的 AI 电子书阅读器,覆盖桌面端与移动端
"为什么读完就忘?为什么笔记零散?为什么搜索只能找关键词?"
ReadAny 帮你向书籍提问、按语义寻找观点,并用 RAG 对话、语义搜索、高亮笔记、TTS 与 WebDAV 同步构建私有阅读知识库。
🚀 v2.0 更新: 移动端应用(iOS/Android)现已上线!详见下方 移动端 章节。
AI 原生阅读工作流
- 和书库对话 - 围绕当前书籍、选中文本和阅读位置提问,答案基于你的阅读上下文生成
- 按语义找内容 - 向量检索 + BM25 混合搜索,不记得原文关键词也能找回相关概念
- 知识留在本地 - 本地 embeddings 与本地向量库,让书籍、高亮和笔记具备离线可用能力
- 接入常用模型 - 支持 OpenAI、Claude、Gemini、Ollama、DeepSeek 以及兼容接口
为什么选择 ReadAny?
| 痛点 | 传统阅读器 | ReadAny |
|---|---|---|
| 搜索内容 | 只能关键词 | 语义搜索,理解你的意图 |
| 提问书籍 | 自己翻找答案 | AI 直接回答 + 定位 |
| 做笔记 | 手动复制粘贴 | 选中即高亮,一键导出 |
| 知识管理 | 笔记散落各处 | 统一管理,多格式导出 |
| 隐私安全 | 上传云端 | 本地向量库,完全离线可用 |
与竞品对比
| 特性 | ReadAny | Calibre | KOReader | Apple Books |
|---|---|---|---|---|
| AI 对话 | ✅ | ❌ | ❌ | ❌ |
| 语义搜索 (RAG) | ✅ | ❌ | ❌ | ❌ |
| 本地向量库 | ✅ | - | - | ❌ |
| TTS 语音朗读 | ✅ | ❌ | 有限 | 有限 |
| 阅读统计 | ✅ | ❌ | ❌ | 有限 |
| WebDAV 同步 | ✅ | ❌ | ❌ | ❌ |
| 技能系统 | ✅ | ❌ | ❌ | ❌ |
| 多格式支持 | 10+ | 15+ | 10+ | 2 |
| 笔记导出 | 5 种格式 | 有限 | 有限 | 有限 |
| 开源免费 | ✅ | ✅ | ✅ | ❌ |
应用截图
主界面
AI 智能对话
笔记和高亮
TTS 语音朗读
阅读统计
跨设备同步
核心功能
🤖 AI 智能阅读
- 智能对话 - 针对书籍内容提问,AI 知道你的位置、选中文字、高亮笔记
- 语义搜索 - 超越关键词,向量检索 + BM25 混合搜索
- 即时翻译 - AI 翻译或 DeepL,支持 19 种语言
- 多模型支持 - OpenAI、Claude、Gemini、Ollama、DeepSeek
- 技能系统 - 内置技能(摘要、概念解释、角色追踪等)+ 自定义技能
📝 标注与知识管理
- 5 色高亮 - 黄/绿/蓝/粉/紫,悬停预览笔记
- Markdown 笔记 - 富文本编辑器,工具栏操作,所见即所得
- 多格式导出 - Markdown、HTML、JSON、Obsidian、Notion
🔊 语音朗读 (TTS)
- 多引擎支持 - Edge TTS、浏览器 TTS、通义千问
- 丰富音色 - 100+ 种语音,多语言支持
- 语速调节 - 可调节播放速度
- 后台播放 - 边听边做其他事情
📊 阅读统计
- 阅读热力图 - 类似 GitHub 贡献图,可视化阅读习惯
- 趋势图表 - 追踪每日/每周/每月阅读时长
- 连续天数 - 记录最长连续阅读天数
- 书籍统计 - 每本书的阅读时长、完成度
☁️ 跨设备同步
- WebDAV 支持 - 跨设备同步书库、高亮、笔记
- 自动同步 - 后台自动同步
- 冲突解决 - 智能合并并发编辑
📚 多格式支持
EPUB · PDF · MOBI · AZW · AZW3 · FB2 · FBZ · CBZ · TXT · UMD
TXT 和 UMD 会在导入时转换为 EPUB,以支持阅读、笔记、搜索与同步。
🎨 个性化体验
- 5 种字体主题(含 CJK 优化)
- 明/暗主题切换
- 分页/连续滚动
- 快捷键支持
- 中英双语界面
快速开始
下载安装
| 平台 | 下载 |
|---|---|
| macOS (Apple Silicon) | 下载 .dmg |
| macOS (Intel) | 下载 .dmg |
| Windows | 下载 .msi |
| Linux | 下载 .AppImage |
| iOS | 加入 TestFlight |
| Android | 下载 .apk |
Homebrew(macOS)
brew tap codedogQBY/readany
brew install --cask readany
3 步上手
- 导入书籍 - 拖拽文件到书库
- 开始阅读 - 双击打开,沉浸体验
- 配置 AI(可选)- 设置 → AI → 填入 API Key
移动端应用
ReadAny 现已支持移动设备!
Expo (React Native) 版本:
# 克隆并设置
git clone https://github.com/codedogQBY/ReadAny.git
cd ReadAny
pnpm install
# 安装/运行 iOS 开发构建
pnpm expo:ios
# 安装/运行 iOS 模拟器开发构建
pnpm expo:ios:simulator
# 安装/运行 Android 开发构建
# 先启动 Android 模拟器,或连接真机。
pnpm expo:android
# 为已安装的开发构建启动 Metro
pnpm expo:start
移动端开发使用带 expo-dev-client 的 Expo development build,不再使用
Expo Go。Expo Go 无法加载 ReadAny 当前依赖的原生模块和应用配置。首次调试,
或原生依赖/配置发生变化时,先运行 pnpm expo:ios、pnpm expo:ios:simulator
或 pnpm expo:android 安装开发版 App;日常 JS 调试再运行 pnpm expo:start,
用已安装的 ReadAny 开发版 App 连接 Metro。
模拟器调试时,iOS 使用 pnpm expo:ios:simulator;Android 先启动 Android
模拟器,再运行 pnpm expo:android。
移动端源码位于 packages/app-expo。
AI 配置
| Provider | 获取方式 |
|---|---|
| OpenAI | platform.openai.com |
| Anthropic Claude | console.anthropic.com |
| Google Gemini | aistudio.google.com |
| Ollama / DeepSeek | 本地或自定义端点 |
技术栈
| 层级 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 (Rust) |
| 移动端 | Expo (React Native) + Tauri Mobile |
| 前端 | React 19 + TypeScript |
| 构建 | Vite 7 |
| 样式 | Tailwind CSS 4 + Radix UI |
| 状态 | Zustand |
| 数据库 | SQLite |
| 电子书 | foliate-js |
| AI/LLM | LangChain.js + LangGraph |
| 嵌入模型 | Transformers.js |
开发
# 克隆
git clone https://github.com/codedogQBY/ReadAny.git
cd ReadAny
# 安装依赖
pnpm install
# 开发模式(桌面端)
pnpm tauri dev
# 开发模式(移动端 - Expo development build,不是 Expo Go)
# 首次先安装/运行原生开发构建:
pnpm expo:ios
pnpm expo:ios:simulator
pnpm expo:android
# 然后为已安装的开发版 App 启动 Metro:
pnpm expo:start
# 构建
pnpm tauri build
移动端使用 expo-dev-client,不支持 Expo Go。修改原生依赖、app.config.js、
权限、scheme 或 Expo plugins 后,需要重新运行 pnpm expo:ios、
pnpm expo:ios:simulator 或 pnpm expo:android 生成/安装开发构建。
环境要求: Node.js ≥18, pnpm ≥9, Rust(Tauri 需要);移动端开发还需要 iOS 的 Xcode 或 Android 的 Android Studio/SDK。
开发路线
- 移动端应用 — iOS 和 Android 版本已上线
- TTS 语音朗读 — Edge TTS,多音色
- 阅读统计 — 热力图、趋势、连续天数
- 技能系统 — 内置 + 自定义 AI 技能
- WebDAV 同步 — 跨设备同步
- 更多 AI 模型(Qwen、GLM、Llama)
- PDF 重排/重渲染
- 插件系统
- 官方云同步服务
参与贡献
欢迎贡献代码、报告 Bug、提出建议!
- Fork → 2. Branch → 3. PR
提交前请运行 pnpm lint 确保代码风格一致。
开源协议
GPL-3.0 © 2024 ReadAny Team
本项目采用 GNU General Public License v3.0 开源协议。你可以自由使用、修改和分发代码,但任何衍生作品必须以相同协议开源。
说明: 源代码完全开源免费,但官方应用商店版本可能会收取一定费用,用于支持持续开发和覆盖证书成本。你始终可以免费自行编译使用。
致谢
- foliate-js - 电子书渲染引擎
- Tauri - 跨平台桌面框架
- Expo - React Native 开发平台
- LangChain.js - AI 编排框架
- Radix UI - 无障碍 UI 组件
- Lucide - 图标库
社区
感谢 linux.do — 一个活跃的中文技术社区,在这里你可以学习 AI、开发等前沿技术。
用 ❤️ 打造 by ReadAny Team
☕ 请作者喝杯咖啡
如果你觉得 ReadAny 对你有帮助,欢迎请我喝杯咖啡,支持项目的持续开发!
Star 历史
探索相关项目
affaan-m/ECC
智能体执行与控制框架的性能优化系统。面向 Claude Code、Codex、Opencode、Cursor 等,涵盖技能、本能、记忆、安全与研究优先的开发。
297,286 星标NousResearch/hermes-agent
与你一同成长的智能体
260,579 星标multica-ai/andrej-karpathy-skills
一个用于改进 Claude Code 行为的 CLAUDE.md 文件,源自 Andrej Karpathy 对 LLM 编程陷阱的观察。
229,529 星标firecrawl/firecrawl
借助来自网络及其他来源的数据,强化你的 AI 智能体。正在构建面向超级智能的资料库。🔥
198,458 星标